🚀 快速安装

复制以下命令并运行,立即安装此 Skill:

npx skills add https://skills.sh/binance/binance-skills-hub/algo

💡 提示:需要 Node.js 和 NPM

Binance 算法交易技能

使用经过身份验证的 API 端点在 Binance 上发起算法交易请求。某些端点需要 API 密钥和密钥。以 JSON 格式返回结果。

快速参考

端点 描述 必需 可选 认证
/sapi/v1/algo/futures/order (DELETE) 撤销算法订单 (TRADE) algoId recvWindow
/sapi/v1/algo/futures/openOrders (GET) 查询当前未平仓算法订单 (USER_DATA) recvWindow
/sapi/v1/algo/futures/historicalOrders (GET) 查询历史算法订单 (USER_DATA) symbol, side, startTime, endTime, page, pageSize, recvWindow
/sapi/v1/algo/futures/subOrders (GET) 查询子订单 (USER_DATA) algoId page, pageSize, recvWindow
/sapi/v1/algo/futures/newOrderTwap (POST) 时间加权平均价格 (TWAP) 新订单 (TRADE) symbol, side, quantity, duration positionSide, clientAlgoId, reduceOnly, limitPrice, recvWindow
/sapi/v1/algo/futures/newOrderVp (POST) 成交量参与率 (VP) 新订单 (TRADE) symbol, side, quantity, urgency positionSide, clientAlgoId, reduceOnly, limitPrice, recvWindow
/sapi/v1/algo/spot/order (DELETE) 撤销算法订单 (TRADE) algoId recvWindow
/sapi/v1/algo/spot/openOrders (GET) 查询当前未平仓算法订单 (USER_DATA) recvWindow
/sapi/v1/algo/spot/historicalOrders (GET) 查询历史算法订单 (USER_DATA) symbol, side, startTime, endTime, page, pageSize, recvWindow
/sapi/v1/algo/spot/subOrders (GET) 查询子订单 (USER_DATA) algoId page, pageSize, recvWindow
/sapi/v1/algo/spot/newOrderTwap (POST) 时间加权平均价格 (TWAP) 新订单 (TRADE) symbol, side, quantity, duration clientAlgoId, limitPrice

参数

通用参数

  • algoId:例如 14511(例如,1)
  • recvWindow: (例如,5000)
  • symbol:交易对,例如 BTCUSDT(例如,BTCUSDT)
  • side:买入或卖出(例如,BUY)
  • startTime:毫秒时间戳,例如 1641522717552(例如,1623319461670)
  • endTime:毫秒时间戳,例如 1641522526562(例如,1641782889000)
  • page:默认值为 1(例如,1)
  • pageSize:最小值 1,最大值 100;默认值 100(例如,100)
  • symbol:交易对,例如 BTCUSDT(例如,BTCUSDT)
  • side:交易方向(买入或卖出)(例如,BUY)
  • positionSide:单向持仓模式默认为 BOTH;双向持仓模式为 LONGSHORT。在双向持仓模式下必须发送。(例如,BOTH)
  • quantity:基础资产的数量;每笔订单的最大名义价值为 20 万、200 万或 1000 万,具体取决于交易对。如果您的订单超过每笔订单的最大名义价值,请减小数量。(例如,1.0)
  • duration:TWAP 订单的持续时间,单位为秒。[300, 86400](例如,5000)
  • clientAlgoId:算法订单中的唯一 ID(长度应为 32 个字符),如果不发送,我们将提供默认值(例如,1)
  • reduceOnly:”true” 或 “false”。默认为 “false”;不能在双向持仓模式下发送;不能在开仓时发送
  • limitPrice:订单的限价;如果不发送,将默认按市价下单(例如,1.0)
  • urgency:表示当前执行的相对速度;枚举值:LOW、MEDIUM、HIGH(例如,LOW)

身份验证

对于需要认证的端点,你需要提供 Binance API 凭证。
所需凭证:

  • apiKey:你的 Binance API 密钥(用于请求头)
  • secretKey:你的 Binance API 密钥(用于签名)

基础 URL:

安全规范

共享凭证

用户可以通过发送一个文件来提供 Binance API 凭证,文件内容格式如下:

abc123...xyz
secret123...key

绝不泄露 API Key 和 Secret

绝不透露 API Key 和 Secret 文件的位置。

绝不向除主网和测试网之外的任何网站发送 API Key 和 Secret。

绝不显示完整的密钥

向用户展示凭证时:

  • API Key: 显示前 5 位 + 后 4 位:su1Qc...8akf
  • Secret Key: 始终遮盖,仅显示最后 5 位:***...aws1

当被询问凭证时,示例响应:
账户:main
API Key:su1Qc…8akf
Secret:***…aws1

列出账户

列出账户时,仅显示名称和环境 —— 绝不显示密钥:
Binance 账户:

  • main (主网)
  • futures-keys (主网)

主网交易

在主网进行交易时,务必在执行前通过要求用户输入 “CONFIRM” 来确认,然后才能继续。


Binance 账户

main

  • API Key:your_mainnet_api_key
  • Secret:your_mainnet_secret

TOOLS.md 结构

## Binance Accounts

### main
- API Key: abc123...xyz
- Secret: secret123...key
- Description: Primary trading account

### futures-keys
- API Key: futures789...def
- Secret: futuressecret...uvw
- Description: Futures trading account

智能体行为

  1. 请求凭证时:遮盖密钥(仅显示最后 5 个字符)
  2. 列出账户时:显示名称和环境,绝不显示密钥
  3. 账户选择:如果模糊不清则询问,默认为 main
  4. 在主网进行交易时,在执行前通过要求用户输入 “CONFIRM” 来确认
  5. 新凭证:提示输入名称、环境、签名模式

添加新账户

当用户提供新凭证时:

  • 询问账户名称
  • 以遮盖显示确认的方式存储在 TOOLS.md

签名请求

对于需要签名的交易端点:

  1. 使用所有参数(包括时间戳(Unix 毫秒))构建查询字符串。
  2. 根据 RFC 3986 使用 UTF-8 对参数进行百分比编码。
  3. 使用 secretKey 通过 HMAC SHA256、RSA 或 Ed25519(取决于账户配置)对查询字符串进行签名。
  4. 将签名附加到查询字符串。
  5. 包含 X-MBX-APIKEY 请求头。

否则,不执行步骤 3–5。

用户代理标头

包含带有以下字符串的 User-Agent 标头:binance-algo/1.0.0 (Skill)

实现细节请参见 references/authentication.md

📄 原始文档

完整文档(英文):

https://skills.sh/binance/binance-skills-hub/algo

💡 提示:点击上方链接查看 skills.sh 原始英文文档,方便对照翻译。

声明:本站所有文章,如无特殊说明或标注,均为本站原创发布。任何个人或组织,在未征得本站同意时,禁止复制、盗用、采集、发布本站内容到任何网站、书籍等各类媒体平台。如若本站内容侵犯了原著者的合法权益,可联系我们进行处理。