Binance 衍生品交易-期权技能

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

快速参考

参数

通用参数

• currency：资产类型，目前仅支持 USDT
• recordId：返回该 recordId 及之后的数据，默认返回最新数据，例如 100000 (例如，1)
• startTime：开始时间，例如 1593511200000 (例如，1623319461670)
• endTime：结束时间，例如 1593512200000 (例如，1641782889000)
• limit：返回结果集数量，默认：100，最大：1000 (例如，100)
• recvWindow： (例如，5000)
• blockOrderMatchingKey：
• underlying：标的物，例如 BTCUSDT
• liquidity：Taker 或 Maker
• legs：最多 1 条（仅支持单腿），JSON 格式的腿参数列表；示例：eapi/v1/block/order/create?orders=[{“symbol”:”BTC-210115-35000-C”, “price”:”100″,”quantity”:”0.0002″,”side”:”BUY”,”type”:”LIMIT”}]
• blockOrderMatchingKey：如果指定，则返回与该 blockOrderMatchingKey 关联的特定大宗交易
• symbol：期权交易对，例如 BTC-200730-9000-C
• symbol：期权交易对，例如 BTC-200730-9000-C
• interval：时间间隔
• underlyingAsset：标的资产，例如 ETH/BTC
• expiration：到期日，例如 221225
• underlying：期权标的物，例如 BTCUSDT
• underlyings：期权标的物符号，例如 BTCUSDT,ETHUSDT
• countdownTime：倒计时时间（毫秒）（例如 1,000 表示 1 秒）。0 表示禁用计时器。不接受负值（例如 -10000）。最小可接受值为 5,000
• windowTimeInMilliseconds：MMP 间隔（毫秒）；范围 (0,5000]
• frozenTimeInMilliseconds：MMP 冻结时间（毫秒），如果设置为 0，则需要手动重置
• qtyLimit：数量限制（例如，1.0）
• deltaLimit：净 Delta 限制（例如，1.0）
• fromId：从该交易 ID 开始获取。默认获取最近的交易，例如 4611875134427365376 (例如，1)
• orderIds：订单 ID，例如 [4611875134427365377,4611875134427365378]
• clientOrderIds：用户自定义订单 ID，例如 [“my_id_1″,”my_id_2”]
• orderId：订单 ID，例如 4611875134427365377 (例如，1)
• clientOrderId：用户自定义订单 ID，例如 10000 (例如，1)
• quantity：订单数量（例如，1.0）
• price：订单价格（例如，1.0）
• reduceOnly：只减仓（默认 false） (例如，false）)
• postOnly：只做挂单（默认 false） (例如，false）)
• isMmp：是否为做市商保护订单，true/false
• orders：订单列表。最多 10 个订单

枚举类型

• side：BUY | SELL
• type：LIMIT
• timeInForce：GTC | IOC | FOK | GTX
• newOrderRespType：ACK | RESULT

身份验证

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

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

基础 URL：

• 主网：https://eapi.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。

用户代理标头

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

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