创建子账户API Key V2 (适用母账户) (TRADE)
接口描述
为子账户创建新的 API Key。
HTTP请求
POST /sapi/v2/sub-account/subAccountApi
请求权重(UID)
3000
请求参数
| 名称 | 类型 | 是否必需 | 描述 |
|---|---|---|---|
| STRING | YES | 子账户邮箱 | |
| apiName | STRING | YES | API Key 名称 |
| status | INTEGER | YES | IP 限制状态。1 = 无限制，2 = 限定 IP，3 = 第三方 IP 限制 |
| canTrade | BOOLEAN | NO | 现货/杠杆交易权限，默认 false |
| canMarginLoanRepay | BOOLEAN | NO | 杠杆借还款权限，默认 false |
| canFuturesTrade | BOOLEAN | NO | 合约交易权限，默认 false |
| canUniversalTransfer | BOOLEAN | NO | 万能划转权限，默认 false |
| canVanillaOptions | BOOLEAN | NO | 欧式期权权限，默认 false |
| canFixApiTrading | BOOLEAN | NO | FIX API Trading 权限。仅支持使用 Ed25519 公钥的 API Key。其他类型的 key 设置为 true 时返回 -9000 Unsupported operation |
| canFixApiReading | BOOLEAN | NO | FIX API Reading 权限。仅支持使用 Ed25519 公钥的 API Key。其他类型的 key 设置为 true 时返回 -9000 Unsupported operation |
| ipAddress | STRING | NO | status=2 时必填。IP 地址列表，最长 500 个字符 |
| thirdPartyName | STRING | NO | status=3 时必填。第三方名称 |
| publicKey | STRING | NO | RSA 或 Ed25519 公钥（可选）。必须放在请求体中，放在 URL 查询串中会被拒绝 |
| recvWindow | LONG | NO | |
| timestamp | LONG | YES |
status=2时ipAddress为必填status=3时thirdPartyName为必填- 不支持资管子账号（Asset Sub Account）操作
- 调用者须通过 KYC IP 限制校验
请求示例
curl --request POST \
--url https://api.binance.com/sapi/v2/sub-account/subAccountApi \
--header 'Content-Type: application/x-www-form-urlencoded' \
--header 'X-MBX-APIKEY: <string>' \
--data email=123@test.com \
--data apiName=my-fix-api \
--data status=2 \
--data ipAddress=1.2.3.4 \
--data canTrade=true \
--data canFixApiTrading=true \
--data canFixApiReading=true \
--data-urlencode publicKey='-----BEGIN PUBLIC KEY-----
MCowBQYDK2VwAyEAptEM59ao3nOD2baduIA830qZU4k4mqfvv7PwHVAfZhg=
-----END PUBLIC KEY-----' \
--data timestamp=1770736694138
publicKey放在 URL 查询串中会直接报错，示例中使用--data-urlencode放在请求体中。
响应示例
{
"apiName": "myKey",
"apiKey": "vmPUZE6mv9SD5VNHk4HlWFsOr6aKE2zvsw0MuIgwCIPy6utIco14y7Ju91duEh8A",
"secretKey": "NhqPtmdSJYdKjVHjA7PZj4Mge3R5YNiP1e3UZjInClVN65XAbvqqM6A7H5fATj0j",
"canTrade": true,
"canMarginLoanRepay": false,
"canFuturesTrade": false,
"canUniversalTransfer": false,
"canVanillaOptions": false,
"canFixApiTrading": true,
"canFixApiReading": false,
"status": 2,
"ipList": [
"192.168.1.1",
"10.0.0.1"
]
}
响应参数
| 名称 | 类型 | 描述 |
|---|---|---|
| apiName | STRING | API Key 名称 |
| apiKey | STRING | API Key（公钥） |
| secretKey | STRING | Secret Key，仅创建时返回一次，请妥善保存 |
| canTrade | BOOLEAN | 现货/杠杆交易权限 |
| canMarginLoanRepay | BOOLEAN | 杠杆借还款权限 |
| canFuturesTrade | BOOLEAN | 合约交易权限 |
| canUniversalTransfer | BOOLEAN | 万能划转权限 |
| canVanillaOptions | BOOLEAN | 欧式期权权限 |
| canFixApiTrading | BOOLEAN | FIX API Trading 权限 |
| canFixApiReading | BOOLEAN | FIX API Reading 权限 |
| status | INTEGER | IP 限制状态。1 = 无限制，2 = 限定 IP，3 = 第三方 IP 限制 |
| ipList | ARRAY | IP 列表（status=2 时为 IP 地址列表；status=3 时为第三方名称列表） |