新建子帳戶的API Key
給新建好的子帳戶創建新的API key。需使用母帳戶的API key。
提示
在調用接口時,使用的API key至少需要擁有以下其中一種權限
- 母API key: "Account Transfer(資產帳戶劃轉)", "Subaccount Transfer(母子帳戶劃轉)", "Withdrawal(提幣)"
HTTP 請求
POST /user/v3/private/create-sub-api
請求參數
參數 | 是否必須 | 類型 | 說明 |
---|---|---|---|
subuid | true | integer | 子帳戶userId |
note | false | string | 設置備註 |
readOnly | true | integer | 0 :可讀可寫. 1 :只讀 |
ips | false | string | 綁定IP. 比如: "192.168.0.1,192.168.0.2"注意:
|
permissions | true | Object | 勾選api key權限.
|
> ContractTrade | false | array | 合約. ["Order","Position"] |
> Spot | false | array | 現貨. ["SpotTrade"] |
> Wallet | false | array | 錢包. ["AccountTransfer","SubMemberTransferList"] |
> Options | false | array | USDC合約. ["OptionsTrade"] |
> Derivatives | false | array | 統一帳戶權限. 該字段失效, 因為系統將會自動根據您的帳戶類型(經典帳戶和統一帳戶)來決定是否增加該權限 |
> Exchange | false | array | 兌換. ["ExchangeHistory"] |
返回參數
參數 | 類型 | 說明 |
---|---|---|
id | string | 唯一id. 內部使用 |
note | string | 備註 |
apiKey | string | Api key |
readOnly | integer | 0 :可讀可寫. 1 :只讀 |
secret | string | Api密鑰密碼.
|
permissions | Object | 權限類型 |
> ContractTrade | array | 合約交易的權限 |
> Spot | array | 現貨交易的權限 |
> Wallet | array | 錢包的權限 |
> Options | array | USDC合約的權限. 該權限支持USDC合約下的期權和永續交易 |
> Derivatives | array | 統一帳戶權限 |
> CopyTrading | array | 跟單交易的權限. 子帳戶暫不支持, 總是[] |
> BlockTrade | array | 大宗交易的權限. 子帳戶暫不支持,總是[] |
> Exchange | array | 兌換的權限 |
> NFT | array | NFT的權限. 子帳戶暫不支持, 總是[] |
請求示例
POST /user/v3/private/create-sub-api HTTP/1.1
Host: api-testnet.bybit.com
X-BAPI-SIGN: xxxxxxxxxxxxx
X-BAPI-API-KEY: xxxxxxxxxxxxx
X-BAPI-TIMESTAMP: 1671176685767
X-BAPI-RECV-WINDOW: 50000
Content-Type: application/json
Content-Length: 796
{
"subuid": 1111111111,
"note": "mytest",
"readOnly": 1,
"ips": "*",
"permissions": {
"ContractTrade": [
"Order",
"Position"
],
"Spot": [
"SpotTrade"
],
"Wallet": [
"AccountTransfer"
],
"Options": [
"OptionsTrade"
],
"CopyTrading": [
"CopyTrading"
],
"BlockTrade": [
"BlockTrade"
],
"Exchange": [
"ExchangeHistory"
],
"NFT": [
"NFTQueryProductList"
]
}
}
響應示例
{
"retCode": 0,
"retMsg": "OK",
"result": {
"id": "1111111111",
"note": "mytest",
"apiKey": "xxxxxxxxxxxxx",
"readOnly": 1,
"secret": "xxxxxxxxxxxxx",
"permissions": {
"ContractTrade": [
"Order",
"Position"
],
"Spot": [
"SpotTrade"
],
"Wallet": [
"AccountTransfer"
],
"Options": [
"OptionsTrade"
],
"Derivatives": [
"DerivativesTrade"
],
"CopyTrading": [],
"BlockTrade": [],
"Exchange": [
"ExchangeHistory"
],
"NFT": []
}
},
"retExtInfo": {},
"time": 1671176685954
}