🚀 快速安装
复制以下命令并运行,立即安装此 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_MARKET或TAKE_PROFIT/TAKE_PROFIT_MARKET订单。 (例如,1.0) - closePosition:
true、false;全部平仓,与STOP_MARKET或TAKE_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_MARKET或TAKE_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
智能体行为
- 请求凭证时:遮盖密钥(仅显示最后 5 个字符)
- 列出账户时:显示名称和环境,绝不显示密钥
- 账户选择:如果模糊不清则询问,默认为 main
- 在主网进行交易时,在执行前通过要求用户输入 “CONFIRM” 来确认
- 新凭证:提示输入名称、环境、签名模式
添加新账户
当用户提供新凭证时:
- 询问账户名称
- 询问:主网、测试网
- 以遮盖显示确认的方式存储在
TOOLS.md中
签名请求
对于需要签名的交易端点:
- 使用所有参数(包括时间戳(Unix 毫秒))构建查询字符串。
- 根据 RFC 3986 使用 UTF-8 对参数进行百分比编码。
- 使用 secretKey 通过 HMAC SHA256、RSA 或 Ed25519(取决于账户配置)对查询字符串进行签名。
- 将签名附加到查询字符串。
- 包含
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 原始英文文档,方便对照翻译。

评论(0)