@binance/giftcard 4.1.17 → 5.0.1

package/README.md

@@ -176,6 +176,19 @@ Please ensure that all tests pass if you're making a direct contribution. Submit
 
 Thank you for your contributions!
 
+## Disclaimer
+
+This SDK is provided by Binance on an "as is" and "as available" basis for use at your own risk. Binance makes no representations or warranties of any kind, whether express or implied, as to the operation of the SDK, its accuracy, reliability, completeness, or fitness for any particular purpose.
+
+To the fullest extent permitted by law, Binance shall not be liable for any losses, damages, or expenses of any kind arising from or in connection with your use of, or inability to use, this SDK, including but not limited to any financial losses resulting from errors, bugs, interruptions, or inaccuracies in the SDK.
+
+Your use of this SDK to access the Binance Platform is subject to the Binance API Key Terms and the Binance Terms of Use, which shall prevail in the event of any conflict with this disclaimer. You are solely responsible for any orders or transactions executed through the Binance Platform using this SDK.
+
+This SDK is not intended to constitute investment advice or a recommendation to buy, sell, or hold any digital asset. You should independently evaluate and verify all information before acting.
+
+- [Binance Terms of Use](https://www.binance.com/en/terms)
+- [Binance API Key Terms](https://www.binance.com/en/about-legal/terms-binance-api)
+
 ## Licence
 
 This project is licensed under the MIT License. See the [LICENCE](./LICENCE) file for details.

package/dist/index.d.mts

@@ -3,9 +3,9 @@ import { BadRequestError, ConfigurationRestAPI, ConnectorClientError, ForbiddenE
 //#region src/rest-api/types/create-adual-token-gift-card-response-data.d.ts
 
 /**
- * Binance Gift Card REST API
+ * Gift Card REST API
  *
- * OpenAPI Specification for the Binance Gift Card REST API
+ * Create, redeem, and check the value of Binance crypto gift cards.
  *
  * The version of the OpenAPI document: 1.0.0
  *
@@ -110,9 +110,9 @@ interface CreateASingleTokenGiftCardResponse {
 //#endregion
 //#region src/rest-api/types/fetch-rsa-public-key-response.d.ts
 /**
- * Binance Gift Card REST API
+ * Gift Card REST API
  *
- * OpenAPI Specification for the Binance Gift Card REST API
+ * Create, redeem, and check the value of Binance crypto gift cards.
  *
  * The version of the OpenAPI document: 1.0.0
  *
@@ -155,9 +155,9 @@ interface FetchRsaPublicKeyResponse {
 //#endregion
 //#region src/rest-api/types/fetch-token-limit-response-data-inner.d.ts
 /**
- * Binance Gift Card REST API
+ * Gift Card REST API
  *
- * OpenAPI Specification for the Binance Gift Card REST API
+ * Create, redeem, and check the value of Binance crypto gift cards.
  *
  * The version of the OpenAPI document: 1.0.0
  *
@@ -227,9 +227,9 @@ interface FetchTokenLimitResponse {
 //#endregion
 //#region src/rest-api/types/redeem-abinance-gift-card-response-data.d.ts
 /**
- * Binance Gift Card REST API
+ * Gift Card REST API
  *
- * OpenAPI Specification for the Binance Gift Card REST API
+ * Create, redeem, and check the value of Binance crypto gift cards.
  *
  * The version of the OpenAPI document: 1.0.0
  *
@@ -305,9 +305,9 @@ interface RedeemABinanceGiftCardResponse {
 //#endregion
 //#region src/rest-api/types/verify-binance-gift-card-by-gift-card-number-response-data.d.ts
 /**
- * Binance Gift Card REST API
+ * Gift Card REST API
  *
- * OpenAPI Specification for the Binance Gift Card REST API
+ * Create, redeem, and check the value of Binance crypto gift cards.
  *
  * The version of the OpenAPI document: 1.0.0
  *
@@ -382,19 +382,24 @@ interface VerifyBinanceGiftCardByGiftCardNumberResponse {
  */
 interface MarketDataApiInterface {
   /**
-   * * 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.
-   *
+   * * 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 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.
    *
-   * Weight: 1
+   * Weight(IP): 1
+   *
+   * Security Type: TRADE
    *
-   * @summary Create a dual-token gift card(fixed value, discount feature)(TRADE)
+   * @summary Create a dual-token gift card (fixed value, discount feature) (TRADE)
    * @param {CreateADualTokenGiftCardRequest} requestParameters Request parameters.
    *
    * @throws {RequiredError | ConnectorClientError | UnauthorizedError | ForbiddenError | TooManyRequestsError | RateLimitBanError | ServerError | NotFoundError | NetworkError | BadRequestError}
@@ -405,13 +410,14 @@ interface MarketDataApiInterface {
    * 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 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.
    *
-   * Weight: 1
+   * Weight(IP): 1
+   *
+   * Security Type: USER_DATA
    *
    * @summary Create a single-token gift card (USER_DATA)
    * @param {CreateASingleTokenGiftCardRequest} requestParameters Request parameters.
@@ -426,9 +432,11 @@ interface MarketDataApiInterface {
    *
    **Please note that the RSA Public key fetched is valid only for the current day.**
    *
-   * Weight: 1
+   * Weight(IP): 1
+   *
+   * Security Type: USER_DATA
    *
-   * @summary Fetch RSA Public Key(USER_DATA)
+   * @summary Fetch RSA Public Key (USER_DATA)
    * @param {FetchRsaPublicKeyRequest} requestParameters Request parameters.
    *
    * @throws {RequiredError | ConnectorClientError | UnauthorizedError | ForbiddenError | TooManyRequestsError | RateLimitBanError | ServerError | NotFoundError | NetworkError | BadRequestError}
@@ -436,11 +444,14 @@ interface MarketDataApiInterface {
    */
   fetchRsaPublicKey(requestParameters?: FetchRsaPublicKeyRequest): Promise<RestApiResponse<FetchRsaPublicKeyResponse>>;
   /**
-   * 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.
+   * 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.
+   *
+   * Weight(IP): 1
    *
-   * Weight: 1
+   * Security Type: USER_DATA
    *
-   * @summary Fetch Token Limit(USER_DATA)
+   * @summary Fetch Token Limit (USER_DATA)
    * @param {FetchTokenLimitRequest} requestParameters Request parameters.
    *
    * @throws {RequiredError | ConnectorClientError | UnauthorizedError | ForbiddenError | TooManyRequestsError | RateLimitBanError | ServerError | NotFoundError | NetworkError | BadRequestError}
@@ -448,21 +459,21 @@ interface MarketDataApiInterface {
    */
   fetchTokenLimit(requestParameters: FetchTokenLimitRequest): Promise<RestApiResponse<FetchTokenLimitResponse>>;
   /**
-   * This API is for redeeming a Binance Gift Card
-   * Once redeemed, the coins will be deposited in your funding wallet.
+   * This API is for redeeming a Binance Gift Card. Once redeemed, the coins will be deposited in your funding wallet.
    *
-   * Parameter code can be sent in two formats:
-   * Plaintext
-   * Encrypted
+   * Weight(IP): 1
    *
-   * Sending code in Encrypted format provides more security than sending it as a plaintext. To send card code in encrypted format the following steps must be followed:
-   * Fetch RSA public key from api stated below.
-   * Use the below algorithm to encrypt the card code using the RSA public key fetched above: `RSA/ECB/OAEPWithSHA-256AndMGF1Padding`
-   **A sample code snippet (JAVA) is stated below for reference, the same approach can be used for different languages like C#, PERL, PYTHON, SHELL etc.:**
+   * Security Type: USER_DATA
    *
-   * Weight: 1
+   * Notes:
+   * - Parameter `code` can be sent in two formats: `Plaintext` and `Encrypted`.
+   * - Sending `code` in encrypted format is more secure than plaintext.
+   * - To send encrypted `code`:
+   * - Fetch RSA public key from `GET /sapi/v1/giftcard/cryptography/rsa-public-key`.
+   * - Encrypt card code using `RSA/ECB/OAEPWithSHA-256AndMGF1Padding`.
+   * - If you enter the wrong redemption code 5 times within 24 hours, you will no longer be able to redeem any Binance Gift Cards that day.
    *
-   * @summary Redeem a Binance Gift Card(USER_DATA)
+   * @summary Redeem a Binance Gift Card (USER_DATA)
    * @param {RedeemABinanceGiftCardRequest} requestParameters Request parameters.
    *
    * @throws {RequiredError | ConnectorClientError | UnauthorizedError | ForbiddenError | TooManyRequestsError | RateLimitBanError | ServerError | NotFoundError | NetworkError | BadRequestError}
@@ -472,11 +483,14 @@ interface MarketDataApiInterface {
   /**
    * 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.**
+   **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.**
    *
-   * Weight: 1
+   * Weight(IP): 1
    *
-   * @summary Verify Binance Gift Card by Gift Card Number(USER_DATA)
+   * Security Type: USER_DATA
+   *
+   * @summary Verify Binance Gift Card by Gift Card Number (USER_DATA)
    * @param {VerifyBinanceGiftCardByGiftCardNumberRequest} requestParameters Request parameters.
    *
    * @throws {RequiredError | ConnectorClientError | UnauthorizedError | ForbiddenError | TooManyRequestsError | RateLimitBanError | ServerError | NotFoundError | NetworkError | BadRequestError}
@@ -496,7 +510,8 @@ interface CreateADualTokenGiftCardRequest {
    */
   readonly baseToken: string;
   /**
-   * The token you want to buy, example: BNB. If faceToken = baseToken, it's the same as createCode endpoint.
+   * The token you want to buy, example: BNB. If faceToken = baseToken, it's the same as createCode
+   * endpoint.
    * @type {string}
    * @memberof MarketDataApiCreateADualTokenGiftCard
    */
@@ -580,7 +595,14 @@ interface RedeemABinanceGiftCardRequest {
    */
   readonly code: string;
   /**
-   * 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).
+   * 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).
    * @type {string}
    * @memberof MarketDataApiRedeemABinanceGiftCard
    */
@@ -619,44 +641,50 @@ declare class MarketDataApi implements MarketDataApiInterface {
   private localVarAxiosParamCreator;
   constructor(configuration: ConfigurationRestAPI);
   /**
-   * * 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.
-   *
+   * * 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 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.
    *
-   * Weight: 1
+   * Weight(IP): 1
+   *
+   * Security Type: TRADE
    *
-   * @summary Create a dual-token gift card(fixed value, discount feature)(TRADE)
+   * @summary Create a dual-token gift card (fixed value, discount feature) (TRADE)
    * @param {CreateADualTokenGiftCardRequest} requestParameters Request parameters.
    * @returns {Promise<RestApiResponse<CreateADualTokenGiftCardResponse>>}
    * @throws {RequiredError | ConnectorClientError | UnauthorizedError | ForbiddenError | TooManyRequestsError | RateLimitBanError | ServerError | NotFoundError | NetworkError | BadRequestError}
    * @memberof MarketDataApi
-   * @see {@link https://developers.binance.com/docs/gift_card/market-data/Create-a-dual-token-gift-card Binance API Documentation}
+   * @see {@link https://developers.binance.com/en/docs/catalog/investment-and-services-gift-card/api/rest-api/market-data#create-adual-token-gift-card Binance API Documentation}
    */
   createADualTokenGiftCard(requestParameters: CreateADualTokenGiftCardRequest): Promise<RestApiResponse<CreateADualTokenGiftCardResponse>>;
   /**
    * 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 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.
    *
-   * Weight: 1
+   * Weight(IP): 1
+   *
+   * Security Type: USER_DATA
    *
    * @summary Create a single-token gift card (USER_DATA)
    * @param {CreateASingleTokenGiftCardRequest} requestParameters Request parameters.
    * @returns {Promise<RestApiResponse<CreateASingleTokenGiftCardResponse>>}
    * @throws {RequiredError | ConnectorClientError | UnauthorizedError | ForbiddenError | TooManyRequestsError | RateLimitBanError | ServerError | NotFoundError | NetworkError | BadRequestError}
    * @memberof MarketDataApi
-   * @see {@link https://developers.binance.com/docs/gift_card/market-data/Create-a-single-token-gift-card Binance API Documentation}
+   * @see {@link https://developers.binance.com/en/docs/catalog/investment-and-services-gift-card/api/rest-api/market-data#create-asingle-token-gift-card Binance API Documentation}
    */
   createASingleTokenGiftCard(requestParameters: CreateASingleTokenGiftCardRequest): Promise<RestApiResponse<CreateASingleTokenGiftCardResponse>>;
   /**
@@ -665,65 +693,73 @@ declare class MarketDataApi implements MarketDataApiInterface {
    *
    **Please note that the RSA Public key fetched is valid only for the current day.**
    *
-   * Weight: 1
+   * Weight(IP): 1
    *
-   * @summary Fetch RSA Public Key(USER_DATA)
+   * Security Type: USER_DATA
+   *
+   * @summary Fetch RSA Public Key (USER_DATA)
    * @param {FetchRsaPublicKeyRequest} requestParameters Request parameters.
    * @returns {Promise<RestApiResponse<FetchRsaPublicKeyResponse>>}
    * @throws {RequiredError | ConnectorClientError | UnauthorizedError | ForbiddenError | TooManyRequestsError | RateLimitBanError | ServerError | NotFoundError | NetworkError | BadRequestError}
    * @memberof MarketDataApi
-   * @see {@link https://developers.binance.com/docs/gift_card/market-data/Fetch-RSA-Public-Key Binance API Documentation}
+   * @see {@link https://developers.binance.com/en/docs/catalog/investment-and-services-gift-card/api/rest-api/market-data#fetch-rsa-public-key Binance API Documentation}
    */
   fetchRsaPublicKey(requestParameters?: FetchRsaPublicKeyRequest): Promise<RestApiResponse<FetchRsaPublicKeyResponse>>;
   /**
-   * 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.
+   * 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.
+   *
+   * Weight(IP): 1
    *
-   * Weight: 1
+   * Security Type: USER_DATA
    *
-   * @summary Fetch Token Limit(USER_DATA)
+   * @summary Fetch Token Limit (USER_DATA)
    * @param {FetchTokenLimitRequest} requestParameters Request parameters.
    * @returns {Promise<RestApiResponse<FetchTokenLimitResponse>>}
    * @throws {RequiredError | ConnectorClientError | UnauthorizedError | ForbiddenError | TooManyRequestsError | RateLimitBanError | ServerError | NotFoundError | NetworkError | BadRequestError}
    * @memberof MarketDataApi
-   * @see {@link https://developers.binance.com/docs/gift_card/market-data/Fetch-Token-Limit Binance API Documentation}
+   * @see {@link https://developers.binance.com/en/docs/catalog/investment-and-services-gift-card/api/rest-api/market-data#fetch-token-limit Binance API Documentation}
    */
   fetchTokenLimit(requestParameters: FetchTokenLimitRequest): Promise<RestApiResponse<FetchTokenLimitResponse>>;
   /**
-   * This API is for redeeming a Binance Gift Card
-   * Once redeemed, the coins will be deposited in your funding wallet.
+   * This API is for redeeming a Binance Gift Card. Once redeemed, the coins will be deposited in your funding wallet.
    *
-   * Parameter code can be sent in two formats:
-   * Plaintext
-   * Encrypted
+   * Weight(IP): 1
    *
-   * Sending code in Encrypted format provides more security than sending it as a plaintext. To send card code in encrypted format the following steps must be followed:
-   * Fetch RSA public key from api stated below.
-   * Use the below algorithm to encrypt the card code using the RSA public key fetched above: `RSA/ECB/OAEPWithSHA-256AndMGF1Padding`
-   **A sample code snippet (JAVA) is stated below for reference, the same approach can be used for different languages like C#, PERL, PYTHON, SHELL etc.:**
+   * Security Type: USER_DATA
    *
-   * Weight: 1
+   * Notes:
+   * - Parameter `code` can be sent in two formats: `Plaintext` and `Encrypted`.
+   * - Sending `code` in encrypted format is more secure than plaintext.
+   * - To send encrypted `code`:
+   * - Fetch RSA public key from `GET /sapi/v1/giftcard/cryptography/rsa-public-key`.
+   * - Encrypt card code using `RSA/ECB/OAEPWithSHA-256AndMGF1Padding`.
+   * - If you enter the wrong redemption code 5 times within 24 hours, you will no longer be able to redeem any Binance Gift Cards that day.
    *
-   * @summary Redeem a Binance Gift Card(USER_DATA)
+   * @summary Redeem a Binance Gift Card (USER_DATA)
    * @param {RedeemABinanceGiftCardRequest} requestParameters Request parameters.
    * @returns {Promise<RestApiResponse<RedeemABinanceGiftCardResponse>>}
    * @throws {RequiredError | ConnectorClientError | UnauthorizedError | ForbiddenError | TooManyRequestsError | RateLimitBanError | ServerError | NotFoundError | NetworkError | BadRequestError}
    * @memberof MarketDataApi
-   * @see {@link https://developers.binance.com/docs/gift_card/market-data/Redeem-a-Binance-Gift-Card Binance API Documentation}
+   * @see {@link https://developers.binance.com/en/docs/catalog/investment-and-services-gift-card/api/rest-api/market-data#redeem-abinance-gift-card Binance API Documentation}
    */
   redeemABinanceGiftCard(requestParameters: RedeemABinanceGiftCardRequest): Promise<RestApiResponse<RedeemABinanceGiftCardResponse>>;
   /**
    * 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.**
+   **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.**
+   *
+   * Weight(IP): 1
    *
-   * Weight: 1
+   * Security Type: USER_DATA
    *
-   * @summary Verify Binance Gift Card by Gift Card Number(USER_DATA)
+   * @summary Verify Binance Gift Card by Gift Card Number (USER_DATA)
    * @param {VerifyBinanceGiftCardByGiftCardNumberRequest} requestParameters Request parameters.
    * @returns {Promise<RestApiResponse<VerifyBinanceGiftCardByGiftCardNumberResponse>>}
    * @throws {RequiredError | ConnectorClientError | UnauthorizedError | ForbiddenError | TooManyRequestsError | RateLimitBanError | ServerError | NotFoundError | NetworkError | BadRequestError}
    * @memberof MarketDataApi
-   * @see {@link https://developers.binance.com/docs/gift_card/market-data/Verify-Binance-Gift-Card-by-Gift-Card-Number Binance API Documentation}
+   * @see {@link https://developers.binance.com/en/docs/catalog/investment-and-services-gift-card/api/rest-api/market-data#verify-binance-gift-card-by-gift-card-number Binance API Documentation}
    */
   verifyBinanceGiftCardByGiftCardNumber(requestParameters: VerifyBinanceGiftCardByGiftCardNumberRequest): Promise<RestApiResponse<VerifyBinanceGiftCardByGiftCardNumberResponse>>;
 }
@@ -754,44 +790,50 @@ declare class RestAPI {
    */
   sendSignedRequest<T>(endpoint: string, method: 'GET' | 'POST' | 'DELETE' | 'PUT' | 'PATCH', queryParams?: Record<string, unknown>, bodyParams?: Record<string, unknown>): Promise<RestApiResponse<T>>;
   /**
-   * * 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.
-   *
+   * * 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 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.
    *
-   * Weight: 1
+   * Weight(IP): 1
+   *
+   * Security Type: TRADE
    *
-   * @summary Create a dual-token gift card(fixed value, discount feature)(TRADE)
+   * @summary Create a dual-token gift card (fixed value, discount feature) (TRADE)
    * @param {CreateADualTokenGiftCardRequest} requestParameters Request parameters.
    *
    * @returns {Promise<RestApiResponse<CreateADualTokenGiftCardResponse>>}
    * @throws {RequiredError | ConnectorClientError | UnauthorizedError | ForbiddenError | TooManyRequestsError | RateLimitBanError | ServerError | NotFoundError | NetworkError | BadRequestError}
-   * @see {@link https://developers.binance.com/docs/gift_card/market-data/Create-a-dual-token-gift-card Binance API Documentation}
+   * @see {@link https://developers.binance.com/en/docs/catalog/investment-and-services-gift-card/api/rest-api/market-data#create-adual-token-gift-card Binance API Documentation}
    */
   createADualTokenGiftCard(requestParameters: CreateADualTokenGiftCardRequest): Promise<RestApiResponse<CreateADualTokenGiftCardResponse>>;
   /**
    * 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 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.
    *
-   * Weight: 1
+   * Weight(IP): 1
+   *
+   * Security Type: USER_DATA
    *
    * @summary Create a single-token gift card (USER_DATA)
    * @param {CreateASingleTokenGiftCardRequest} requestParameters Request parameters.
    *
    * @returns {Promise<RestApiResponse<CreateASingleTokenGiftCardResponse>>}
    * @throws {RequiredError | ConnectorClientError | UnauthorizedError | ForbiddenError | TooManyRequestsError | RateLimitBanError | ServerError | NotFoundError | NetworkError | BadRequestError}
-   * @see {@link https://developers.binance.com/docs/gift_card/market-data/Create-a-single-token-gift-card Binance API Documentation}
+   * @see {@link https://developers.binance.com/en/docs/catalog/investment-and-services-gift-card/api/rest-api/market-data#create-asingle-token-gift-card Binance API Documentation}
    */
   createASingleTokenGiftCard(requestParameters: CreateASingleTokenGiftCardRequest): Promise<RestApiResponse<CreateASingleTokenGiftCardResponse>>;
   /**
@@ -800,65 +842,73 @@ declare class RestAPI {
    *
    **Please note that the RSA Public key fetched is valid only for the current day.**
    *
-   * Weight: 1
+   * Weight(IP): 1
+   *
+   * Security Type: USER_DATA
    *
-   * @summary Fetch RSA Public Key(USER_DATA)
+   * @summary Fetch RSA Public Key (USER_DATA)
    * @param {FetchRsaPublicKeyRequest} requestParameters Request parameters.
    *
    * @returns {Promise<RestApiResponse<FetchRsaPublicKeyResponse>>}
    * @throws {RequiredError | ConnectorClientError | UnauthorizedError | ForbiddenError | TooManyRequestsError | RateLimitBanError | ServerError | NotFoundError | NetworkError | BadRequestError}
-   * @see {@link https://developers.binance.com/docs/gift_card/market-data/Fetch-RSA-Public-Key Binance API Documentation}
+   * @see {@link https://developers.binance.com/en/docs/catalog/investment-and-services-gift-card/api/rest-api/market-data#fetch-rsa-public-key Binance API Documentation}
    */
   fetchRsaPublicKey(requestParameters?: FetchRsaPublicKeyRequest): Promise<RestApiResponse<FetchRsaPublicKeyResponse>>;
   /**
-   * 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.
+   * 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.
    *
-   * Weight: 1
+   * Weight(IP): 1
    *
-   * @summary Fetch Token Limit(USER_DATA)
+   * Security Type: USER_DATA
+   *
+   * @summary Fetch Token Limit (USER_DATA)
    * @param {FetchTokenLimitRequest} requestParameters Request parameters.
    *
    * @returns {Promise<RestApiResponse<FetchTokenLimitResponse>>}
    * @throws {RequiredError | ConnectorClientError | UnauthorizedError | ForbiddenError | TooManyRequestsError | RateLimitBanError | ServerError | NotFoundError | NetworkError | BadRequestError}
-   * @see {@link https://developers.binance.com/docs/gift_card/market-data/Fetch-Token-Limit Binance API Documentation}
+   * @see {@link https://developers.binance.com/en/docs/catalog/investment-and-services-gift-card/api/rest-api/market-data#fetch-token-limit Binance API Documentation}
    */
   fetchTokenLimit(requestParameters: FetchTokenLimitRequest): Promise<RestApiResponse<FetchTokenLimitResponse>>;
   /**
-   * This API is for redeeming a Binance Gift Card
-   * Once redeemed, the coins will be deposited in your funding wallet.
+   * This API is for redeeming a Binance Gift Card. Once redeemed, the coins will be deposited in your funding wallet.
    *
-   * Parameter code can be sent in two formats:
-   * Plaintext
-   * Encrypted
+   * Weight(IP): 1
    *
-   * Sending code in Encrypted format provides more security than sending it as a plaintext. To send card code in encrypted format the following steps must be followed:
-   * Fetch RSA public key from api stated below.
-   * Use the below algorithm to encrypt the card code using the RSA public key fetched above: `RSA/ECB/OAEPWithSHA-256AndMGF1Padding`
-   **A sample code snippet (JAVA) is stated below for reference, the same approach can be used for different languages like C#, PERL, PYTHON, SHELL etc.:**
+   * Security Type: USER_DATA
    *
-   * Weight: 1
+   * Notes:
+   * - Parameter `code` can be sent in two formats: `Plaintext` and `Encrypted`.
+   * - Sending `code` in encrypted format is more secure than plaintext.
+   * - To send encrypted `code`:
+   * - Fetch RSA public key from `GET /sapi/v1/giftcard/cryptography/rsa-public-key`.
+   * - Encrypt card code using `RSA/ECB/OAEPWithSHA-256AndMGF1Padding`.
+   * - If you enter the wrong redemption code 5 times within 24 hours, you will no longer be able to redeem any Binance Gift Cards that day.
    *
-   * @summary Redeem a Binance Gift Card(USER_DATA)
+   * @summary Redeem a Binance Gift Card (USER_DATA)
    * @param {RedeemABinanceGiftCardRequest} requestParameters Request parameters.
    *
    * @returns {Promise<RestApiResponse<RedeemABinanceGiftCardResponse>>}
    * @throws {RequiredError | ConnectorClientError | UnauthorizedError | ForbiddenError | TooManyRequestsError | RateLimitBanError | ServerError | NotFoundError | NetworkError | BadRequestError}
-   * @see {@link https://developers.binance.com/docs/gift_card/market-data/Redeem-a-Binance-Gift-Card Binance API Documentation}
+   * @see {@link https://developers.binance.com/en/docs/catalog/investment-and-services-gift-card/api/rest-api/market-data#redeem-abinance-gift-card Binance API Documentation}
    */
   redeemABinanceGiftCard(requestParameters: RedeemABinanceGiftCardRequest): Promise<RestApiResponse<RedeemABinanceGiftCardResponse>>;
   /**
    * 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.**
+   **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.**
+   *
+   * Weight(IP): 1
    *
-   * Weight: 1
+   * Security Type: USER_DATA
    *
-   * @summary Verify Binance Gift Card by Gift Card Number(USER_DATA)
+   * @summary Verify Binance Gift Card by Gift Card Number (USER_DATA)
    * @param {VerifyBinanceGiftCardByGiftCardNumberRequest} requestParameters Request parameters.
    *
    * @returns {Promise<RestApiResponse<VerifyBinanceGiftCardByGiftCardNumberResponse>>}
    * @throws {RequiredError | ConnectorClientError | UnauthorizedError | ForbiddenError | TooManyRequestsError | RateLimitBanError | ServerError | NotFoundError | NetworkError | BadRequestError}
-   * @see {@link https://developers.binance.com/docs/gift_card/market-data/Verify-Binance-Gift-Card-by-Gift-Card-Number Binance API Documentation}
+   * @see {@link https://developers.binance.com/en/docs/catalog/investment-and-services-gift-card/api/rest-api/market-data#verify-binance-gift-card-by-gift-card-number Binance API Documentation}
    */
   verifyBinanceGiftCardByGiftCardNumber(requestParameters: VerifyBinanceGiftCardByGiftCardNumberRequest): Promise<RestApiResponse<VerifyBinanceGiftCardByGiftCardNumberResponse>>;
 }