v26

latestOpenAPI 3.0.2raw.githubusercontent.com2024-10-0834042975.6 KB

Gift Card

Buy a Binance Code (TRADE)

This API is for buying a fixed-value Binance Code, which means your Binance Code will be redeemable to a token that is different to the token that you are paying in. If the token you’re paying and the redeemable token are the same, please use the Create Binance Code endpoint. You can use supported crypto currency or fiat token as baseToken to buy Binance Code that is redeemable to your chosen faceToken. Once successfully purchased, the amount of baseToken would be deducted from your funding wallet.

To get started with, please make sure:

You have a Binance account
You have passed kyc
You have a sufficient balance in your Binance funding wallet
You need Enable Withdrawals for the API Key which requests this endpoint.

Daily creation volume: 2 BTC / 24H Daily creation times: 200 Codes / 24H

Weight(IP): 1

post/sapi/v1/giftcard/buyCode

Query parameters

baseTokenstring required

The token you want to pay, example BUSD

faceTokenstring required

The token you want to buy, example BNB. If faceToken = baseToken, it's the same as createCode endpoint.

baseTokenAmountnumber double required

The base token asset quantity, example 1.002

recvWindowinteger

Example:5000

The value cannot be greater than 60000

timestampinteger required

UTC timestamp in ms

signaturestring required

Signature

Response

Code creation

codestring required

messagestring required

successboolean required

Example response

{
  "code": "000000",
  "message": "success",
  "data": {
    "referenceNo": "0033002327977405",
    "code": "AOGANK3NB4GIT3C6",
    "expiredTime": 1727417154000
  }
}