Skip to main content

Create a dual-token gift card(fixed value, discount feature)(TRADE)

API Description#

  • This API is for creating a dual-token ( stablecoin-denominated) Binance Gift Card. You may create a gift card using USDT as baseToken, that is redeemable to another designated token (faceToken). For example, you can create a fixed-value BTC gift card and pay with 100 USDT plus 1 USDT fee. This gift card can keep the value fixed at 100 USDT before redemption, and will be redeemable to BTC equivalent to 100 USDT upon redemption.
  • Once successfully created, the amount of baseToken (e.g. USDT) in the fixed-value gift card along with the fee would be deducted from your funding wallet.
  • To get started with, please make sure:
    • You have a Binance account
    • You have passed KYB
    • You have a sufficient balance(Gift Card amount and fee amount) in your Binance funding wallet
    • You need Enable Withdrawals for the API Key which requests this endpoint.

HTTP Request#

POST /sapi/v1/giftcard/buyCode

Request Weight(IP)#

1

  • Daily creation volume: 2 BTC / 24H / account
  • Daily creation quantity: 200 Gift Cards / 24H / account

Request Parameters#

NameTypeMandatoryDescription
baseTokenSTRINGYESThe token you want to pay, example: BUSD
faceTokenSTRINGYESThe token you want to buy, example: BNB. If faceToken = baseToken, it's the same as createCode endpoint.
baseTokenAmountDOUBLEYESThe base token asset quantity, example : 1.002
discountDOUBLENOStablecoin-denominated card discount percentage, Example: 1 for 1% discount. Scale should be less than 6.
recvWindowLONGNO
timestampLONGYES

Response Example#

{  "code": "000000",  "message": "success",  "data": {      "referenceNo": "0033002144060553",      "code": "6H9EKF5ECCWFBHGE",      "expiredTime": 1727417154000  },  "success": true}