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

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

快速参考

参数

通用参数

• amount： (例如，1.0)
• transferSide：”TO_UM”,”FROM_UM”
• recvWindow： (例如，5000)
• autoRepay：默认值：true；false 表示关闭自动偿还期货负余额功能 (例如，true)
• from：SPOT 或 MARGIN，默认 SPOT (例如，SPOT)
• asset：LDUSDT 和 RWUSD
• asset：
• transferType：EARN_TO_FUTURE /FUTURE_TO_EARN
• startTime： (例如，1623319461670)
• endTime： (例如，1641782889000)
• size：默认：10 最大：100 (例如，10)
• current：当前查询页码，从 1 开始，默认：1 (例如，1)
• deltaEnabled：true 启用 Delta 模式；false 禁用 Delta 模式

身份验证

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

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

基础 URL：

• 主网：https://api.binance.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 (主网)
• 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-derivatives-trading-portfolio-margin-pro/1.0.0 (Skill)

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