Skip to main content

Query Card Limits

Query limits for the authenticated user's card, based on the user, card product, and card type. Returns system limits, user-configured limits, and current usage.

tip

Only limits for cards belonging to the authenticated user can be queried

All amounts are JSON numbers in the currency specified by baseFiat. Values that are not provided can be null.

HTTP Request​

POST/v5/card/limit/get

Request Parameters​

ParameterRequiredTypeComments
cardIdtruestringCard ID belonging to the authenticated user. Cannot be missing, null, empty, or whitespace-only

Response Parameters​

ParameterTypeComments
retCodeintegerBusiness return code. 0: success; non-zero: failure
retMsgstringReturn message
resultobjectQuery result. null on failure
> limitItemsarrayLimit item list. The number of items depends on the product and available limit data
>> baseFiatstringBase fiat currency code for all amounts in this item. Can be null
>> itemTypestringLimit type. SPENDING: Spending, ATM_WITHDRAW: ATM withdrawal. Other types are returned as their original strings, including "3": Total cash, "4": Cash-like spending other than ordinary payments, "5": QR Pay. Can be null
>> singleAllowednumberSystem limit per transaction. Can be null
>> singleCustomLimitnumberUser-configured limit per transaction. Can be null
>> dailyUsednumberAccumulated usage for the current day. Can be null
>> dailyAllowednumberSystem daily limit. Can be null
>> dailyCustomLimitnumberUser-configured daily limit. Can be null
>> monthlyUsednumberAccumulated usage for the current month. Can be null
>> monthlyAllowednumberSystem monthly limit. Can be null
>> monthlyCustomLimitnumberUser-configured monthly limit. Can be null
>> yearlyUsednumberAccumulated usage for the current year. Can be null
>> yearlyAllowednumberSystem yearly limit. Can be null
>> lifeTimeUsednumberAccumulated lifetime usage. Can be null
>> lifeTimeAllowednumberSystem lifetime limit. Can be null
retExtInfoobjectExtended information. Defaults to {}
timeintegerResponse time (Unix ms timestamp)

Error Codes​

retCoderetMsgComments
913110400CARD NOT EXISTSCard does not exist or does not belong to the authenticated user
913110000cardId cannot be blankcardId is missing, null, empty, or whitespace-only
913100000SYSTEM ERRORRequest binding failure or system error

Global error responses may omit retExtInfo and time.


Request Example​

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"
}

Response Example​

{
"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
}