智能体密钥与权限
AI 智能体永远不需要你钱包的私钥。在 App 内，智能体通过你已连接的钱包会话行动，并且只在你确认后执行；对于外部智能体或机器人，请创建只包含必要权限的 Bitnxs API Key。Bitnxs API Key 根本没有提现权限。
App 内智能体使用哪些凭证？
Section titled “App 内智能体使用哪些凭证？”| 凭证 | 存放位置 | 能做什么 |
|---|---|---|
| 你的大模型 API Key（如 OpenAI） | 仅保存在你的浏览器（localStorage） | 让页面调用你的大模型。Bitnxs 不需要它。 |
| 你的钱包会话 | 连接钱包时创建 | 下你在智能体面板中确认的限价单。 |
App 内智能体不使用单独的”智能体密钥”。
如何为外部智能体创建仅交易的 API Key？
Section titled “如何为外部智能体创建仅交易的 API Key？”- 在 App 中打开 More → API Keys，为密钥命名（如
claude-agent-1；字母、数字、_和-，最多 32 个字符）。 - 只勾选智能体需要的权限（见下表）。
- 在钱包中签名一次派生消息。密钥在浏览器中派生且只显示一次，请复制到智能体的密钥存储中。
- 智能体用该密钥签名会话，并把你的主钱包地址作为 user 传入。见身份认证。
- 可随时在 More → API Keys 撤销；撤销后该密钥的会话全部失效。
四个权限位分别允许什么？
Section titled “四个权限位分别允许什么？”| 权限位 | 允许 | 适合给… |
|---|---|---|
place_orders | POST /session/order、/session/batchOrder | 负责开仓下单的智能体 |
cancel_orders | POST /session/cancel、/session/modify | 负责管理或改价挂单的智能体 |
change_leverage | POST /session/leverage | 通常不要开，杠杆自己设置 |
set_triggers | POST /session/trigger、/session/cancel_trigger | 负责管理止盈止损的智能体 |
没有提现、转账或密钥管理权限位。API Key 不能提取资金，也不能创建其他密钥。未授权的操作会返回 api-key-permission-denied。
安全最佳实践
Section titled “安全最佳实践”- 每个智能体一个密钥，并清楚命名，便于单独撤销。
- 最小权限：先只给
place_orders（需要管理止盈止损时再加set_triggers）。不要开change_leverage；App 内智能体本身也被设计为从不修改杠杆。 - 不要把密钥放进提示词。 绝不要把 API Key 或助记词粘贴到和大模型的对话中，请从环境变量或密钥管理器读取。
- 用单独的钱包，只放你愿意交给智能体交易的资金。
- 先自己把杠杆调低；智能体通过仓位大小而非杠杆来控制风险敞口。
- 遵守频率限制：每个签名地址约 20 次写请求/秒（突发 50）；
/info和/ws不限速。 - 持续监控：通过 WebSocket 订阅
executionReports，发现异常立即撤销密钥。 - App 把你的大模型 API Key 存在浏览器中；请使用设置了消费上限的密钥，不要在公共电脑上使用智能体。