创建子账户API Key (适用母账户) (TRADE)
接口描述
为子账户创建新的 API Key。
HTTP请求
POST /sapi/v1/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 |
| ipAddress | STRING | NO | status=2 时必填。IP 地址列表，最长 500 个字符 |
| thirdPartyName | STRING | NO | status=3 时必填。第三方名称 |
| publicKey | STRING | NO | Ed25519 公钥（可选，用于 Ed25519 类型 API Key） |
| recvWindow | LONG | NO | |
| timestamp | LONG | YES |
status=2时ipAddress为必填status=3时thirdPartyName为必填- 不支持资管子账号（Asset Sub Account）操作
- 调用者须通过 KYC IP 限制校验
响应示例
{
"apiName": "myKey",
"apiKey": "vmPUZE6mv9SD5VNHk4HlWFsOr6aKE2zvsw0MuIgwCIPy6utIco14y7Ju91duEh8A",
"secretKey": "NhqPtmdSJYdKjVHjA7PZj4Mge3R5YNiP1e3UZjInClVN65XAbvqqM6A7H5fATj0j",
"canTrade": true,
"canMarginLoanRepay": false,
"canFuturesTrade": false,
"canUniversalTransfer": false,
"canVanillaOptions": 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 | 欧式期权权限 |
| status | INTEGER | IP 限制状态。1 = 无限制，2 = 限定 IP，3 = 第三方 IP 限制 |
| ipList | ARRAY | IP 列表（status=2 时为 IP 地址列表；status=3 时为第三方名称列表） |