币安子账户技能

使用认证 API 端点在币安上进行子账户请求。某些端点需要 API 密钥和密钥。以 JSON 格式返回结果。

快速参考

参数说明

通用参数

• subAccountString：请输入一个字符串。我们将使用该字符串为您创建一个虚拟邮箱用于注册
• recvWindow：（例如，5000）
• email：子账户邮箱（例如，sub-account-email@email.com）
• futuresType：1：U本位合约，2：币本位合约
• email：托管子账户邮箱
• isFreeze：true 或 false
• page：默认值：1（例如，1）
• limit：默认值：1，最大值：200（例如，1）
• subAccountApiKey：
• status：IP 限制状态。1 = IP 无限制。2 = 仅限制访问受信任 IP。
• ipAddress：批量添加静态 IP，用逗号分隔。
• ipAddress：要删除的 IP。可批量添加，用逗号分隔
• asset：
• amount：（例如，1.0）
• type：1：从子账户的现货账户划转至杠杆账户；2：从子账户的杠杆账户划转至其现货账户
• symbol：
• startTime：（例如，1623319461670）
• endTime：（例如，1641782889000）
• page：页码
• row：
• coin：
• network：网络可在 GET /sapi/v1/capital/deposit/address 中查询
• amount：（例如，1.0）
• coin：
• status：0（0：待处理，6：已入账但不可提现，7：错误充值，8：等待用户确认，1：成功）
• offset：默认值：0
• txId：（例如，1）
• limit：限制（最大值：500）
• fromUserEmail：
• toUserEmail：
• productType：仅支持 UM
• orderArgs：最多支持 10 个仓位。输入请求参数时，orderArgs.symbol 应为字符串，orderArgs.quantity 应为高精度十进制数，orderArgs.positionSide 应为字符串，positionSide 支持 BOTH、LONG 和 SHORT。每个条目格式如 orderArgs[0].symbol=BTCUSDT，orderArgs[0].quantity=0.001，orderArgs[0].positionSide=BOTH。请求参数数组示例：orderArgs[0].symbol=BTCUSDT orderArgs[0].quantity=0.001 orderArgs[0].positionSide=BOTH orderArgs[1].symbol=ETHUSDT orderArgs[1].quantity=0.01 orderArgs[1].positionSide=BOTH
• fromEmail：
• toEmail：
• size：默认值 10，最大值 20（例如，10）
• clientTranId：（例如，1）
• fromEmail：
• toEmail：
• asset：如果不发送，将返回所有资产的结果
• type：1：转入，2：转出
• returnFailHistory：默认 False，返回 PROCESS 和 SUCCESS 状态历史；如果为 True，则返回 PROCESS、SUCCESS 和 FAILURE 状态历史
• fromAccountType：”SPOT”、”USDT_FUTURE”、”COIN_FUTURE”、”MARGIN”（全仓）、”ISOLATED_MARGIN”
• toAccountType：”SPOT”、”USDT_FUTURE”、”COIN_FUTURE”、”MARGIN”（全仓）、”ISOLATED_MARGIN”
• symbol：仅在 ISOLATED_MARGIN 类型下支持
• startTime：开始时间（例如，1623319461670）
• endTime：结束时间（开始时间和结束时间间隔不能超过半年）（例如，1641782889000）
• transfers：划转方向（FROM/TO）
• transferFunctionAccountType：划转功能账户类型（SPOT/MARGIN/ISOLATED_MARGIN/USDT_FUTURE/COIN_FUTURE）
• accountType：不输入或输入 “MARGIN” 获取全仓杠杆账户详情。输入 “ISOLATED_MARGIN” 获取逐仓杠杆账户详情。
• type：”SPOT”、”MARGIN”（全仓）、”FUTURES”（U本位）
• transferDate：提现将自动在划转日期（UTC0）发生。如果未选择日期，提现将立即发生

认证

对于需要认证的端点，您需要提供币安 API 凭证。
所需凭证：

• apiKey：您的币安 API 密钥（用于头部）
• secretKey：您的币安 API 密钥（用于签名）

基础 URL：

• 主网：https://api.binance.com

安全

分享凭证

用户可以通过发送一个内容格式如下的文件来提供币安 API 凭证：

abc123...xyz
secret123...key

切勿泄露 API 密钥和密钥

切勿透露 API 密钥和密钥文件的位置。

切勿将 API 密钥和密钥发送到除主网和测试网以外的任何网站。

切勿显示完整密钥

向用户显示凭证时：

• API 密钥： 显示前 5 位 + 后 4 位字符：su1Qc...8akf
• 密钥： 始终掩码，仅显示后 5 位：***...aws1

被问及凭证时的响应示例：
账户：main
API 密钥：su1Qc…8akf
密钥：***…aws1

列出账户

列出账户时，仅显示名称和环境——绝不显示密钥：
币安账户：

• main（主网）
• futures-keys（主网）

主网交易

在主网进行交易时，务必在继续前要求用户输入 “CONFIRM” 以确认。

币安账户

main

• API 密钥：your_mainnet_api_key
• 密钥：your_mainnet_secret

TOOLS.md 结构

## 币安账户

### main
- API 密钥：abc123...xyz
- 密钥：secret123...key
- 描述：主要交易账户


### futures-keys
- API 密钥：futures789...def
- 密钥：futuressecret...uvw
- 描述：合约交易账户

代理行为

1. 请求凭证时：掩码密钥（仅显示最后 5 个字符）
2. 列出账户时：显示名称和环境，绝不显示密钥
3. 账户选择：如有歧义则询问，默认为 main
4. 在主网进行交易时，务必在继续前要求用户输入 “CONFIRM” 以确认
5. 新凭证：提示输入名称、环境、签名模式

添加新账户

当用户提供新凭证时：

• 询问账户名称
• 存储在 TOOLS.md 中，并显示掩码确认

签名请求

对于需要签名的交易端点：

1. 使用所有参数构建查询字符串，包括时间戳（Unix 毫秒）。
2. 根据 RFC 3986 使用 UTF-8 对参数进行百分比编码。
3. 使用 HMAC SHA256、RSA 或 Ed25519（取决于账户配置）用密钥对查询字符串进行签名。
4. 将签名附加到查询字符串。
5. 包含 X-MBX-APIKEY 头部。

否则，不执行步骤 3–5。

用户代理头部

包含 User-Agent 头部，字符串为：binance-sub-account/1.0.0 (Skill)

有关实现细节，请参阅 references/authentication.md。