🚀 快速安装

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

npx skills add https://skills.sh/binance/binance-skills-hub/derivatives-trading-coin-futures

💡 提示:需要 Node.js 和 NPM

Binance 衍生品交易-币本位合约技能

使用经过身份验证的 API 端点在 Binance 上发起衍生品交易-币本位合约请求。某些端点需要 API 密钥和密钥。以 JSON 格式返回结果。

快速参考

端点 描述 必需 可选 认证
/dapi/v1/account (GET) 账户信息 (USER_DATA) recvWindow
/dapi/v1/balance (GET) 合约账户余额 (USER_DATA) recvWindow
/dapi/v1/positionSide/dual (GET) 获取当前持仓模式 (USER_DATA) recvWindow
/dapi/v1/positionSide/dual (POST) 更改持仓模式 (TRADE) dualSidePosition recvWindow
/dapi/v1/order/asyn (GET) 获取合约历史订单下载 ID (USER_DATA) startTime, endTime recvWindow
/dapi/v1/trade/asyn (GET) 获取合约成交历史下载 ID (USER_DATA) startTime, endTime recvWindow
/dapi/v1/income/asyn (GET) 获取合约交易流水下载 ID (USER_DATA) startTime, endTime recvWindow
/dapi/v1/order/asyn/id (GET) 通过 ID 获取合约历史订单下载链接 (USER_DATA) downloadId recvWindow
/dapi/v1/trade/asyn/id (GET) 通过 ID 获取合约成交下载链接 (USER_DATA) downloadId recvWindow
/dapi/v1/income/asyn/id (GET) 通过 ID 获取合约交易流水下载链接 (USER_DATA) downloadId recvWindow
/dapi/v1/income (GET) 获取流水历史 (USER_DATA) symbol, incomeType, startTime, endTime, page, limit, recvWindow
/dapi/v1/leverageBracket (GET) 交易对的名义价值档位 (USER_DATA) pair, recvWindow
/dapi/v2/leverageBracket (GET) 交易对的名义价值档位 (USER_DATA) symbol, recvWindow
/dapi/v1/commissionRate (GET) 用户手续费率 (USER_DATA) symbol recvWindow
/dapi/v1/ticker/24hr (GET) 24小时滚动窗口价格变动统计 symbol, pair
/futures/data/basis (GET) 基差数据 pair, contractType, period limit, startTime, endTime
/dapi/v1/time (GET) 检查服务器时间
/dapi/v1/aggTrades (GET) 压缩/聚合交易列表 symbol fromId, startTime, endTime, limit
/dapi/v1/continuousKlines (GET) 连续合约K线/蜡烛图数据 pair, contractType, interval startTime, endTime, limit
/dapi/v1/exchangeInfo (GET) 交易对信息
/dapi/v1/fundingInfo (GET) 获取资金费率信息
/dapi/v1/fundingRate (GET) 获取永续合约资金费率历史 symbol startTime, endTime, limit
/dapi/v1/constituents (GET) 查询指数价格成分 symbol
/dapi/v1/indexPriceKlines (GET) 指数价格K线/蜡烛图数据 pair, interval startTime, endTime, limit
/dapi/v1/premiumIndex (GET) 指数价格和标记价格 symbol, pair
/dapi/v1/klines (GET) K线/蜡烛图数据 symbol, interval startTime, endTime, limit
/futures/data/globalLongShortAccountRatio (GET) 多空持仓人数比 pair, period limit, startTime, endTime
/dapi/v1/markPriceKlines (GET) 标记价格K线/蜡烛图数据 symbol, interval startTime, endTime, limit
/dapi/v1/historicalTrades (GET) 历史成交查询 (MARKET_DATA) symbol limit, fromId
/futures/data/openInterestHist (GET) 持仓量统计 pair, contractType, period limit, startTime, endTime
/dapi/v1/openInterest (GET) 持仓量 symbol
/dapi/v1/depth (GET) 深度信息 symbol limit
/dapi/v1/premiumIndexKlines (GET) 溢价指数K线数据 symbol, interval startTime, endTime, limit
/dapi/v1/trades (GET) 近期成交列表 symbol limit
/dapi/v1/ticker/bookTicker (GET) 最优挂单价格 symbol, pair
/dapi/v1/ticker/price (GET) 最新价格 symbol, pair
/futures/data/takerBuySellVol (GET) 主动买入/卖出量 pair, contractType, period limit, startTime, endTime
/dapi/v1/ping (GET) 测试连通性
/futures/data/topLongShortAccountRatio (GET) 大户多空持仓人数比(账户数) symbol, period limit, startTime, endTime
/futures/data/topLongShortPositionRatio (GET) 大户多空持仓量比(持仓量) pair, period limit, startTime, endTime
/dapi/v1/pmAccountInfo (GET) 经典投资组合保证金账户信息 (USER_DATA) asset recvWindow
/dapi/v1/userTrades (GET) 账户成交历史 (USER_DATA) symbol, pair, orderId, startTime, endTime, fromId, limit, recvWindow
/dapi/v1/allOrders (GET) 所有订单 (USER_DATA) symbol, pair, orderId, startTime, endTime, limit, recvWindow
/dapi/v1/countdownCancelAll (POST) 自动撤消所有未平仓订单 (TRADE) symbol, countdownTime recvWindow
/dapi/v1/allOpenOrders (DELETE) 撤销所有未平仓订单 (TRADE) symbol recvWindow
/dapi/v1/batchOrders (DELETE) 批量撤销订单 (TRADE) symbol orderIdList, origClientOrderIdList, recvWindow
/dapi/v1/batchOrders (PUT) 批量修改订单 (TRADE) batchOrders recvWindow
/dapi/v1/batchOrders (POST) 批量下单 (TRADE) batchOrders recvWindow
/dapi/v1/order (DELETE) 撤销订单 (TRADE) symbol orderId, origClientOrderId, recvWindow
/dapi/v1/order (PUT) 修改订单 (TRADE) symbol, side orderId, origClientOrderId, quantity, price, priceMatch, recvWindow
/dapi/v1/order (POST) 下单 (TRADE) symbol, side, type positionSide, timeInForce, quantity, reduceOnly, price, newClientOrderId, stopPrice, closePosition, activationPrice, callbackRate, workingType, priceProtect, newOrderRespType, priceMatch, selfTradePreventionMode, recvWindow
/dapi/v1/order (GET) 查询订单 (USER_DATA) symbol orderId, origClientOrderId, recvWindow
/dapi/v1/leverage (POST) 更改初始杠杆 (TRADE) symbol, leverage recvWindow
/dapi/v1/marginType (POST) 更改保证金模式 (TRADE) symbol, marginType recvWindow
/dapi/v1/openOrders (GET) 当前所有未平仓订单 (USER_DATA) symbol, pair, recvWindow
/dapi/v1/orderAmendment (GET) 获取订单修改历史 (USER_DATA) symbol orderId, origClientOrderId, startTime, endTime, limit, recvWindow
/dapi/v1/positionMargin/history (GET) 获取持仓保证金变动历史 (TRADE) symbol type, startTime, endTime, limit, recvWindow
/dapi/v1/positionMargin (POST) 修改逐仓保证金 (TRADE) symbol, amount, type positionSide, recvWindow
/dapi/v1/adlQuantile (GET) 持仓 ADL 队列估算 (USER_DATA) symbol, recvWindow
/dapi/v1/positionRisk (GET) 持仓信息 (USER_DATA) marginAsset, pair, recvWindow
/dapi/v1/openOrder (GET) 查询当前未平仓订单 (USER_DATA) symbol orderId, origClientOrderId, recvWindow
/dapi/v1/forceOrders (GET) 用户的强平订单 (USER_DATA) symbol, autoCloseType, startTime, endTime, limit, recvWindow
/dapi/v1/listenKey (DELETE) 关闭用户数据流 (USER_STREAM)
/dapi/v1/listenKey (PUT) 延长用户数据流有效期 (USER_STREAM)
/dapi/v1/listenKey (POST) 生成用户数据流 (USER_STREAM)

参数

通用参数

  • recvWindow: (例如,5000)
  • startTime:毫秒时间戳 (例如,1623319461670)
  • endTime:毫秒时间戳 (例如,1641782889000)
  • downloadId:通过下载 ID API 获取 (例如,1)
  • symbol
  • incomeType:”TRANSFER”,”WELCOME_BONUS”, “FUNDING_FEE”, “REALIZED_PNL”, “COMMISSION”, “INSURANCE_CLEAR”, and “DELIVERED_SETTELMENT”
  • startTime: (例如,1623319461670)
  • endTime: (例如,1641782889000)
  • page
  • limit:默认 100;最大 1000 (例如,100)
  • pair
  • symbol
  • pair:BTCUSD
  • fromId:从中获取聚合交易的 ID(包含)。 (例如,1)
  • asset
  • orderId: (例如,1)
  • orderId: (例如,1)
  • countdownTime:倒计时时间,1000 表示 1 秒。0 表示取消计时器
  • orderIdList:最大长度 10 例如 [1234567,2345678]
  • origClientOrderIdList:最大长度 10 例如 [“my_id_1″,”my_id_2”],需要编码双引号。逗号后不要有空格。
  • origClientOrderId: (例如,1)
  • leverage:目标初始杠杆:整数,范围 1 到 125
  • dualSidePosition:”true”:双向持仓模式;”false”:单向持仓模式
  • type:1:增加持仓保证金,2:减少持仓保证金
  • amount: (例如,1.0)
  • batchOrders:订单列表。最多 5 个订单
  • quantity:以合约张数计量的数量,不能与 closePosition=true 一起发送 (例如,1.0)
  • price: (例如,1.0)
  • reduceOnly:”true” 或 “false”。默认为 “false”。不能在双向持仓模式下发送;不能与 closePosition=true(全部平仓)一起发送
  • newClientOrderId:未平仓订单中的唯一 ID。如果不发送,则自动生成。只能是由规则 ^[\.A-Z\:/a-z0-9_-]{1,36}$ 定义的字符串 (例如,1)
  • stopPrice:用于 STOP/STOP_MARKETTAKE_PROFIT/TAKE_PROFIT_MARKET 订单。 (例如,1.0)
  • closePositiontruefalse;全部平仓,与 STOP_MARKETTAKE_PROFIT_MARKET 一起使用。
  • activationPrice:用于 TRAILING_STOP_MARKET 订单,默认为最新价格(支持不同的 workingType) (例如,1.0)
  • callbackRate:用于 TRAILING_STOP_MARKET 订单,最小值 0.1,最大值 10,其中 1 表示 1% (例如,1.0)
  • priceProtect:”TRUE” 或 “FALSE”,默认为 “FALSE”。用于 STOP/STOP_MARKETTAKE_PROFIT/TAKE_PROFIT_MARKET 订单。
  • batchOrders:订单列表。最多 5 个订单
  • marginAsset

枚举类型

  • contractType:PERPETUAL | CURRENT_QUARTER | NEXT_QUARTER | CURRENT_QUARTER_DELIVERING | NEXT_QUARTER_DELIVERING | PERPETUAL_DELIVERING
  • period:5m | 15m | 30m | 1h | 2h | 4h | 6h | 12h | 1d
  • interval:1m | 3m | 5m | 15m | 30m | 1h | 2h | 4h | 6h | 8h | 12h | 1d | 3d | 1w | 1M
  • marginType:ISOLATED | CROSSED
  • positionSide:BOTH | LONG | SHORT
  • type:LIMIT | MARKET | STOP | STOP_MARKET | TAKE_PROFIT | TAKE_PROFIT_MARKET | TRAILING_STOP_MARKET
  • side:BUY | SELL
  • priceMatch:NONE | OPPONENT | OPPONENT_5 | OPPONENT_10 | OPPONENT_20 | QUEUE | QUEUE_5 | QUEUE_10 | QUEUE_20
  • timeInForce:GTC | IOC | FOK | GTX
  • workingType:MARK_PRICE | CONTRACT_PRICE
  • newOrderRespType:ACK | RESULT
  • selfTradePreventionMode:NONE | EXPIRE_TAKER | EXPIRE_BOTH | EXPIRE_MAKER
  • autoCloseType:LIQUIDATION | ADL

身份验证

对于需要认证的端点,你需要提供 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 (主网/测试网)
  • testnet-dev (测试网)
  • futures-keys (主网)

主网交易

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


Binance 账户

main

  • API Key:your_mainnet_api_key
  • Secret:your_mainnet_secret
  • Testnet:false

testnet-dev

  • API Key:your_testnet_api_key
  • Secret:your_testnet_secret
  • Testnet:true

TOOLS.md 结构

## Binance Accounts

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

### testnet-dev
- API Key: test456...abc
- Secret: testsecret...xyz
- Testnet: true
- Description: Development/testing

### futures-keys
- API Key: futures789...def
- Secret: futuressecret...uvw
- Testnet: false
- 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。

新客户端订单 ID

对于包含 newClientOrderId 参数的端点,该值必须以 agent- 开头。如果未提供该参数,将自动生成 agent- 后跟 18 个随机字母数字字符。如果提供了值,它将以 agent- 为前缀。

示例:agent-1a2b3c4d5e6f7g8h9i

用户代理标头

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

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

📄 原始文档

完整文档(英文):

https://skills.sh/binance/binance-skills-hub/derivatives-trading-coin-futures

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

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