Skip to main content

Query Voucher Spec

HTTP Request

POST /v5/broker/award/info

Request Parameters

ParameterRequiredTypeComments
idtruestringVoucher ID

Response Parameters

ParameterTypeComments
idstringVoucher ID
coinstringCoin
amountUnitstring
  • AWARD_AMOUNT_UNIT_USD
  • AWARD_AMOUNT_UNIT_COIN
  • productLinestringProduct line
    subProductLinestringSub product line
    totalAmountObjectTotal amount of voucher
    usedAmountstringUsed amount of voucher

    Request Example

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

    {
    "id": "80209"
    }

    Response Example

    {
    "retCode": 0,
    "retMsg": "",
    "result": {
    "id": "80209",
    "coin": "USDT",
    "amountUnit": "AWARD_AMOUNT_UNIT_USD",
    "productLine": "PRODUCT_LINE_CONTRACT",
    "subProductLine": "SUB_PRODUCT_LINE_CONTRACT_DEFAULT",
    "totalAmount": "10000",
    "usedAmount": "100"
    },
    "retExtInfo": {},
    "time": 1726107086313
    }