用途:通过币安已鉴权的 API 接口发起和查询算法交易请求,返回 JSON 结果。需要 API key 与 secret key 进行鉴权。
主要能力(现货与合约各一组): 新建 TWAP 订单(POST,必填 symbol、side、quantity、duration);新建 VP 订单(仅合约,POST,必填 symbol、side、quantity、urgency);取消算法订单(DELETE,必填 algoId);查询当前算法挂单(GET);查询历史算法订单(GET,可选 symbol、side、startTime、endTime、page、pageSize);查询子订单(GET,必填 algoId,可选 page、pageSize)。
参数要点:duration 单位为秒,区间 [300, 86400];quantity 为标的资产数量,存在单笔名义价值上限;positionSide 单向模式默认 BOTH,对冲模式须传 LONG 或 SHORT;clientAlgoId 长度 32 字符;reduceOnly 在对冲模式或开仓时不可用;page 默认 1,pageSize 最小 1、最大 100、默认 100。
鉴权与用法:需提供 apiKey(请求头)与 secretKey(签名)。主网基础地址 https://api.binance.com。凭证可置于环境变量 BINANCE_API_KEY、BINANCE_SECRET_KEY,或存放于 ~/.openclaw/secrets.env、~/.env 或工作区 .env 文件。签名流程:检测密钥类型,构造含时间戳的查询串,按 RFC 3986 做 UTF-8 百分号编码,用 HMAC SHA256、RSA 或 Ed25519 签名,追加 signature,并在请求头携带 X-MBX-APIKEY。User-Agent 建议使用 binance-algo/1.1.0 (Skill)。
限制:主网交易须经用户输入 CONFIRM 确认;不得泄露、回显或记录原始凭证,仅可展示掩码;除主网与测试网外不得将密钥发送至其他站点;环境变量须在进程启动前设置,运行中更新需改用密钥文件。具体参数范围、错误码与实现细节请参考 authentication 文档。