Query Tier Info

Query the user's card reward tier level and spending limit information, including used limit, total limit, tier level, and auto cashback setting.

HTTP Request

POST/v5/card/reward/points/tier

Request Parameters

None

Response Parameters

Parameter	Type	Comments
retCode	integer	Business return code. 0: success; non-zero: failure
retMsg	string	Return message
result	object
> usedLimit	string	Used spending limit (in USD, converted from points × 0.002, rounded to 2 decimal places)
> limit	string	Total spending limit
> unit	string	Limit unit (e.g. USD)
> tier	string	User tier level
> autoCashback	boolean	Whether auto cashback is enabled

---

Request Example

HTTP

POST /v5/card/reward/points/tier 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

Python

import requests

url = "https://api-testnet.bybit.com/v5/card/reward/points/tier"
headers = {
    "X-BAPI-API-KEY": "xxxxxxxxxxxxxxxxxx",
    "X-BAPI-SIGN": "XXXXX",
    "X-BAPI-TIMESTAMP": "1672211918471",
    "X-BAPI-RECV-WINDOW": "5000"
}
response = requests.post(url, headers=headers)
print(response.json())

Node.js

const axios = require('axios');

const url = 'https://api-testnet.bybit.com/v5/card/reward/points/tier';
const headers = {
  'X-BAPI-API-KEY': 'xxxxxxxxxxxxxxxxxx',
  'X-BAPI-SIGN': 'XXXXX',
  'X-BAPI-TIMESTAMP': '1672211918471',
  'X-BAPI-RECV-WINDOW': '5000'
};

axios.post(url, {}, { headers })
  .then(response => console.log(response.data))
  .catch(error => console.error(error));

Response Example

{
    "retCode": 0,
    "retMsg": "OK",
    "result": {
        "usedLimit": "10.00",
        "limit": "500.00",
        "unit": "1",
        "tier": "GOLD",
        "autoCashback": true
    },
    "retExtInfo": {},
    "time": 1672211918471
}