Market Data

Endpoint

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

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 minting 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 sufﬁcient balance(Gift Card amount and fee amount) in your Binance funding wallet
- You need Enable Withdrawals for the API Key which requests this endpoint.

POST

/sapi/v1/giftcard/buyCode

https://api.binance.com

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

This is a signed endpoint and a signature must be included in the request parameters.Learn more about how to generate a valid signature in the Endpoint Security Type

Create a dual-token gift card (fixed value, discount feature) › Request Weight

This endpoint consumes IP-based request weight. Heavier endpoints consume more of your IP rate limit capacity.

Learn more in the Rate limits section.

IP Weight1

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

X-MBX-APIKEY

string · required

An API Key is required to access this endpoint and must be included in the request headers. To create an API Key, refer to: https://www.binance.com/en/support/faq/detail/360002502072.

Example: API_KEY

Create a dual-token gift card (fixed value, discount feature) › Request Body

baseToken

string · required

The token you want to pay, example: BUSD

Example: BUSD

faceToken

string · required

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

Example: BNB

baseTokenAmount

number · float · required

The base token asset quantity, example : 1.002

Example: 1

timestamp

integer · int64 · required

Unix timestamp in milliseconds used to sign the request. The value must reflect the current client time and is validated by the server for signed endpoints.

Example: 1770736694138

recvWindow

integer · int64 · max: 60000

Example: 5000

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

200

Create a dual-token gift card

code

string

Example: 000000

message

string

Example: success

object

success

boolean

Example: true

Create a single-token gift card

This API is for creating a Binance Gift Card.

To get started with, please make sure:

You have a Binance account
You have passed KYB
You have a sufﬁcient balance(Gift Card amount and fee amount) in your Binance funding wallet
You need Enable Withdrawals for the API Key which requests this endpoint.

POST

/sapi/v1/giftcard/createCode

https://api.binance.com

Create a single-token gift card › Authorization

This is a signed endpoint and a signature must be included in the request parameters.Learn more about how to generate a valid signature in the Endpoint Security Type

Create a single-token gift card › Request Weight

This endpoint consumes IP-based request weight. Heavier endpoints consume more of your IP rate limit capacity.

Learn more in the Rate limits section.

IP Weight1

Create a single-token gift card › Headers

X-MBX-APIKEY

string · required

An API Key is required to access this endpoint and must be included in the request headers. To create an API Key, refer to: https://www.binance.com/en/support/faq/detail/360002502072.

Example: API_KEY

Create a single-token gift card › Request Body

token

string · required

The token type contained in the Binance Gift Card

Example: BNB

amount

number · float · required

The amount of the token contained in the Binance Gift Card

Example: 1

timestamp

integer · int64 · required

Unix timestamp in milliseconds used to sign the request. The value must reflect the current client time and is validated by the server for signed endpoints.

Example: 1770736694138

recvWindow

integer · int64 · max: 60000

Example: 5000

Create a single-token gift card › Responses

200

Create a single-token gift card

code

string

Example: 000000

message

string

Example: success

object

success

boolean

Example: true

Fetch RSA Public Key

This API is for fetching the RSA Public Key. This RSA Public key will be used to encrypt the card code.

Please note that the RSA Public key fetched is valid only for the current day.

GET

/sapi/v1/giftcard/cryptography/rsa-public-key

https://api.binance.com

Fetch RSA Public Key › Authorization

This is a signed endpoint and a signature must be included in the request parameters.Learn more about how to generate a valid signature in the Endpoint Security Type

Fetch RSA Public Key › Request Weight

This endpoint consumes IP-based request weight. Heavier endpoints consume more of your IP rate limit capacity.

Learn more in the Rate limits section.

IP Weight1

Fetch RSA Public Key › Headers

X-MBX-APIKEY

string · required

An API Key is required to access this endpoint and must be included in the request headers. To create an API Key, refer to: https://www.binance.com/en/support/faq/detail/360002502072.

Example: API_KEY

Fetch RSA Public Key › Query Parameters

timestamp

integer · int64 · required

Unix timestamp in milliseconds used to sign the request. The value must reflect the current client time and is validated by the server for signed endpoints.

Example: 1770736694138

recvWindow

integer · int64 · max: 60000

Example: 5000

Fetch RSA Public Key › Responses

200

Fetch RSA Public Key

code

string

Example: 000000

message

string

Example: success

data

string

Example: MIGfMA0GCSqGSIb3DQEBAQUAA4GNADCBiQKBgQCXBBVKLAc1GQ5FsIFFqOHrPTox5noBONIKr+IAedTR9FkVxq6e65updEbfdhRNkMOeYIO2i0UylrjGC0X8YSoIszmrVHeV0l06Zh1oJuZos1+7N+WLuz9JvlPaawof3GUakTxYWWCa9+8KIbLKsoKMdfS96VT+8iOXO3quMGKUmQIDAQAB

success

boolean

Example: true

Fetch Token Limit

This API is to help you verify which tokens are available for you to create Stablecoin-Denominated gift cards as mentioned in section 2 and its’ limitation.

GET

/sapi/v1/giftcard/buyCode/token-limit

https://api.binance.com

Fetch Token Limit › Authorization

This is a signed endpoint and a signature must be included in the request parameters.Learn more about how to generate a valid signature in the Endpoint Security Type

Fetch Token Limit › Request Weight

This endpoint consumes IP-based request weight. Heavier endpoints consume more of your IP rate limit capacity.

Learn more in the Rate limits section.

IP Weight1

Fetch Token Limit › Headers

X-MBX-APIKEY

string · required

An API Key is required to access this endpoint and must be included in the request headers. To create an API Key, refer to: https://www.binance.com/en/support/faq/detail/360002502072.

Example: API_KEY

Fetch Token Limit › Query Parameters

baseToken

string · required

The token you want to pay, example: BUSD

Example: BUSD

timestamp

integer · int64 · required

Unix timestamp in milliseconds used to sign the request. The value must reflect the current client time and is validated by the server for signed endpoints.

Example: 1770736694138

recvWindow

integer · int64 · max: 60000

Example: 5000

Fetch Token Limit › Responses

200

Fetch Token Limit

code

string

Example: 000000

message

string

Example: success

object[]

success

boolean

Example: true

Redeem a Binance Gift Card

This API is for redeeming a Binance Gift Card. Once redeemed, the coins will be deposited in your funding wallet.

POST

/sapi/v1/giftcard/redeemCode

https://api.binance.com

Redeem a Binance Gift Card › Authorization

This is a signed endpoint and a signature must be included in the request parameters.Learn more about how to generate a valid signature in the Endpoint Security Type

Redeem a Binance Gift Card › Request Weight

This endpoint consumes IP-based request weight. Heavier endpoints consume more of your IP rate limit capacity.

Learn more in the Rate limits section.

IP Weight1

Redeem a Binance Gift Card › Headers

X-MBX-APIKEY

string · required

An API Key is required to access this endpoint and must be included in the request headers. To create an API Key, refer to: https://www.binance.com/en/support/faq/detail/360002502072.

Example: API_KEY

Redeem a Binance Gift Card › Request Body

code

string · required

Redemption code of Binance Gift Card to be redeemed, supports both Plaintext & Encrypted code.

Example: 6H9EKF5ECCWFBHGE

timestamp

integer · int64 · required

Unix timestamp in milliseconds used to sign the request. The value must reflect the current client time and is validated by the server for signed endpoints.

Example: 1770736694138

externalUid

string · maxLength: 400

Each external unique ID represents a unique user on the partner platform. The function helps you to identify the redemption behavior of different users, such as redemption frequency and amount. It also helps risk and limit control of a single account, such as daily limit on redemption volume, frequency, and incorrect number of entries. This will also prevent a single user account reach the partner's daily redemption limits. We strongly recommend you to use this feature and transfer us the User ID of your users if you have different users redeeming Binance Gift Cards on your platform. To protect user data privacy, you may choose to transfer the user id in any desired format (max. 400 characters).

Example: user-123

recvWindow

integer · int64 · max: 60000

Example: 5000

Redeem a Binance Gift Card › Responses

200

Redeem a Binance Gift Card

code

string

Example: 000000

message

string

Example: success

object

success

boolean

Example: true

Verify Binance Gift Card by Gift Card Number

This API is for verifying whether the Binance Gift Card is valid or not by entering Gift Card Number.

Please note that if you enter the wrong Gift Card Number 5 times within an hour, you will no longer be able to verify any Gift Card Number for that hour.

GET

/sapi/v1/giftcard/verify

https://api.binance.com

Verify Binance Gift Card by Gift Card Number › Authorization

This is a signed endpoint and a signature must be included in the request parameters.Learn more about how to generate a valid signature in the Endpoint Security Type

Verify Binance Gift Card by Gift Card Number › Request Weight

This endpoint consumes IP-based request weight. Heavier endpoints consume more of your IP rate limit capacity.

Learn more in the Rate limits section.

IP Weight1

Verify Binance Gift Card by Gift Card Number › Headers

X-MBX-APIKEY

string · required

An API Key is required to access this endpoint and must be included in the request headers. To create an API Key, refer to: https://www.binance.com/en/support/faq/detail/360002502072.

Example: API_KEY

Verify Binance Gift Card by Gift Card Number › Query Parameters

referenceNo

string · required

Enter the Gift Card Number

Example: 0033002328060227

timestamp

integer · int64 · required

Unix timestamp in milliseconds used to sign the request. The value must reflect the current client time and is validated by the server for signed endpoints.

Example: 1770736694138

recvWindow

integer · int64 · max: 60000

Example: 5000

Verify Binance Gift Card by Gift Card Number › Responses

200

Verify Binance Gift Card by Gift Card Number

code

string

Example: 000000

message

string

Example: success

object

success

boolean

Example: true

Market Data

Endpoint

Download schema

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

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 minting 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 sufﬁcient balance(Gift Card amount and fee amount) in your Binance funding wallet
- You need Enable Withdrawals for the API Key which requests this endpoint.

POST

/sapi/v1/giftcard/buyCode

https://api.binance.com

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

This is a signed endpoint and a signature must be included in the request parameters.Learn more about how to generate a valid signature in the Endpoint Security Type

Create a dual-token gift card (fixed value, discount feature) › Request Weight

This endpoint consumes IP-based request weight. Heavier endpoints consume more of your IP rate limit capacity.

Learn more in the Rate limits section.

IP Weight1

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

X-MBX-APIKEY

string · required

An API Key is required to access this endpoint and must be included in the request headers. To create an API Key, refer to: https://www.binance.com/en/support/faq/detail/360002502072.

Example: API_KEY

Create a dual-token gift card (fixed value, discount feature) › Request Body

baseToken

string · required

The token you want to pay, example: BUSD

Example: BUSD

faceToken

string · required

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

Example: BNB

baseTokenAmount

number · float · required

The base token asset quantity, example : 1.002

Example: 1

timestamp

integer · int64 · required

Unix timestamp in milliseconds used to sign the request. The value must reflect the current client time and is validated by the server for signed endpoints.

Example: 1770736694138

recvWindow

integer · int64 · max: 60000

Example: 5000

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

200

Create a dual-token gift card

code

string

Example: 000000

message

string

Example: success

object

success

boolean

Example: true

Create a single-token gift card

This API is for creating a Binance Gift Card.

To get started with, please make sure:

You have a Binance account
You have passed KYB
You have a sufﬁcient balance(Gift Card amount and fee amount) in your Binance funding wallet
You need Enable Withdrawals for the API Key which requests this endpoint.

POST

/sapi/v1/giftcard/createCode

https://api.binance.com

Create a single-token gift card › Authorization

This is a signed endpoint and a signature must be included in the request parameters.Learn more about how to generate a valid signature in the Endpoint Security Type

Create a single-token gift card › Request Weight

This endpoint consumes IP-based request weight. Heavier endpoints consume more of your IP rate limit capacity.

Learn more in the Rate limits section.

IP Weight1

Create a single-token gift card › Headers

X-MBX-APIKEY

string · required

An API Key is required to access this endpoint and must be included in the request headers. To create an API Key, refer to: https://www.binance.com/en/support/faq/detail/360002502072.

Example: API_KEY

Create a single-token gift card › Request Body

token

string · required

The token type contained in the Binance Gift Card

Example: BNB

amount

number · float · required

The amount of the token contained in the Binance Gift Card

Example: 1

timestamp

integer · int64 · required

Unix timestamp in milliseconds used to sign the request. The value must reflect the current client time and is validated by the server for signed endpoints.

Example: 1770736694138

recvWindow

integer · int64 · max: 60000

Example: 5000

Create a single-token gift card › Responses

200

Create a single-token gift card

code

string

Example: 000000

message

string

Example: success

object

success

boolean

Example: true

Fetch RSA Public Key

This API is for fetching the RSA Public Key. This RSA Public key will be used to encrypt the card code.

Please note that the RSA Public key fetched is valid only for the current day.

GET

/sapi/v1/giftcard/cryptography/rsa-public-key

https://api.binance.com

Fetch RSA Public Key › Authorization

This is a signed endpoint and a signature must be included in the request parameters.Learn more about how to generate a valid signature in the Endpoint Security Type

Fetch RSA Public Key › Request Weight

This endpoint consumes IP-based request weight. Heavier endpoints consume more of your IP rate limit capacity.

Learn more in the Rate limits section.

IP Weight1

Fetch RSA Public Key › Headers

X-MBX-APIKEY

string · required

An API Key is required to access this endpoint and must be included in the request headers. To create an API Key, refer to: https://www.binance.com/en/support/faq/detail/360002502072.

Example: API_KEY

Fetch RSA Public Key › Query Parameters

timestamp

integer · int64 · required

Unix timestamp in milliseconds used to sign the request. The value must reflect the current client time and is validated by the server for signed endpoints.

Example: 1770736694138

recvWindow

integer · int64 · max: 60000

Example: 5000

Fetch RSA Public Key › Responses

200

Fetch RSA Public Key

code

string

Example: 000000

message

string

Example: success

data

string

success

boolean

Example: true

Fetch Token Limit

This API is to help you verify which tokens are available for you to create Stablecoin-Denominated gift cards as mentioned in section 2 and its’ limitation.

GET

/sapi/v1/giftcard/buyCode/token-limit

https://api.binance.com

Fetch Token Limit › Authorization

This is a signed endpoint and a signature must be included in the request parameters.Learn more about how to generate a valid signature in the Endpoint Security Type

Fetch Token Limit › Request Weight

This endpoint consumes IP-based request weight. Heavier endpoints consume more of your IP rate limit capacity.

Learn more in the Rate limits section.

IP Weight1

Fetch Token Limit › Headers

X-MBX-APIKEY

string · required

An API Key is required to access this endpoint and must be included in the request headers. To create an API Key, refer to: https://www.binance.com/en/support/faq/detail/360002502072.

Example: API_KEY

Fetch Token Limit › Query Parameters

baseToken

string · required

The token you want to pay, example: BUSD

Example: BUSD

timestamp

integer · int64 · required

Unix timestamp in milliseconds used to sign the request. The value must reflect the current client time and is validated by the server for signed endpoints.

Example: 1770736694138

recvWindow

integer · int64 · max: 60000

Example: 5000

Fetch Token Limit › Responses

200

Fetch Token Limit

code

string

Example: 000000

message

string

Example: success

object[]

success

boolean

Example: true

Redeem a Binance Gift Card

This API is for redeeming a Binance Gift Card. Once redeemed, the coins will be deposited in your funding wallet.

POST

/sapi/v1/giftcard/redeemCode

https://api.binance.com

Redeem a Binance Gift Card › Authorization

This is a signed endpoint and a signature must be included in the request parameters.Learn more about how to generate a valid signature in the Endpoint Security Type

Redeem a Binance Gift Card › Request Weight

This endpoint consumes IP-based request weight. Heavier endpoints consume more of your IP rate limit capacity.

Learn more in the Rate limits section.

IP Weight1

Redeem a Binance Gift Card › Headers

X-MBX-APIKEY

string · required

An API Key is required to access this endpoint and must be included in the request headers. To create an API Key, refer to: https://www.binance.com/en/support/faq/detail/360002502072.

Example: API_KEY

Redeem a Binance Gift Card › Request Body

code

string · required

Redemption code of Binance Gift Card to be redeemed, supports both Plaintext & Encrypted code.

Example: 6H9EKF5ECCWFBHGE

timestamp

integer · int64 · required

Unix timestamp in milliseconds used to sign the request. The value must reflect the current client time and is validated by the server for signed endpoints.

Example: 1770736694138

externalUid

string · maxLength: 400

Example: user-123

recvWindow

integer · int64 · max: 60000

Example: 5000

Redeem a Binance Gift Card › Responses

200

Redeem a Binance Gift Card

code

string

Example: 000000

message

string

Example: success

object

success

boolean

Example: true

Verify Binance Gift Card by Gift Card Number

This API is for verifying whether the Binance Gift Card is valid or not by entering Gift Card Number.

Please note that if you enter the wrong Gift Card Number 5 times within an hour, you will no longer be able to verify any Gift Card Number for that hour.

GET

/sapi/v1/giftcard/verify

https://api.binance.com

Verify Binance Gift Card by Gift Card Number › Authorization

This is a signed endpoint and a signature must be included in the request parameters.Learn more about how to generate a valid signature in the Endpoint Security Type

Verify Binance Gift Card by Gift Card Number › Request Weight

This endpoint consumes IP-based request weight. Heavier endpoints consume more of your IP rate limit capacity.

Learn more in the Rate limits section.

IP Weight1

Verify Binance Gift Card by Gift Card Number › Headers

X-MBX-APIKEY

string · required

An API Key is required to access this endpoint and must be included in the request headers. To create an API Key, refer to: https://www.binance.com/en/support/faq/detail/360002502072.

Example: API_KEY

Verify Binance Gift Card by Gift Card Number › Query Parameters

referenceNo

string · required

Enter the Gift Card Number

Example: 0033002328060227

timestamp

integer · int64 · required

Unix timestamp in milliseconds used to sign the request. The value must reflect the current client time and is validated by the server for signed endpoints.

Example: 1770736694138

recvWindow

integer · int64 · max: 60000

Example: 5000

Verify Binance Gift Card by Gift Card Number › Responses

200

Verify Binance Gift Card by Gift Card Number

code

string

Example: 000000

message

string

Example: success

object

success

boolean

Example: true