查詢已發放代金券

HTTP 請求

POST /v5/broker/award/distribution-record

請求參數

參數	是否必需	類型	說明
accountId	true	string	用戶ID
awardId	true	string	代金券ID
specCode	true	string	自定義標識碼
withUsedAmount	false	boolean	是否返回用戶已使用金額 true false (默認)

響應參數

參數	類型	說明
accountId	string	用戶ID
awardId	string	代金券ID
specCode	string	自定義標識碼
amount	string	代金券金額
isClaimed	boolean	是否已領取true, false
startAt	string	可領取開始時間 (秒級時間戳)
endAt	string	可領取結束始時間 (秒級時間戳)
effectiveAt	string	領取後生效時間 (秒級時間戳)
ineffectiveAt	string	領取後失效時間 (秒級時間戳)
usedAmount	string	用戶已使用金額

請求示例

HTTP

POST /v5/broker/award/distribution-record HTTP/1.1
Host: api.bybit.com
X-BAPI-SIGN: XXXXXX
X-BAPI-API-KEY: XXXXXX
X-BAPI-TIMESTAMP: 1726112099846
X-BAPI-RECV-WINDOW: 5000
Content-Type: application/json
Content-Length: 111

{
    "accountId": "5714139",
    "awardId": "189528",
    "specCode": "demo000",
    "withUsedAmount": false
}

Python

Node.js

const { RestClientV5 } = require('bybit-api');

const client = new RestClientV5({
  testnet: true,
  key: 'apikey',
  secret: 'apisecret',
});

client
  .getBrokerIssuedVoucher({
    id: '80209',
  })
  .then((response) => {
    console.log(response);
  })
  .catch((error) => {
    console.error(error);
  });

響應示例

{
    "retCode": 0,
    "retMsg": "",
    "result": {
        "accountId": "5714139",
        "awardId": "189528",
        "specCode": "demo000",
        "amount": "1",
        "isClaimed": true,
        "startAt": "1725926400",
        "endAt": "1733788800",
        "effectiveAt": "1726531200",
        "ineffectiveAt": "1733817600",
        "usedAmount": "",
    }
}