常见问题

Agent Trade Kit 能做什么？

覆盖 Toobit 核心交易功能：行情查询、现货交易、USDT-M 永续合约交易、账户与资金管理。支持通过自然语言（MCP）或命令行（CLI）完成全部操作，共计 66 个工具。

支持哪些 AI 客户端？

支持所有兼容 MCP（Model Context Protocol）协议的 AI 客户端，包括 Claude Desktop、Claude Code、Cursor、VS Code（Copilot Chat）以及各类自定义 Agent 框架。

这个工具是免费的吗？

是的，完全免费。基于 MIT 协议开源，只需 Toobit 账户和 API Key 即可进行交易操作。仅查询行情数据时甚至不需要 API Key。

我的 API Key 安全吗？

程序完全在本地运行，密钥只保存在本地配置文件中（~/.toobit/config.toml），签名过程在本地完成，AI 无法获取您的凭证。除 Toobit 官方服务器外，不会向任何第三方发送数据。代码完全开源可审计。

更换 API Key 后需要重启 MCP 服务器吗？

不需要。MCP 服务器在每次请求时自动检测 ~/.toobit/config.toml 的变更。当您修改配置文件中的 API Key 后，新凭证会立即生效，无需重启。如果更新后的配置无效（如只填了 API Key 未填 Secret Key），服务器会继续使用上一个有效配置，并输出警告日志。

如果 AI 犯错，我会损失资金吗？

我们提供多层安全机制：

• 可使用 --read-only 模式限制 AI 仅查询
• 可通过 --modules 指定允许的模块
• 系统会根据 API Key 权限自动过滤工具

但 AI 可能出错，执行交易前请自行核对订单信息。用户需自行承担交易风险。

现货和合约的 symbol 格式是什么？

• 现货 接口（行情、深度、K 线、订单等）使用格式 BTCUSDT、ETHUSDT，无分隔符、大写。
• 合约 接口（资金费率、标记价格、持仓量、多空比、合约行情、保险基金、风险限额、下单、持仓、杠杆等）需使用合约格式 BTC-SWAP-USDT、ETH-SWAP-USDT，带连字符。

最小下单金额是多少？

取决于具体交易对。可通过 market_get_exchange_info 工具查询每个交易对的 MIN_NOTIONAL 和 LOT_SIZE 限制。多数交易对的最小下单金额为 5 USDT。

什么是 Agent Skills？

Agent Skills 是一组独立的 Markdown 指令文件，每个 Skill 教会 AI Agent 如何使用 CLI 完成特定类别的任务。AI 读取 Skill 文档后，会按照其中的命令示例和操作流程来执行任务，无需额外编程。

安装 Skills

npx skills add toobit-docs/agent-skills