查詢 Tier 信息

查詢用戶卡片獎勵 Tier 等級及消費額度信息，包含已消費額度、總額度、用戶 Tier 等級及是否開啟自動 cashback 等。

HTTP 請求

POST/v5/card/reward/points/tier

請求參數

無

響應參數

參數	類型	說明
retCode	integer	業務返回碼。0: 成功；非零: 失敗
retMsg	string	返回消息
result	object
> usedLimit	string	已消費額度（單位 USD，積分 × 0.002 轉換，保留兩位小數，四捨五入）
> limit	string	總額度
> unit	string	額度單位（如 USD）
> tier	string	用戶 Tier 等級
> autoCashback	boolean	是否開啟自動 cashback

---

請求示例

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));

響應示例

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