Binance 衍生品交易-投资组合保证金技能

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

快速参考

参数

通用参数

• asset：
• recvWindow： (例如，5000)
• amount： (例如，1.0)
• transferSide：”TO_UM”,”FROM_UM”
• symbol：
• autoRepay：默认值：true；false 表示关闭自动偿还期货负余额功能 (例如，true)
• symbol：
• leverage：目标初始杠杆：整数，范围 1 到 125
• dualSidePosition：”true”：双向持仓模式；”false”：单向持仓模式
• asset：
• incomeType：TRANSFER, WELCOME_BONUS, REALIZED_PNL, FUNDING_FEE, COMMISSION, INSURANCE_CLEAR, REFERRAL_KICKBACK, COMMISSION_REBATE, API_REBATE, CONTEST_REWARD, CROSS_COLLATERAL_TRANSFER, OPTIONS_PREMIUM_FEE, OPTIONS_SETTLE_PROFIT, INTERNAL_TRANSFER, AUTO_EXCHANGE, DELIVERED_SETTELMENT, COIN_SWAP_DEPOSIT, COIN_SWAP_WITHDRAW, POSITION_LIMIT_INCREASE_FEE
• startTime：获取资金费用的开始时间戳（包含）。 (例如，1623319461670)
• endTime：获取资金费用的结束时间戳（包含）。 (例如，1641782889000)
• page：
• limit：默认 100；最大 1000 (例如，100)
• startTime： (例如，1623319461670)
• endTime： (例如，1641782889000)
• current：当前查询页码，从 1 开始。默认：1 (例如，1)
• size：默认：10 最大：100 (例如，10)
• archived：默认值：false。设置为 true 可查询 6 个月前的归档数据
• downloadId：通过下载 ID API 获取 (例如，1)
• marginAsset：
• pair：
• txId：POST/papi/v1/marginLoan 中的 tranId (例如，1)
• fromId：从此交易 ID 开始获取。默认获取最近的交易。 (例如，1)
• strategyId： (例如，1)
• newClientStrategyId： (例如，1)
• orderId： (例如，1)
• origClientOrderId： (例如，1)
• orderListId：必须提供 orderListId 或 listClientOrderId 之一 (例如，1)
• listClientOrderId：必须提供 orderListId 或 listClientOrderId 之一 (例如，1)
• newClientOrderId：用于唯一标识此次撤销。默认自动生成 (例如，1)
• quantity：订单数量 (例如，1.0)
• limitClientOrderId：限价订单的唯一 ID (例如，1)
• price： (例如，1.0)
• limitIcebergQty： (例如，1.0)
• stopClientOrderId：止损/止损限价腿的唯一 ID (例如，1)
• stopPrice： (例如，1.0)
• stopLimitPrice：如果提供，则必须提供 stopLimitTimeInForce。 (例如，1.0)
• stopIcebergQty： (例如，1.0)
• amount：
• specifyRepayAssets：用于偿还债务的特定资产列表；可以批量添加，用逗号分隔
• quantity： (例如，1.0)
• reduceOnly：”true” 或 “false”。默认为 “false”。不能在双向持仓模式下发送。
• price： (例如，1.0)
• priceProtect：”TRUE” 或 “FALSE”，默认为 “FALSE”。用于 STOP/STOP_MARKET 或 TAKE_PROFIT/TAKE_PROFIT_MARKET 订单
• stopPrice：用于 STOP/STOP_MARKET 或 TAKE_PROFIT/TAKE_PROFIT_MARKET 订单。 (例如，1.0)
• activationPrice：用于 TRAILING_STOP_MARKET 订单，默认为标记价格 (例如，1.0)
• callbackRate：用于 TRAILING_STOP_MARKET 订单，最小值 0.1，最大值 5，其中 1 表示 1% (例如，1.0)
• quoteOrderQty： (例如，1.0)
• icebergQty：与 LIMIT、STOP_LOSS_LIMIT 和 TAKE_PROFIT_LIMIT 一起使用，创建冰山订单 (例如，1.0)
• autoRepayAtCancel：仅在 MARGIN_BUY 或 AUTO_BORROW_REPAY 订单生效时使用，true 表示订单取消后需要偿还产生的债务。默认为 true (例如，true)
• goodTillDate：timeInForce 为 GTD 时的订单取消时间，当 timeInforce 设置为 GTD 时必需；订单时间戳仅保留秒级精度，毫秒部分将被忽略；goodTillDate 时间戳必须大于当前时间加 600 秒，且小于 253402300799000。必须在双向持仓模式下发送。
• feeBurn：”true”：开启手续费折扣；”false”：关闭手续费折扣

枚举类型

• side：BUY | SELL
• stopLimitTimeInForce：GTC | IOC | FOK
• newOrderRespType：ACK | RESULT
• sideEffectType：NO_SIDE_EFFECT | MARGIN_BUY | AUTO_REPAY
• priceMatch：NONE | OPPONENT | OPPONENT_5 | OPPONENT_10 | OPPONENT_20 | QUEUE | QUEUE_5 | QUEUE_10 | QUEUE_20
• positionSide：BOTH | LONG | SHORT
• strategyType：STOP | STOP_MARKET | LIMIT_MAKER | TAKE_PROFIT | TAKE_PROFIT_MARKET | TRAILING_STOP_MARKET
• timeInForce：GTC | IOC | FOK | GTX
• workingType：MARK_PRICE
• type：LIMIT | MARKET
• selfTradePreventionMode：NONE | EXPIRE_TAKER | EXPIRE_BOTH | EXPIRE_MAKER
• autoCloseType：LIQUIDATION | ADL

身份验证

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

• apiKey：你的 Binance API 密钥（用于请求头）
• secretKey：你的 Binance API 密钥（用于签名）

基础 URL：

• 主网：https://papi.binance.com
• 测试网：https://testnet.binancefuture.com

安全规范

共享凭证

用户可以通过发送一个文件来提供 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-portfolio-margin/1.0.0 (Skill)

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