新建子帳戶的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"注意: 不傳參數ips 或者入参值為"*"意味著不綁定 不綁定IP的api key將有90天的有效期限 一旦帳戶密碼做了修改，帳戶下的非永久api key將在7天後失效
permissions	true	Object	勾選api key權限. 注意: 必須傳入以下權限類型的任意一種, 否則報錯n
> 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密鑰密碼. 注意: 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
}