Skip to main content

Issue Voucher

HTTP Request

POST /v5/broker/award/distribute-award

Request Parameters

ParameterRequiredTypeComments
accountIdtruestringUser ID
awardIdtruestringVoucher ID
specCodetruestringCustomised unique spec code, up to 8 characters
amounttruestringIssue amount
  • Spot airdrop supports up to 16 decimals
  • Other types supports up to 4 decimals
  • brokerIdtruestringBroker ID

    Response Parameters

    None

    Request Example

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

    {
    "accountId": "2846381",
    "awardId": "123456",
    "specCode": "award-001",
    "amount": "100",
    "brokerId": "v-28478"
    }

    Response Example

    {
    "retCode": 0,
    "retMsg": ""
    }