openapi: 3.0.2
info:
  title: Gift Card REST API
  description: Create, redeem, and check the value of Binance crypto gift cards.
  x-description-cn: 创建、兑换并查询 Binance 加密货币礼品卡的面值。
  version: 1.0.0
  termsOfService: https://www.binance.com/en/terms
  contact:
    name: Binance API Support
    url: https://www.binance.com/en/support
x-product-type: rest-api
x-rate-limits-guide: products/gift-card/general-info#limits
x-rate-limits-guide-cn: products/gift-card/general-info#访问限制
x-security-guide: products/gift-card/general-info#request-security
x-security-guide-cn: products/gift-card/general-info#请求鉴权类型
x-api-key-guide: https://www.binance.com/en/support/faq/detail/360002502072
x-api-key-guide-cn: https://www.binance.com/cn/support/faq/detail/360002502072
externalDocs:
  description: Gift Card docs
  url: https://developers.binance.com/en/docs/products/gift-card/Introduction
tags:
  - name: market-data
    x-displayName: Market Data
    x-displayName-cn: 市场数据
servers:
  - url: https://api.binance.com
  - url: https://api-gcp.binance.com
  - url: https://api1.binance.com
  - url: https://api2.binance.com
  - url: https://api3.binance.com
  - url: https://api4.binance.com
paths:
  /sapi/v1/giftcard/buyCode:
    post:
      summary: Create a dual-token gift card (fixed value, discount feature)
      x-summary-cn: 创建双币种礼品卡(固定价值，设置折扣)
      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 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.
      x-description-cn: |-
        * 该API用于创建以双币种币安礼品卡，即以稳定币定值的非稳定币礼品卡。您可以通过USDT作为礼品卡的定值币种(baseToken)，来创建可兑现至其他不同币种（faceToken）的币安礼品卡。比如创建固定价值为100
        USDT的BTC礼品卡，用USDT制卡，未兑现前始终保持100 USDT的价值，最终兑现出来的是100 USDT等值的BTC。

        * 创建后，定值币种(baseToken, 比如USDT)相应的金额和手续费将从你的资金账户中被扣除。
          * 要开始使用，请确保：
          * 你有一个币安账户
          * 你已通过了 KYB
          * 币安资金账户中有足够的余额（礼品卡金额和手续费金额）
          * 你的API Key需要开启允许提现权限
      tags:
        - market-data
      operationId: createADualTokenGiftCard
      externalDocs:
        url: >-
          https://developers.binance.com/en/docs/catalog/investment-and-services-gift-card/api/rest-api/market-data#create-adual-token-gift-card
      x-connectors-examples:
        ts: >-
          https://raw.githubusercontent.com/binance/binance-connector-js/master/clients/gift-card/examples/rest-api/MarketDataApi/createADualTokenGiftCard.ts
        rust: >-
          https://raw.githubusercontent.com/binance/binance-connector-rust/main/examples/gift_card/rest_api/market_data_api/create_a_dual_token_gift_card.rs
        python: >-
          https://raw.githubusercontent.com/binance/binance-connector-python/master/clients/gift_card/examples/rest_api/MarketData/create_a_dual_token_gift_card.py
        java: >-
          https://raw.githubusercontent.com/binance/binance-connector-java/master/examples/gift-card/src/main/java/com/binance/connector/client/gift_card/rest/marketdata/CreateADualTokenGiftCardExample.java
        go: >-
          https://raw.githubusercontent.com/binance/binance-connector-go/main/clients/giftcard/examples/restapi/MarketDataAPI/CreateADualTokenGiftCard/CreateADualTokenGiftCard.go
        php: >-
          https://raw.githubusercontent.com/binance/binance-connector-php/master/examples/gift-card/marketdata/CreateADualTokenGiftCardExample.php
      x-ip-weight: 1
      x-security-type: TRADE
      x-signed: true
      parameters:
        - name: X-MBX-APIKEY
          in: header
          required: true
          description: >-
            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.
          x-description-cn: 访问此接口需要 API Key，并且必须在请求头中携带。关于如何创建 API Key，请参考：https://www.binance.com/cn/support/faq/detail/360002502072。
          schema:
            type: string
            example: API_KEY
      requestBody:
        required: true
        content:
          application/x-www-form-urlencoded:
            schema:
              type: object
              required:
                - baseToken
                - faceToken
                - baseTokenAmount
                - timestamp
              properties:
                baseToken:
                  type: string
                  example: BUSD
                  description: "The token you want to pay, example: BUSD"
                  x-description-cn: 你用来支付的货币，例如：BUSD
                faceToken:
                  type: string
                  example: BNB
                  description: |-
                    The token you want to buy, example: BNB. If faceToken = baseToken, it's the same as createCode
                    endpoint.
                  x-description-cn: 你要创建的礼品卡面额币种，例如：BNB。若 `faceToken = baseToken`，则与 `createCode` 接口效果相同。
                baseTokenAmount:
                  type: number
                  example: 1
                  format: float
                  description: "The base token asset quantity, example : 1.002"
                  x-description-cn: 支付的货币数量，例如：1.002
                recvWindow:
                  type: integer
                  example: 5000
                  format: int64
                  maximum: 60000
                timestamp:
                  type: integer
                  example: 1770736694138
                  format: int64
                  description: |-
                    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.
                  x-description-cn: 用于请求签名的 Unix 时间戳，单位为毫秒. 该值必须反映客户端当前时间，并会在签名接口中由服务器进行校验.
      responses:
        "200":
          description: Create a dual-token gift card
          x-description-cn: 创建双币种礼品卡
          content:
            application/json:
              schema:
                type: object
                properties:
                  code:
                    type: string
                    example: "000000"
                  message:
                    type: string
                    example: success
                  data:
                    type: object
                    properties:
                      referenceNo:
                        type: string
                        example: "0033002144060553"
                      code:
                        type: string
                        example: 6H9EKF5ECCWFBHGE
                      expiredTime:
                        type: integer
                        example: 1727417154000
                        format: int64
                  success:
                    type: boolean
                    example: true
  /sapi/v1/giftcard/createCode:
    post:
      summary: Create a single-token gift card
      x-summary-cn: 创建单币种礼品卡
      description: |-
        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.
      x-description-cn: |-
        该接口用于创建币安礼品卡。

        使用前请确保：
          * 您已拥有币安账户
          * 您已通过 KYB
          * 您的币安资金钱包中有足够余额（礼品卡金额与手续费）
          * 发起该请求的 API Key 已启用 `Enable Withdrawals` 权限。
      tags:
        - market-data
      operationId: createASingleTokenGiftCard
      externalDocs:
        url: >-
          https://developers.binance.com/en/docs/catalog/investment-and-services-gift-card/api/rest-api/market-data#create-asingle-token-gift-card
      x-connectors-examples:
        ts: >-
          https://raw.githubusercontent.com/binance/binance-connector-js/master/clients/gift-card/examples/rest-api/MarketDataApi/createASingleTokenGiftCard.ts
        rust: >-
          https://raw.githubusercontent.com/binance/binance-connector-rust/main/examples/gift_card/rest_api/market_data_api/create_a_single_token_gift_card.rs
        python: >-
          https://raw.githubusercontent.com/binance/binance-connector-python/master/clients/gift_card/examples/rest_api/MarketData/create_a_single_token_gift_card.py
        java: >-
          https://raw.githubusercontent.com/binance/binance-connector-java/master/examples/gift-card/src/main/java/com/binance/connector/client/gift_card/rest/marketdata/CreateASingleTokenGiftCardExample.java
        go: >-
          https://raw.githubusercontent.com/binance/binance-connector-go/main/clients/giftcard/examples/restapi/MarketDataAPI/CreateASingleTokenGiftCard/CreateASingleTokenGiftCard.go
        php: >-
          https://raw.githubusercontent.com/binance/binance-connector-php/master/examples/gift-card/marketdata/CreateASingleTokenGiftCardExample.php
      x-ip-weight: 1
      x-security-type: USER_DATA
      x-signed: true
      parameters:
        - name: X-MBX-APIKEY
          in: header
          required: true
          description: >-
            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.
          x-description-cn: 访问此接口需要 API Key，并且必须在请求头中携带。关于如何创建 API Key，请参考：https://www.binance.com/cn/support/faq/detail/360002502072。
          schema:
            type: string
            example: API_KEY
      requestBody:
        required: true
        content:
          application/x-www-form-urlencoded:
            schema:
              type: object
              required:
                - token
                - amount
                - timestamp
              properties:
                token:
                  type: string
                  example: BNB
                  description: The token type contained in the Binance Gift Card
                  x-description-cn: 币安礼品卡中的数字货币币种
                amount:
                  type: number
                  example: 1
                  format: float
                  description: The amount of the token contained in the Binance Gift Card
                  x-description-cn: 币安礼品卡中的数字货币数量
                recvWindow:
                  type: integer
                  example: 5000
                  format: int64
                  maximum: 60000
                timestamp:
                  type: integer
                  example: 1770736694138
                  format: int64
                  description: |-
                    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.
                  x-description-cn: 用于请求签名的 Unix 时间戳，单位为毫秒. 该值必须反映客户端当前时间，并会在签名接口中由服务器进行校验.
      responses:
        "200":
          description: Create a single-token gift card
          x-description-cn: 创建单币种礼品卡
          content:
            application/json:
              schema:
                type: object
                properties:
                  code:
                    type: string
                    example: "000000"
                  message:
                    type: string
                    example: success
                  data:
                    type: object
                    properties:
                      referenceNo:
                        type: string
                        example: "0033002144060553"
                      code:
                        type: string
                        example: 6H9EKF5ECCWFBHGE
                      expiredTime:
                        type: integer
                        example: 1727417154000
                        format: int64
                  success:
                    type: boolean
                    example: true
  /sapi/v1/giftcard/cryptography/rsa-public-key:
    get:
      summary: Fetch RSA Public Key
      x-summary-cn: 获取 RSA 公钥
      description: |-
        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.**
      x-description-cn: |-
        此接口用于获取 RSA 公钥。
        该公钥可用于加密币安礼品卡兑换码。

        **请注意：获取的 RSA 公钥仅在当日有效。**
      tags:
        - market-data
      operationId: fetchRsaPublicKey
      externalDocs:
        url: >-
          https://developers.binance.com/en/docs/catalog/investment-and-services-gift-card/api/rest-api/market-data#fetch-rsa-public-key
      x-connectors-examples:
        ts: >-
          https://raw.githubusercontent.com/binance/binance-connector-js/master/clients/gift-card/examples/rest-api/MarketDataApi/fetchRsaPublicKey.ts
        rust: >-
          https://raw.githubusercontent.com/binance/binance-connector-rust/main/examples/gift_card/rest_api/market_data_api/fetch_rsa_public_key.rs
        python: >-
          https://raw.githubusercontent.com/binance/binance-connector-python/master/clients/gift_card/examples/rest_api/MarketData/fetch_rsa_public_key.py
        java: >-
          https://raw.githubusercontent.com/binance/binance-connector-java/master/examples/gift-card/src/main/java/com/binance/connector/client/gift_card/rest/marketdata/FetchRsaPublicKeyExample.java
        go: >-
          https://raw.githubusercontent.com/binance/binance-connector-go/main/clients/giftcard/examples/restapi/MarketDataAPI/FetchRsaPublicKey/FetchRsaPublicKey.go
        php: >-
          https://raw.githubusercontent.com/binance/binance-connector-php/master/examples/gift-card/marketdata/FetchRsaPublicKeyExample.php
      x-ip-weight: 1
      x-security-type: USER_DATA
      x-signed: true
      parameters:
        - name: X-MBX-APIKEY
          in: header
          required: true
          description: >-
            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.
          x-description-cn: 访问此接口需要 API Key，并且必须在请求头中携带。关于如何创建 API Key，请参考：https://www.binance.com/cn/support/faq/detail/360002502072。
          schema:
            type: string
            example: API_KEY
        - name: recvWindow
          in: query
          required: false
          schema:
            type: integer
            example: 5000
            format: int64
            maximum: 60000
        - name: timestamp
          in: query
          required: true
          schema:
            type: integer
            example: 1770736694138
            format: int64
          description: |-
            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.
          x-description-cn: 用于请求签名的 Unix 时间戳，单位为毫秒. 该值必须反映客户端当前时间，并会在签名接口中由服务器进行校验.
      responses:
        "200":
          description: Fetch RSA Public Key
          x-description-cn: 获取 RSA 公钥
          content:
            application/json:
              schema:
                type: object
                properties:
                  code:
                    type: string
                    example: "000000"
                  message:
                    type: string
                    example: success
                  data:
                    type: string
                    example: >-
                      MIGfMA0GCSqGSIb3DQEBAQUAA4GNADCBiQKBgQCXBBVKLAc1GQ5FsIFFqOHrPTox5noBONIKr+IAedTR9FkVxq6e65updEbfdhRNkMOeYIO2i0UylrjGC0X8YSoIszmrVHeV0l06Zh1oJuZos1+7N+WLuz9JvlPaawof3GUakTxYWWCa9+8KIbLKsoKMdfS96VT+8iOXO3quMGKUmQIDAQAB
                  success:
                    type: boolean
                    example: true
  /sapi/v1/giftcard/buyCode/token-limit:
    get:
      summary: Fetch Token Limit
      x-summary-cn: 获取货币使用限制
      description: |-
        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.
      x-description-cn: 此接口用于查看可用于创建稳定币定值礼品卡的币种及其限制。
      tags:
        - market-data
      operationId: fetchTokenLimit
      externalDocs:
        url: >-
          https://developers.binance.com/en/docs/catalog/investment-and-services-gift-card/api/rest-api/market-data#fetch-token-limit
      x-connectors-examples:
        ts: >-
          https://raw.githubusercontent.com/binance/binance-connector-js/master/clients/gift-card/examples/rest-api/MarketDataApi/fetchTokenLimit.ts
        rust: >-
          https://raw.githubusercontent.com/binance/binance-connector-rust/main/examples/gift_card/rest_api/market_data_api/fetch_token_limit.rs
        python: >-
          https://raw.githubusercontent.com/binance/binance-connector-python/master/clients/gift_card/examples/rest_api/MarketData/fetch_token_limit.py
        java: >-
          https://raw.githubusercontent.com/binance/binance-connector-java/master/examples/gift-card/src/main/java/com/binance/connector/client/gift_card/rest/marketdata/FetchTokenLimitExample.java
        go: >-
          https://raw.githubusercontent.com/binance/binance-connector-go/main/clients/giftcard/examples/restapi/MarketDataAPI/FetchTokenLimit/FetchTokenLimit.go
        php: >-
          https://raw.githubusercontent.com/binance/binance-connector-php/master/examples/gift-card/marketdata/FetchTokenLimitExample.php
      x-ip-weight: 1
      x-security-type: USER_DATA
      x-signed: true
      parameters:
        - name: X-MBX-APIKEY
          in: header
          required: true
          description: >-
            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.
          x-description-cn: 访问此接口需要 API Key，并且必须在请求头中携带。关于如何创建 API Key，请参考：https://www.binance.com/cn/support/faq/detail/360002502072。
          schema:
            type: string
            example: API_KEY
        - name: baseToken
          in: query
          required: true
          schema:
            type: string
            example: BUSD
          description: "The token you want to pay, example: BUSD"
          x-description-cn: 你用来支付的货币，例如：BUSD
        - name: recvWindow
          in: query
          required: false
          schema:
            type: integer
            example: 5000
            format: int64
            maximum: 60000
        - name: timestamp
          in: query
          required: true
          schema:
            type: integer
            example: 1770736694138
            format: int64
          description: |-
            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.
          x-description-cn: 用于请求签名的 Unix 时间戳，单位为毫秒. 该值必须反映客户端当前时间，并会在签名接口中由服务器进行校验.
      responses:
        "200":
          description: Fetch Token Limit
          x-description-cn: 获取币种限额
          content:
            application/json:
              schema:
                type: object
                properties:
                  code:
                    type: string
                    example: "000000"
                  message:
                    type: string
                    example: success
                  data:
                    type: array
                    items:
                      type: object
                      properties:
                        coin:
                          type: string
                          example: BNB
                        fromMin:
                          type: string
                          example: "0.01"
                        fromMax:
                          type: string
                          example: "1"
                  success:
                    type: boolean
                    example: true
  /sapi/v1/giftcard/redeemCode:
    post:
      summary: Redeem a Binance Gift Card
      x-summary-cn: 兑现币安礼品卡
      description: >-
        This API is for redeeming a Binance Gift Card. Once redeemed, the coins will be deposited in your funding
        wallet.
      x-description-cn: 该接口用于兑现币安礼品卡。兑现成功后，数字货币将存入您的资金钱包。
      tags:
        - market-data
      operationId: redeemABinanceGiftCard
      externalDocs:
        url: >-
          https://developers.binance.com/en/docs/catalog/investment-and-services-gift-card/api/rest-api/market-data#redeem-abinance-gift-card
      x-connectors-examples:
        ts: >-
          https://raw.githubusercontent.com/binance/binance-connector-js/master/clients/gift-card/examples/rest-api/MarketDataApi/redeemABinanceGiftCard.ts
        rust: >-
          https://raw.githubusercontent.com/binance/binance-connector-rust/main/examples/gift_card/rest_api/market_data_api/redeem_a_binance_gift_card.rs
        python: >-
          https://raw.githubusercontent.com/binance/binance-connector-python/master/clients/gift_card/examples/rest_api/MarketData/redeem_a_binance_gift_card.py
        java: >-
          https://raw.githubusercontent.com/binance/binance-connector-java/master/examples/gift-card/src/main/java/com/binance/connector/client/gift_card/rest/marketdata/RedeemABinanceGiftCardExample.java
        go: >-
          https://raw.githubusercontent.com/binance/binance-connector-go/main/clients/giftcard/examples/restapi/MarketDataAPI/RedeemABinanceGiftCard/RedeemABinanceGiftCard.go
        php: >-
          https://raw.githubusercontent.com/binance/binance-connector-php/master/examples/gift-card/marketdata/RedeemABinanceGiftCardExample.php
      x-ip-weight: 1
      x-security-type: USER_DATA
      x-signed: true
      parameters:
        - name: X-MBX-APIKEY
          in: header
          required: true
          description: >-
            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.
          x-description-cn: 访问此接口需要 API Key，并且必须在请求头中携带。关于如何创建 API Key，请参考：https://www.binance.com/cn/support/faq/detail/360002502072。
          schema:
            type: string
            example: API_KEY
      x-parameters-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.
      x-parameters-notes-cn: |-
        - 参数 `code` 支持两种格式：`Plaintext` 和 `Encrypted`。
        - 使用加密格式传输 `code` 比明文更安全。
        - 使用加密格式时：
        - 先调用 `GET /sapi/v1/giftcard/cryptography/rsa-public-key` 获取 RSA 公钥。
        - 使用 `RSA/ECB/OAEPWithSHA-256AndMGF1Padding` 对卡密加密。
        - 如果在 24 小时内输入错误的兑换码 5 次，当天将无法再兑换任何币安礼品卡。
      requestBody:
        required: true
        content:
          application/x-www-form-urlencoded:
            schema:
              type: object
              required:
                - code
                - timestamp
              properties:
                code:
                  type: string
                  example: 6H9EKF5ECCWFBHGE
                  description: Redemption code of Binance Gift Card to be redeemed, supports both Plaintext & Encrypted code.
                  x-description-cn: 用于赎回的币安礼品卡，支持加密&未加密两种方式
                externalUid:
                  type: string
                  example: user-123
                  maxLength: 400
                  description: |-
                    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).
                  x-description-cn: >-
                    每个外部用户 ID

                    代表合作伙伴平台上的某个用户。该功能帮助您识别不同用户的兑现行为，例如兑现频次和金额。它还有助于对单个账户进行风险和限额控制，例如设置单个账户每日兑现金额、频次和卡密输错次数的上限。这也将防止单个帐户突破合作伙伴的每日兑现限额从而导致合作伙伴的账户在当日无法继续制码或者兑现。如果您有外部的网站且有不同的用户在您的平台上兑现

                    币安礼品卡，我们强烈建议您使用此功能并将您用户的用户 ID 传输给我们来进行风控。为保护用户的信息安全，您可以选择以任何格式（上限为 400 个字符）传输用户 ID。
                recvWindow:
                  type: integer
                  example: 5000
                  format: int64
                  maximum: 60000
                timestamp:
                  type: integer
                  example: 1770736694138
                  format: int64
                  description: |-
                    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.
                  x-description-cn: 用于请求签名的 Unix 时间戳，单位为毫秒. 该值必须反映客户端当前时间，并会在签名接口中由服务器进行校验.
      responses:
        "200":
          description: Redeem a Binance Gift Card
          x-description-cn: 兑换币安礼品卡
          content:
            application/json:
              schema:
                type: object
                properties:
                  code:
                    type: string
                    example: "000000"
                  message:
                    type: string
                    example: success
                  data:
                    type: object
                    properties:
                      referenceNo:
                        type: string
                        example: "0033002328060227"
                      identityNo:
                        type: string
                        example: "10317392647411060736"
                      token:
                        type: string
                        example: BNB
                      amount:
                        type: string
                        example: "0.00000001"
                  success:
                    type: boolean
                    example: true
  /sapi/v1/giftcard/verify:
    get:
      summary: Verify Binance Gift Card by Gift Card Number
      x-summary-cn: 通过礼品卡卡号验证币安礼品卡
      description: |-
        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.**
      x-description-cn: |-
        此 API 用于通过输入礼品卡卡号来验证币安礼品卡是否有效。
        **请注意，如果您在一小时内输入错误的礼品卡卡号 5 次，您将无法在该小时内验证任何礼品卡卡号。**
      tags:
        - market-data
      operationId: verifyBinanceGiftCardByGiftCardNumber
      externalDocs:
        url: >-
          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
      x-connectors-examples:
        ts: >-
          https://raw.githubusercontent.com/binance/binance-connector-js/master/clients/gift-card/examples/rest-api/MarketDataApi/verifyBinanceGiftCardByGiftCardNumber.ts
        rust: >-
          https://raw.githubusercontent.com/binance/binance-connector-rust/main/examples/gift_card/rest_api/market_data_api/verify_binance_gift_card_by_gift_card_number.rs
        python: >-
          https://raw.githubusercontent.com/binance/binance-connector-python/master/clients/gift_card/examples/rest_api/MarketData/verify_binance_gift_card_by_gift_card_number.py
        java: >-
          https://raw.githubusercontent.com/binance/binance-connector-java/master/examples/gift-card/src/main/java/com/binance/connector/client/gift_card/rest/marketdata/VerifyBinanceGiftCardByGiftCardNumberExample.java
        go: >-
          https://raw.githubusercontent.com/binance/binance-connector-go/main/clients/giftcard/examples/restapi/MarketDataAPI/VerifyBinanceGiftCardByGiftCardNumber/VerifyBinanceGiftCardByGiftCardNumber.go
        php: >-
          https://raw.githubusercontent.com/binance/binance-connector-php/master/examples/gift-card/marketdata/VerifyBinanceGiftCardByGiftCardNumberExample.php
      x-ip-weight: 1
      x-security-type: USER_DATA
      x-signed: true
      parameters:
        - name: X-MBX-APIKEY
          in: header
          required: true
          description: >-
            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.
          x-description-cn: 访问此接口需要 API Key，并且必须在请求头中携带。关于如何创建 API Key，请参考：https://www.binance.com/cn/support/faq/detail/360002502072。
          schema:
            type: string
            example: API_KEY
        - name: referenceNo
          in: query
          required: true
          schema:
            type: string
            example: "0033002328060227"
          description: Enter the Gift Card Number
          x-description-cn: 输入礼品卡卡号
        - name: recvWindow
          in: query
          required: false
          schema:
            type: integer
            example: 5000
            format: int64
            maximum: 60000
        - name: timestamp
          in: query
          required: true
          schema:
            type: integer
            example: 1770736694138
            format: int64
          description: |-
            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.
          x-description-cn: 用于请求签名的 Unix 时间戳，单位为毫秒. 该值必须反映客户端当前时间，并会在签名接口中由服务器进行校验.
      responses:
        "200":
          description: Verify Binance Gift Card by Gift Card Number
          x-description-cn: 通过礼品卡卡号验证币安礼品卡
          content:
            application/json:
              schema:
                type: object
                properties:
                  code:
                    type: string
                    example: "000000"
                  message:
                    type: string
                    example: success
                  data:
                    type: object
                    properties:
                      valid:
                        type: boolean
                        example: true
                      token:
                        type: string
                        example: BNB
                      amount:
                        type: string
                        example: "0.00000001"
                  success:
                    type: boolean
                    example: true
