Card Gift Endpoints

Create a Binance Code (USER_DATA)

gift_card_create_code(self, token: str, amount: float, **kwargs)

Create a Binance Code (USER_DATA)

POST /sapi/v1/giftcard/createCode

This API is for creating a Binance Code. To get started with, please make sure:

You have a sufﬁcient balance in your Binance funding wallet
You need Enable Withdrawals for the API Key which requests this endpoint.

https://developers.binance.com/docs/gift_card/market-data/Create-a-single-token-gift-card

Parameters:

token (str) – The coin type contained in the Binance Code
amount (float) – The amount of the coin

Keyword Arguments:

recvWindow (int, optional) – The value cannot be greater than 60000

Redeem a Binance Code (USER_DATA)

gift_card_redeem_code(self, code: str, **kwargs)

Redeem a Binance Code (USER_DATA)

POST /sapi/v1/giftcard/redeemCode

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

Please note that if you enter the wrong code 5 times within 24 hours, you will no longer be able to redeem any Binance Code that day.

https://developers.binance.com/docs/gift_card/market-data/Redeem-a-Binance-Gift-Card

Parameters:

code (str) – Binance Code

Keyword Arguments:

externalUid (str, optional) – 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 codes on your platform. To protect user data privacy, you may choose to transfer the user id in any desired format (max. 400 characters).
recvWindow (int, optional) – The value cannot be greater than 60000

Verify a Binance Code (USER_DATA)

gift_card_verify_code(self, referenceNo: str, **kwargs)

Verify a Binance Code (USER_DATA)

GET /sapi/v1/giftcard/verify

This API is for verifying whether the Binance Code is valid or not by entering Binance Code or reference number.

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

https://developers.binance.com/docs/gift_card/market-data/Verify-Binance-Gift-Card-by-Gift-Card-Number

Parameters:: referenceNo (str) – reference number
Keyword Arguments:: recvWindow (int, optional) – The value cannot be greater than 60000

Gift Card RSA Public Key (USER_DATA)

gift_card_rsa_public_key(self, **kwargs)

Fetch RSA Public Key (USER_DATA)

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.

Weight(IP): 1

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

https://developers.binance.com/docs/gift_card/market-data/Fetch-RSA-Public-Key

Keyword Arguments:: recvWindow (int, optional) – The value cannot be greater than 60000

Create a dual-token gift card (USER_DATA)

gift_card_buy_code(self, baseToken: str, faceToken: str, baseTokenAmount: float, **kwargs)

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

POST /sapi/v1/giftcard/buyCode

https://developers.binance.com/docs/gift_card/market-data/Create-a-dual-token-gift-card

Parameters:

baseToken (str) – The coin type used to buy the Binance Code
faceToken (str) – The coin type contained in the Binance Code
baseTokenAmount (float) – The amount of the coin used to buy the Binance Code

Keyword Arguments:

discount (float, optional) – The discount rate of the Binance Code
recvWindow (int, optional) – The value cannot be greater than 60000

Fetch Token Limit (USER_DATA)

gift_card_token_limit(self, baseToken: str, **kwargs)

Get the limit of a token (TRADE)

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

https://developers.binance.com/docs/gift_card/market-data/Fetch-Token-Limit

Parameters:: baseToken (str) – The coin type used to buy the Binance Code
Keyword Arguments:: recvWindow (int, optional) – The value cannot be greater than 60000