跳至主要内容

查詢卡片限額

根據用戶、卡產品及卡片類型,查詢已認證用戶本人的卡片限額。返回系統限額、用戶設置的限額及當前用量。

提示

僅可查詢屬於已認證用戶本人的卡片限額

所有金額均為 JSON number,幣種由 baseFiat 指定;未提供的值可以為 null。

HTTP 請求​

POST/v5/card/limit/get

請求參數​

參數是否必需類型說明
cardIdtruestring已認證用戶本人的卡片 ID,不可缺少、為 null、空字符串或僅包含空白字符

響應參數​

參數類型說明
retCodeinteger業務返回碼。0: 成功;非零: 失敗
retMsgstring返回消息
resultobject查詢結果,失敗時為 null
> limitItemsarray限額項列表,數量取決於產品及可用的限額數據
>> baseFiatstring本項所有金額的基礎法幣代碼,可以為 null
>> itemTypestring限額類型。SPENDING: 消費, ATM_WITHDRAW: ATM 取款。其他類型以原始字符串返回,包括 "3": 總現金, "4": 非普通支付的現金類消費, "5": QR Pay。可以為 null
>> singleAllowednumber系統單筆限額,可以為 null
>> singleCustomLimitnumber用戶設置的單筆限額,可以為 null
>> dailyUsednumber當前日累計用量,可以為 null
>> dailyAllowednumber系統日限額,可以為 null
>> dailyCustomLimitnumber用戶設置的日限額,可以為 null
>> monthlyUsednumber當前月累計用量,可以為 null
>> monthlyAllowednumber系統月限額,可以為 null
>> monthlyCustomLimitnumber用戶設置的月限額,可以為 null
>> yearlyUsednumber當前年累計用量,可以為 null
>> yearlyAllowednumber系統年限額,可以為 null
>> lifeTimeUsednumber生命週期累計用量,可以為 null
>> lifeTimeAllowednumber系統生命週期限額,可以為 null
retExtInfoobject擴展信息,默認為 {}
timeinteger響應時間(Unix 毫秒時間戳)

錯誤碼​

retCoderetMsg說明
913110400CARD NOT EXISTS卡片不存在或不屬於已認證用戶本人
913110000cardId cannot be blankcardId 缺少、為 null、空字符串或僅包含空白字符
913100000SYSTEM ERROR請求參數綁定失敗或系統異常

全局異常響應可以缺少 retExtInfo 和 time。


請求示例​

POST /v5/card/limit/get HTTP/1.1
Host: api-testnet.bybit.com
X-BAPI-SIGN: XXXXX
X-BAPI-API-KEY: xxxxxxxxxxxxxxxxxx
X-BAPI-TIMESTAMP: 1672211918471
X-BAPI-RECV-WINDOW: 5000
Content-Type: application/json

{
"cardId": "180585395564494848"
}

響應示例​

{
"retCode": 0,
"retMsg": "OK",
"result": {
"limitItems": [
{
"baseFiat": "USD",
"itemType": "SPENDING",
"singleAllowed": 2500,
"singleCustomLimit": null,
"dailyUsed": 1000,
"dailyAllowed": 5000,
"dailyCustomLimit": null,
"monthlyUsed": 5000,
"monthlyAllowed": 50000,
"monthlyCustomLimit": null,
"yearlyUsed": null,
"yearlyAllowed": null,
"lifeTimeUsed": null,
"lifeTimeAllowed": null
},
{
"baseFiat": "USD",
"itemType": "ATM_WITHDRAW",
"singleAllowed": 500,
"singleCustomLimit": null,
"dailyUsed": 200,
"dailyAllowed": 1000,
"dailyCustomLimit": null,
"monthlyUsed": 1000,
"monthlyAllowed": 10000,
"monthlyCustomLimit": null,
"yearlyUsed": null,
"yearlyAllowed": null,
"lifeTimeUsed": null,
"lifeTimeAllowed": null
}
]
},
"retExtInfo": {},
"time": 1672211918471
}