openapi: 3.0.2
info:
  title: Stocks Trading REST API
  description: Binance 股票交易 REST API。所有接口位于 `/sapi/v1/equity/*`。
  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/stocks/general-info#频率限制
x-security-guide: products/stocks/general-info#枚举契约
x-api-key-guide: https://www.binance.com/cn/support/faq/detail/360002502072
externalDocs:
  description: Stocks Trading docs
  url: https://developers.binance.com/en/docs/products/stocks/introduction
tags:
  - name: market-data
    x-displayName: 行情接口
  - name: trade
    x-displayName: 交易接口
  - name: tokenized
    x-displayName: 代币化接口
  - name: account
    x-displayName: 账户接口
  - name: user-data-streams
    x-displayName: 用户数据流
servers:
  - url: https://api.binance.com
paths:
  /sapi/v1/equity/market/exchangeInfo:
    get:
      summary: 交易规则与 Symbol 列表 (MARKET_DATA)
      description: 返回当前交易规则与可交易美股 Symbol 列表。MARKET_DATA 接口——需携带 API key（`X-MBX-APIKEY`），但无需签名。响应来自服务端缓存。
      tags:
        - market-data
      operationId: exchangeInfo
      externalDocs:
        url: https://developers.binance.com/en/docs/catalog/advanced-trading-stocks-trading/api/rest-api/market-data#exchange-info
      x-connectors-examples:
        ts: https://raw.githubusercontent.com/binance/binance-connector-js/master/clients/stocks/examples/rest-api/MarketDataApi/exchangeInfo.ts
        rust: https://raw.githubusercontent.com/binance/binance-connector-rust/main/examples/stocks/rest_api/market_data_api/exchange_info.rs
        python: https://raw.githubusercontent.com/binance/binance-connector-python/master/clients/stocks/examples/rest_api/MarketData/exchange_info.py
        java: https://raw.githubusercontent.com/binance/binance-connector-java/master/examples/stocks/src/main/java/com/binance/connector/client/stocks/rest/marketdata/ExchangeInfoExample.java
        go: https://raw.githubusercontent.com/binance/binance-connector-go/main/clients/stocks/examples/restapi/MarketDataAPI/ExchangeInfo/ExchangeInfo.go
        php: https://raw.githubusercontent.com/binance/binance-connector-php/master/examples/stocks/marketdata/ExchangeInfoExample.php
      x-security-type: MARKET_DATA
      x-weight: 1
      parameters:
        - name: X-MBX-APIKEY
          in: header
          required: true
          description: 访问此接口需要 API Key，并且必须在请求头中携带。关于如何创建 API Key，请参考：https://www.binance.com/cn/support/faq/detail/360002502072。
          schema:
            type: string
            example: API_KEY
        - name: symbol
          in: query
          required: false
          schema:
            type: string
            example: AAPL
          description: 过滤单只美股 ticker，例如 `AAPL`。省略时返回所有上架 symbol。未知 ticker 返回空 `symbols` 数组（HTTP 200），而非报错。
      responses:
        '200':
          description: 交易规则与 Symbol 列表
          content:
            application/json:
              schema:
                type: object
                properties:
                  timezone:
                    type: string
                    example: UTC
                    description: 固定为 `UTC`。
                  symbols:
                    type: array
                    description: 可交易 symbol 列表及其交易规则。
                    items:
                      type: object
                      properties:
                        symbol:
                          type: string
                          example: AAPL
                          description: 美股 ticker，例如 `AAPL`。
                        tradability:
                          type: string
                          example: BUY_SELL
                          enum:
                            - BUY_SELL
                            - BUY
                            - SELL
                            - NONE
                          description: 允许的交易方向，取值之一：`BUY_SELL` / `BUY` / `SELL` / `NONE`。
                        tradabilityUpdateTime:
                          type: integer
                          format: int64
                          example: 1735900000000
                          description: '`tradability` 值最后更新时间（毫秒时间戳）。'
                        overnightSupported:
                          type: boolean
                          example: true
                          description: 该 symbol 是否支持夜盘交易。
                        fractionable:
                          type: boolean
                          example: true
                          description: 常规时段是否支持分数股。
                        fractionableEh:
                          type: boolean
                          example: false
                          description: 延长时段是否支持分数股。
                        extendedSession:
                          type: boolean
                          example: true
                          description: 是否启用延长时段交易。
                        maxNumOrders:
                          type: integer
                          example: 200
                          description: 用户对此 symbol 可持有的最大挂单数。
                        stepSize:
                          type: string
                          example: '0.000000001'
                          description: '`quantity` 的最小步长（手数）。'
                        multiplierUp:
                          type: string
                          example: '1.10'
                          description: 相对参考价格的上限倍率。
                        multiplierDown:
                          type: string
                          example: '0.90'
                          description: 相对参考价格的下限倍率。
                        minQty:
                          type: string
                          example: '0.000000001'
                          description: 允许的最小 `quantity`。
                        maxQty:
                          type: string
                          example: '100000.00000000'
                          description: 允许的最大 `quantity`。
                        minNotional:
                          type: string
                          example: '1.00'
                          description: 最小订单名义金额（USD）。
                        maxNotional:
                          type: string
                          example: '1000000.00'
                          description: 最大订单名义金额（USD）。
                        listingTime:
                          type: integer
                          format: int64
                          example: 1700000000000
                          description: 上架时间（毫秒时间戳）。
                        delistingTime:
                          type: integer
                          format: int64
                          nullable: true
                          example: null
                          description: 计划下架时间（毫秒时间戳）；未计划下架时为 `null`。
  /sapi/v1/equity/market/tokenized-assets:
    get:
      summary: 代币化资产列表 (MARKET_DATA)
      description: 返回当前可铸造 / 赎回的全部代币化资产列表，包含每个资产的标的美股 Symbol 和转换倍数。MARKET_DATA 接口——需携带 API key（`X-MBX-APIKEY`），但无需签名。响应来自服务端缓存。
      tags:
        - market-data
      operationId: tokenizedAssets
      externalDocs:
        url: https://developers.binance.com/en/docs/catalog/advanced-trading-stocks-trading/api/rest-api/market-data#tokenized-assets
      x-connectors-examples:
        ts: https://raw.githubusercontent.com/binance/binance-connector-js/master/clients/stocks/examples/rest-api/MarketDataApi/tokenizedAssets.ts
        rust: https://raw.githubusercontent.com/binance/binance-connector-rust/main/examples/stocks/rest_api/market_data_api/tokenized_assets.rs
        python: https://raw.githubusercontent.com/binance/binance-connector-python/master/clients/stocks/examples/rest_api/MarketData/tokenized_assets.py
        java: https://raw.githubusercontent.com/binance/binance-connector-java/master/examples/stocks/src/main/java/com/binance/connector/client/stocks/rest/marketdata/TokenizedAssetsExample.java
        go: https://raw.githubusercontent.com/binance/binance-connector-go/main/clients/stocks/examples/restapi/MarketDataAPI/TokenizedAssets/TokenizedAssets.go
        php: https://raw.githubusercontent.com/binance/binance-connector-php/master/examples/stocks/marketdata/TokenizedAssetsExample.php
      x-security-type: MARKET_DATA
      x-weight: 1
      parameters:
        - name: X-MBX-APIKEY
          in: header
          required: true
          description: 访问此接口需要 API Key，并且必须在请求头中携带。关于如何创建 API Key，请参考：https://www.binance.com/cn/support/faq/detail/360002502072。
          schema:
            type: string
            example: API_KEY
      responses:
        '200':
          description: 代币化资产列表
          content:
            application/json:
              schema:
                type: array
                items:
                  type: object
                  properties:
                    assetCode:
                      type: string
                      example: AAPLB
                      description: 代币化资产代码，例如 `AAPLB`。
                    assetName:
                      type: string
                      example: Apple Inc. Tokenized Stock
                      description: 代币化资产的人类可读名称。
                    underlyingEquitySymbol:
                      type: string
                      example: AAPL
                      description: 标的美股 ticker，例如 `AAPL`。调用 `/tokenized/mint` 或 `/tokenized/redeem` 时使用此字段。
                    multiplier:
                      type: string
                      example: '1'
                      description: 标的股票与代币化资产之间的转换倍数。
                    multiplierValid:
                      type: boolean
                      example: true
                      description: 当前倍数是否有效且可适用。
  /sapi/v1/equity/market/quote:
    get:
      summary: 最新报价 (MARKET_DATA)
      description: 返回单只美股的最优买一 / 卖一报价，数据最多延迟约 5 秒。当指定 ticker 没有可用报价时（如未知、停牌或已下架）返回**空响应体**（非字面 `null`，客户端需容错）。
      tags:
        - market-data
      operationId: latestQuote
      externalDocs:
        url: https://developers.binance.com/en/docs/catalog/advanced-trading-stocks-trading/api/rest-api/market-data#latest-quote
      x-connectors-examples:
        ts: https://raw.githubusercontent.com/binance/binance-connector-js/master/clients/stocks/examples/rest-api/MarketDataApi/latestQuote.ts
        rust: https://raw.githubusercontent.com/binance/binance-connector-rust/main/examples/stocks/rest_api/market_data_api/latest_quote.rs
        python: https://raw.githubusercontent.com/binance/binance-connector-python/master/clients/stocks/examples/rest_api/MarketData/latest_quote.py
        java: https://raw.githubusercontent.com/binance/binance-connector-java/master/examples/stocks/src/main/java/com/binance/connector/client/stocks/rest/marketdata/LatestQuoteExample.java
        go: https://raw.githubusercontent.com/binance/binance-connector-go/main/clients/stocks/examples/restapi/MarketDataAPI/LatestQuote/LatestQuote.go
        php: https://raw.githubusercontent.com/binance/binance-connector-php/master/examples/stocks/marketdata/LatestQuoteExample.php
      x-security-type: MARKET_DATA
      x-weight: 1
      parameters:
        - name: X-MBX-APIKEY
          in: header
          required: true
          description: 访问此接口需要 API Key，并且必须在请求头中携带。关于如何创建 API Key，请参考：https://www.binance.com/cn/support/faq/detail/360002502072。
          schema:
            type: string
            example: API_KEY
        - name: symbol
          in: query
          required: true
          schema:
            type: string
            example: AAPL
          description: 美股 ticker，例如 `AAPL`、`TSLA`。大小写不敏感，服务端统一转为大写。
      responses:
        '200':
          description: 最新报价
          content:
            application/json:
              schema:
                type: object
                nullable: true
                properties:
                  symbol:
                    type: string
                    example: AAPL
                    description: 美股 ticker。
                  bidPrice:
                    type: string
                    example: '180.50'
                    description: 最优买一价（USD）。
                  askPrice:
                    type: string
                    example: '180.52'
                    description: 最优卖一价（USD）。
                  bidSize:
                    type: integer
                    example: 100
                    description: 最优买一量（股数）。
                  askSize:
                    type: integer
                    example: 200
                    description: 最优卖一量（股数）。
  /sapi/v1/equity/order/place:
    post:
      summary: 下单 (TRADE)
      description: |-
        下一笔股票订单。支持 `LIMIT` / `MARKET` × `BUY` / `SELL` 的所有组合。对于 `LIMIT BUY` 订单，服务端在下单时自动计算并冻结手续费——调用方只需提交 `price` 和 `quantity`，无需传 `fee` 字段。

        **字段组合矩阵**

        | Side | OrderType | 必填 | 禁传 | | ---- | --------- | ---- | ---- | | BUY | LIMIT | `price`、`quantity`、`tradingSession` | `notional` | | BUY | MARKET | `notional` | `price`、`quantity`、`tradingSession` | | SELL | LIMIT | `price`、`quantity`、`tradingSession` | `notional` | | SELL | MARKET | `quantity` | `price`、`notional`、`tradingSession` |

        **碎股**：当 `quantity` 带小数，或使用 `notional` 下单时，订单被视为碎股订单。碎股 `GTC` 订单必须搭配 `tradingSession = EXTENDED` 或 `24H`。

        频率限制：200 次 / 分钟（UID）。
      tags:
        - trade
      operationId: placeEquityOrder
      externalDocs:
        url: https://developers.binance.com/en/docs/catalog/advanced-trading-stocks-trading/api/rest-api/trade#place-equity-order
      x-connectors-examples:
        ts: https://raw.githubusercontent.com/binance/binance-connector-js/master/clients/stocks/examples/rest-api/TradeApi/placeEquityOrder.ts
        rust: https://raw.githubusercontent.com/binance/binance-connector-rust/main/examples/stocks/rest_api/trade_api/place_equity_order.rs
        python: https://raw.githubusercontent.com/binance/binance-connector-python/master/clients/stocks/examples/rest_api/Trade/place_equity_order.py
        java: https://raw.githubusercontent.com/binance/binance-connector-java/master/examples/stocks/src/main/java/com/binance/connector/client/stocks/rest/trade/PlaceEquityOrderExample.java
        go: https://raw.githubusercontent.com/binance/binance-connector-go/main/clients/stocks/examples/restapi/TradeAPI/PlaceEquityOrder/PlaceEquityOrder.go
        php: https://raw.githubusercontent.com/binance/binance-connector-php/master/examples/stocks/trade/PlaceEquityOrderExample.php
      x-security-type: TRADE
      x-signed: true
      x-weight: 1
      parameters:
        - name: X-MBX-APIKEY
          in: header
          required: true
          description: 访问此接口需要 API Key，并且必须在请求头中携带。关于如何创建 API Key，请参考：https://www.binance.com/cn/support/faq/detail/360002502072。
          schema:
            type: string
            example: API_KEY
        - name: symbol
          in: query
          required: true
          schema:
            type: string
            example: AAPL
          description: 美股 ticker，如 `AAPL`、`TSLA`。必须是已开启代币化（tokenize）的 symbol——可通过 `/market/tokenized-assets` 查询。
        - name: quoteAsset
          in: query
          required: false
          schema:
            type: string
            example: USDC
          description: 计价资产，默认 `USDC`；必须在服务端允许集合内。
        - name: side
          in: query
          required: true
          schema:
            type: string
            enum:
              - BUY
              - SELL
            example: BUY
          description: '`BUY` / `SELL`。'
        - name: orderType
          in: query
          required: true
          schema:
            type: string
            enum:
              - MARKET
              - LIMIT
            example: LIMIT
          description: '`MARKET` / `LIMIT`。'
        - name: price
          in: query
          required: false
          schema:
            type: string
            example: '180.50'
          description: '`LIMIT` **必填**；`MARKET` **禁传**。最多 2 位小数。'
        - name: quantity
          in: query
          required: false
          schema:
            type: string
            example: '1'
          description: '`LIMIT`（买卖两侧）与 `SELL MARKET` **必填**；`BUY MARKET` **禁传**。'
        - name: notional
          in: query
          required: false
          schema:
            type: string
            example: '1000.00'
          description: '`BUY MARKET` **必填**；`LIMIT` 与 `SELL MARKET` **禁传**。'
        - name: timeInForce
          in: query
          required: false
          schema:
            type: string
            enum:
              - DAY
              - GTC
            example: DAY
          description: '`DAY`（默认）/ `GTC`。`GTC` 仅支持 `LIMIT` 订单；碎股 `GTC` 订单必须搭配 `tradingSession = EXTENDED` 或 `24H`。'
        - name: tradingSession
          in: query
          required: false
          schema:
            type: string
            enum:
              - RTH
              - EXTENDED
              - 24H
            example: RTH
          description: '`RTH` / `EXTENDED` / `24H`。`LIMIT` **必填**；`MARKET` **禁传**。'
        - name: walletType
          in: query
          required: false
          schema:
            type: string
            enum:
              - CARD
              - MAIN
            example: CARD
          description: '`BUY` 侧付款钱包：`CARD`（默认）/ `MAIN`。`SELL` 侧固定结算至 `CARD`。'
        - name: clientOrderId
          in: query
          required: false
          schema:
            type: string
            example: web_2c9c92b74f1e4a7c8f3b9e1a2d3c4b5a
          description: 客户端自定义订单 ID。格式 `^[a-zA-Z0-9-_]{32,36}$`。不传则服务端自动生成。
        - name: tokenize
          in: query
          required: false
          schema:
            type: boolean
            example: true
          description: 结算后是否将买入的股票资产代币化。默认 `true`。设为 `false` 则直接获得底层股票而非代币化资产。
        - name: recvWindow
          in: query
          required: false
          schema:
            type: integer
            format: int64
            example: 5000
          description: 赋值不能大于 `60000`。
        - name: timestamp
          in: query
          required: true
          schema:
            type: integer
            format: int64
            example: 1770736694138
          description: 时间戳（毫秒）。
      responses:
        '200':
          description: 下单响应
          content:
            application/json:
              schema:
                type: object
                properties:
                  status:
                    type: string
                    example: S
                    description: 请求确认码：`S` = 已接受，`F` = 失败。这不是订单生命周期状态——如需查询生命周期，请调用 `/order/detail` 或 `/order/history`。
                  orderId:
                    type: string
                    example: c3c58f49-7b0d-4b9e-a2db-1a2f9a3b8c71
                    description: 订单 ID（UUID）。
                  clientOrderId:
                    type: string
                    example: web_2c9c92b74f1e4a7c8f3b9e1a2d3c4b5a
                    description: 回显提交的或服务端生成的客户端订单 ID。
  /sapi/v1/equity/order/cancel:
    post:
      summary: 撤单 (TRADE)
      description: 按 `orderId` 撤销单笔挂单。
      tags:
        - trade
      operationId: cancelEquityOrder
      externalDocs:
        url: https://developers.binance.com/en/docs/catalog/advanced-trading-stocks-trading/api/rest-api/trade#cancel-equity-order
      x-connectors-examples:
        ts: https://raw.githubusercontent.com/binance/binance-connector-js/master/clients/stocks/examples/rest-api/TradeApi/cancelEquityOrder.ts
        rust: https://raw.githubusercontent.com/binance/binance-connector-rust/main/examples/stocks/rest_api/trade_api/cancel_equity_order.rs
        python: https://raw.githubusercontent.com/binance/binance-connector-python/master/clients/stocks/examples/rest_api/Trade/cancel_equity_order.py
        java: https://raw.githubusercontent.com/binance/binance-connector-java/master/examples/stocks/src/main/java/com/binance/connector/client/stocks/rest/trade/CancelEquityOrderExample.java
        go: https://raw.githubusercontent.com/binance/binance-connector-go/main/clients/stocks/examples/restapi/TradeAPI/CancelEquityOrder/CancelEquityOrder.go
        php: https://raw.githubusercontent.com/binance/binance-connector-php/master/examples/stocks/trade/CancelEquityOrderExample.php
      x-security-type: TRADE
      x-signed: true
      x-weight: 1
      parameters:
        - name: X-MBX-APIKEY
          in: header
          required: true
          description: 访问此接口需要 API Key，并且必须在请求头中携带。关于如何创建 API Key，请参考：https://www.binance.com/cn/support/faq/detail/360002502072。
          schema:
            type: string
            example: API_KEY
        - name: orderId
          in: query
          required: true
          schema:
            type: string
            example: c3c58f49-7b0d-4b9e-a2db-1a2f9a3b8c71
          description: 由 `/order/place` 或查询接口返回的股票订单 ID。
        - name: recvWindow
          in: query
          required: false
          schema:
            type: integer
            format: int64
            example: 5000
          description: 赋值不能大于 `60000`。
        - name: timestamp
          in: query
          required: true
          schema:
            type: integer
            format: int64
            example: 1770736694138
          description: 时间戳（毫秒）。
      responses:
        '200':
          description: 撤单响应
          content:
            application/json:
              schema:
                type: object
                properties:
                  orderId:
                    type: string
                    example: c3c58f49-7b0d-4b9e-a2db-1a2f9a3b8c71
                    description: 回显请求的订单 ID。
                  status:
                    type: string
                    example: S
                    description: 请求确认码：`S` = 撤单已被上游接受，`F` = 撤单失败。这不是订单生命周期状态——如需查询生命周期请使用 `/order/detail`。
  /sapi/v1/equity/order/cancel-all:
    post:
      summary: 全部撤单 (TRADE)
      description: 撤销调用方所有未成交订单。无需额外请求参数——范围固定为调用方所有未成交订单。下游服务保证幂等性；如需查看每笔订单的结果，请在调用后查询 `/order/history`。
      tags:
        - trade
      operationId: cancelAllEquityOrders
      externalDocs:
        url: https://developers.binance.com/en/docs/catalog/advanced-trading-stocks-trading/api/rest-api/trade#cancel-all-equity-orders
      x-connectors-examples:
        ts: https://raw.githubusercontent.com/binance/binance-connector-js/master/clients/stocks/examples/rest-api/TradeApi/cancelAllEquityOrders.ts
        rust: https://raw.githubusercontent.com/binance/binance-connector-rust/main/examples/stocks/rest_api/trade_api/cancel_all_equity_orders.rs
        python: https://raw.githubusercontent.com/binance/binance-connector-python/master/clients/stocks/examples/rest_api/Trade/cancel_all_equity_orders.py
        java: https://raw.githubusercontent.com/binance/binance-connector-java/master/examples/stocks/src/main/java/com/binance/connector/client/stocks/rest/trade/CancelAllEquityOrdersExample.java
        go: https://raw.githubusercontent.com/binance/binance-connector-go/main/clients/stocks/examples/restapi/TradeAPI/CancelAllEquityOrders/CancelAllEquityOrders.go
        php: https://raw.githubusercontent.com/binance/binance-connector-php/master/examples/stocks/trade/CancelAllEquityOrdersExample.php
      x-security-type: TRADE
      x-signed: true
      x-weight: 1
      parameters:
        - name: X-MBX-APIKEY
          in: header
          required: true
          description: 访问此接口需要 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
            format: int64
            example: 5000
          description: 赋值不能大于 `60000`。
        - name: timestamp
          in: query
          required: true
          schema:
            type: integer
            format: int64
            example: 1770736694138
          description: 时间戳（毫秒）。
      responses:
        '200':
          description: 全部撤单响应
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    example: true
                    description: 撤单请求被上游接受时为 `true`。每笔订单的结果请查询 `/order/history`。
  /sapi/v1/equity/order/open-orders:
    get:
      summary: 当前挂单 (USER_DATA)
      description: 查询调用方所有未完成（挂单中）的股票订单。无需业务参数——用户身份由签名推导。
      tags:
        - trade
      operationId: currentOpenOrders
      externalDocs:
        url: https://developers.binance.com/en/docs/catalog/advanced-trading-stocks-trading/api/rest-api/trade#current-open-orders
      x-connectors-examples:
        ts: https://raw.githubusercontent.com/binance/binance-connector-js/master/clients/stocks/examples/rest-api/TradeApi/currentOpenOrders.ts
        rust: https://raw.githubusercontent.com/binance/binance-connector-rust/main/examples/stocks/rest_api/trade_api/current_open_orders.rs
        python: https://raw.githubusercontent.com/binance/binance-connector-python/master/clients/stocks/examples/rest_api/Trade/current_open_orders.py
        java: https://raw.githubusercontent.com/binance/binance-connector-java/master/examples/stocks/src/main/java/com/binance/connector/client/stocks/rest/trade/CurrentOpenOrdersExample.java
        go: https://raw.githubusercontent.com/binance/binance-connector-go/main/clients/stocks/examples/restapi/TradeAPI/CurrentOpenOrders/CurrentOpenOrders.go
        php: https://raw.githubusercontent.com/binance/binance-connector-php/master/examples/stocks/trade/CurrentOpenOrdersExample.php
      x-security-type: USER_DATA
      x-signed: true
      x-weight: 1
      parameters:
        - name: X-MBX-APIKEY
          in: header
          required: true
          description: 访问此接口需要 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
            format: int64
            example: 5000
          description: 赋值不能大于 `60000`。
        - name: timestamp
          in: query
          required: true
          schema:
            type: integer
            format: int64
            example: 1770736694138
          description: 时间戳（毫秒）。
      responses:
        '200':
          description: 当前挂单响应
          content:
            application/json:
              schema:
                type: array
                description: 挂单对象数组。字段与订单历史中的订单行一致。
                items:
                  type: object
                  properties:
                    orderId:
                      type: string
                      example: c3c58f49-7b0d-4b9e-a2db-1a2f9a3b8c71
                      description: 股票订单 ID。
                    symbol:
                      type: string
                      example: AAPL
                      description: 美股 ticker。
                    quote:
                      type: string
                      example: USDC
                      description: 计价资产（如 `USDC`）。
                    side:
                      type: string
                      example: BUY
                      description: '`BUY` / `SELL`。'
                    orderType:
                      type: string
                      example: LIMIT
                      description: '`MARKET` / `LIMIT`。'
                    limitPrice:
                      type: string
                      nullable: true
                      example: '180.50'
                      description: 限价（USD）。`LIMIT` 订单非空，`MARKET` 订单为 `null`。
                    avgFilledPrice:
                      type: string
                      nullable: true
                      example: null
                      description: 平均成交价（USD）。首笔成交前为 `null`。
                    qty:
                      type: string
                      nullable: true
                      example: '1'
                      description: 请求股数。`BUY MARKET` 时为 `null`（使用 `notional` 替代）。
                    notional:
                      type: string
                      nullable: true
                      example: null
                      description: 请求名义金额。`BUY MARKET` 非空；其他情况为 `null`。
                    filledQty:
                      type: string
                      example: '0'
                      description: 累计成交数量。
                    filledTotal:
                      type: string
                      nullable: true
                      example: null
                      description: 累计成交名义金额，仅 `BUY MARKET` 有值。
                    fee:
                      type: string
                      example: '0'
                      description: 总手续费（USD）。
                    session:
                      type: string
                      nullable: true
                      example: RTH
                      description: 下单时的交易时段：`RTH` / `EXTENDED` / `24H`。`MARKET` 订单为 `null`。
                    status:
                      type: string
                      example: NEW
                      description: 订单生命周期状态，取值之一：`NEW` / `ACCEPTED` / `PARTIALLY_FILLED` / `FILLED` / `CANCELED` / `EXPIRED` / `REJECTED`。
                    createdAt:
                      type: integer
                      format: int64
                      example: 1735900000000
                      description: 订单创建时间（毫秒时间戳）。
                    updatedAt:
                      type: integer
                      format: int64
                      example: 1735900000000
                      description: 最后更新时间（毫秒时间戳）。
  /sapi/v1/equity/order/history:
    get:
      summary: 订单历史 (USER_DATA)
      description: 调用方的分页订单历史，可按 symbol、订单类型、方向、状态和时间段过滤。
      tags:
        - trade
      operationId: equityOrderHistory
      externalDocs:
        url: https://developers.binance.com/en/docs/catalog/advanced-trading-stocks-trading/api/rest-api/trade#equity-order-history
      x-connectors-examples:
        ts: https://raw.githubusercontent.com/binance/binance-connector-js/master/clients/stocks/examples/rest-api/TradeApi/equityOrderHistory.ts
        rust: https://raw.githubusercontent.com/binance/binance-connector-rust/main/examples/stocks/rest_api/trade_api/equity_order_history.rs
        python: https://raw.githubusercontent.com/binance/binance-connector-python/master/clients/stocks/examples/rest_api/Trade/equity_order_history.py
        java: https://raw.githubusercontent.com/binance/binance-connector-java/master/examples/stocks/src/main/java/com/binance/connector/client/stocks/rest/trade/EquityOrderHistoryExample.java
        go: https://raw.githubusercontent.com/binance/binance-connector-go/main/clients/stocks/examples/restapi/TradeAPI/EquityOrderHistory/EquityOrderHistory.go
        php: https://raw.githubusercontent.com/binance/binance-connector-php/master/examples/stocks/trade/EquityOrderHistoryExample.php
      x-security-type: USER_DATA
      x-signed: true
      x-weight: 1
      parameters:
        - name: X-MBX-APIKEY
          in: header
          required: true
          description: 访问此接口需要 API Key，并且必须在请求头中携带。关于如何创建 API Key，请参考：https://www.binance.com/cn/support/faq/detail/360002502072。
          schema:
            type: string
            example: API_KEY
        - name: symbol
          in: query
          required: false
          schema:
            type: string
            example: NVDA
          description: 美股 ticker 过滤，例如 `NVDA`。
        - name: orderType
          in: query
          required: false
          schema:
            type: string
            enum:
              - MARKET
              - LIMIT
            example: LIMIT
          description: 订单类型过滤：`MARKET` / `LIMIT`。
        - name: side
          in: query
          required: false
          schema:
            type: string
            enum:
              - BUY
              - SELL
            example: BUY
          description: 方向过滤：`BUY` / `SELL`。
        - name: orderStatus
          in: query
          required: false
          schema:
            type: string
            example: FILLED,CANCELED
          description: 逗号分隔的状态过滤，允许值：`FILLED`、`PARTIALLY_FILLED`、`CANCELED`、`EXPIRED`、`REJECTED`。
        - name: startTime
          in: query
          required: true
          schema:
            type: integer
            format: int64
            example: 1735800000000
          description: 开始时间（毫秒时间戳）。
        - name: endTime
          in: query
          required: true
          schema:
            type: integer
            format: int64
            example: 1735900000000
          description: 结束时间（毫秒时间戳）。
        - name: current
          in: query
          required: false
          schema:
            type: integer
            example: 1
          description: 页码，从 1 起，默认 `1`。
        - name: size
          in: query
          required: false
          schema:
            type: integer
            example: 20
          description: 每页大小，默认 `20`，最大 `100`。
        - name: recvWindow
          in: query
          required: false
          schema:
            type: integer
            format: int64
            example: 5000
          description: 赋值不能大于 `60000`。
        - name: timestamp
          in: query
          required: true
          schema:
            type: integer
            format: int64
            example: 1770736694138
          description: 时间戳（毫秒）。
      responses:
        '200':
          description: 订单历史
          content:
            application/json:
              schema:
                type: object
                properties:
                  total:
                    type: integer
                    format: int64
                    example: 2
                    description: 符合过滤条件的总行数。
                  page:
                    type: integer
                    example: 1
                    description: 当前页码（回显 `current`）。
                  size:
                    type: integer
                    example: 20
                    description: 当前页大小（回显 `size`）。
                  rows:
                    type: array
                    description: 本页订单列表，无匹配时为空数组。
                    items:
                      type: object
                      properties:
                        orderId:
                          type: string
                          example: c3c58f49-7b0d-4b9e-a2db-1a2f9a3b8c71
                          description: 股票订单 ID。
                        symbol:
                          type: string
                          example: AAPL
                          description: 美股 ticker。
                        quote:
                          type: string
                          example: USDC
                          description: 计价资产（如 `USDC`）。
                        side:
                          type: string
                          example: BUY
                          description: '`BUY` / `SELL`。'
                        orderType:
                          type: string
                          example: LIMIT
                          description: '`MARKET` / `LIMIT`。'
                        limitPrice:
                          type: string
                          nullable: true
                          example: '180.50'
                          description: 限价（USD）。`LIMIT` 订单非空，`MARKET` 订单为 `null`。
                        avgFilledPrice:
                          type: string
                          nullable: true
                          example: '180.48'
                          description: 平均成交价（USD）。首笔成交前为 `null`。对 `MARKET` 订单，这是唯一有意义的价格字段。
                        qty:
                          type: string
                          nullable: true
                          example: '1'
                          description: 请求股数。`BUY MARKET` 时为 `null`（使用 `notional` 替代）。
                        notional:
                          type: string
                          nullable: true
                          example: null
                          description: 请求名义金额。`BUY MARKET` 非空；其他情况为 `null`。
                        filledQty:
                          type: string
                          example: '1'
                          description: 累计成交数量。
                        filledTotal:
                          type: string
                          nullable: true
                          example: null
                          description: 累计成交名义金额，仅 `BUY MARKET` 有值。
                        fee:
                          type: string
                          example: '0.10'
                          description: 总手续费（USD）。
                        session:
                          type: string
                          nullable: true
                          example: RTH
                          description: 下单时的交易时段：`RTH` / `EXTENDED` / `24H`。`MARKET` 订单为 `null`。
                        status:
                          type: string
                          example: FILLED
                          description: 订单生命周期状态，取值之一：`NEW` / `ACCEPTED` / `PARTIALLY_FILLED` / `FILLED` / `CANCELED` / `EXPIRED` / `REJECTED`。
                        createdAt:
                          type: integer
                          format: int64
                          example: 1735900000000
                          description: 订单创建时间（毫秒时间戳）。
                        updatedAt:
                          type: integer
                          format: int64
                          example: 1735900120000
                          description: 最后更新时间（毫秒时间戳）。
  /sapi/v1/equity/order/detail:
    get:
      summary: 订单详情 (USER_DATA)
      description: 返回单笔订单及其成交明细列表。调用方只能查询自己的订单——用户身份从签名请求中解析。
      tags:
        - trade
      operationId: equityOrderDetail
      externalDocs:
        url: https://developers.binance.com/en/docs/catalog/advanced-trading-stocks-trading/api/rest-api/trade#equity-order-detail
      x-connectors-examples:
        ts: https://raw.githubusercontent.com/binance/binance-connector-js/master/clients/stocks/examples/rest-api/TradeApi/equityOrderDetail.ts
        rust: https://raw.githubusercontent.com/binance/binance-connector-rust/main/examples/stocks/rest_api/trade_api/equity_order_detail.rs
        python: https://raw.githubusercontent.com/binance/binance-connector-python/master/clients/stocks/examples/rest_api/Trade/equity_order_detail.py
        java: https://raw.githubusercontent.com/binance/binance-connector-java/master/examples/stocks/src/main/java/com/binance/connector/client/stocks/rest/trade/EquityOrderDetailExample.java
        go: https://raw.githubusercontent.com/binance/binance-connector-go/main/clients/stocks/examples/restapi/TradeAPI/EquityOrderDetail/EquityOrderDetail.go
        php: https://raw.githubusercontent.com/binance/binance-connector-php/master/examples/stocks/trade/EquityOrderDetailExample.php
      x-security-type: USER_DATA
      x-signed: true
      x-weight: 1
      parameters:
        - name: X-MBX-APIKEY
          in: header
          required: true
          description: 访问此接口需要 API Key，并且必须在请求头中携带。关于如何创建 API Key，请参考：https://www.binance.com/cn/support/faq/detail/360002502072。
          schema:
            type: string
            example: API_KEY
        - name: orderId
          in: query
          required: true
          schema:
            type: string
            example: c3c58f49-7b0d-4b9e-a2db-1a2f9a3b8c71
          description: 股票订单 ID。
        - name: recvWindow
          in: query
          required: false
          schema:
            type: integer
            format: int64
            example: 5000
          description: 赋值不能大于 `60000`。
        - name: timestamp
          in: query
          required: true
          schema:
            type: integer
            format: int64
            example: 1770736694138
          description: 时间戳（毫秒）。
      responses:
        '200':
          description: 订单详情
          content:
            application/json:
              schema:
                type: object
                description: 顶级字段与 `/order/history` 的订单行完全一致（orderId、symbol、quote、side、orderType、limitPrice、avgFilledPrice、qty、notional、filledQty、filledTotal、fee、session、status、createdAt、updatedAt），另附 `trades` 数组。
                properties:
                  orderId:
                    type: string
                    example: c3c58f49-7b0d-4b9e-a2db-1a2f9a3b8c71
                    description: 股票订单 ID。
                  symbol:
                    type: string
                    example: AAPL
                    description: 美股 ticker。
                  quote:
                    type: string
                    example: USDC
                    description: 计价资产。
                  side:
                    type: string
                    example: BUY
                    description: '`BUY` / `SELL`。'
                  orderType:
                    type: string
                    example: LIMIT
                    description: '`MARKET` / `LIMIT`。'
                  limitPrice:
                    type: string
                    nullable: true
                    example: '180.50'
                    description: 限价（USD）。`LIMIT` 非空，`MARKET` 为 `null`。
                  avgFilledPrice:
                    type: string
                    nullable: true
                    example: '180.48'
                    description: 平均成交价（USD）。
                  qty:
                    type: string
                    nullable: true
                    example: '1'
                    description: 请求股数。
                  notional:
                    type: string
                    nullable: true
                    example: null
                    description: 请求名义金额。
                  filledQty:
                    type: string
                    example: '1'
                    description: 累计成交数量。
                  filledTotal:
                    type: string
                    nullable: true
                    example: null
                    description: 累计成交名义金额。
                  fee:
                    type: string
                    example: '0.10'
                    description: 总手续费（USD）。
                  session:
                    type: string
                    nullable: true
                    example: RTH
                    description: 交易时段。
                  status:
                    type: string
                    example: FILLED
                    description: 订单生命周期状态。
                  createdAt:
                    type: integer
                    format: int64
                    example: 1735900000000
                    description: 订单创建时间（毫秒时间戳）。
                  updatedAt:
                    type: integer
                    format: int64
                    example: 1735900120000
                    description: 最后更新时间（毫秒时间戳）。
                  trades:
                    type: array
                    description: 此订单的成交明细，最新成交在前。无成交时为空数组。
                    items:
                      type: object
                      properties:
                        executionId:
                          type: string
                          example: exec-20260504-0001
                          description: 成交（逐笔）ID。
                        executionAt:
                          type: integer
                          format: int64
                          example: 1735900115000
                          description: 成交时间（毫秒时间戳）。
                        price:
                          type: string
                          example: '180.48'
                          description: 此笔成交价格（USD）。
                        qty:
                          type: string
                          example: '1'
                          description: 成交数量。
                        fee:
                          type: string
                          example: '0.10'
                          description: 此笔成交手续费（USD）。
  /sapi/v1/equity/trade/history:
    get:
      summary: 成交历史 (USER_DATA)
      description: 调用方的分页逐笔成交历史。每行为一笔执行，而非一笔订单——部分成交订单会产生多行。可按 symbol、方向、指定 `orderId` 和时间段过滤。
      tags:
        - trade
      operationId: equityTradeHistory
      externalDocs:
        url: https://developers.binance.com/en/docs/catalog/advanced-trading-stocks-trading/api/rest-api/trade#equity-trade-history
      x-connectors-examples:
        ts: https://raw.githubusercontent.com/binance/binance-connector-js/master/clients/stocks/examples/rest-api/TradeApi/equityTradeHistory.ts
        rust: https://raw.githubusercontent.com/binance/binance-connector-rust/main/examples/stocks/rest_api/trade_api/equity_trade_history.rs
        python: https://raw.githubusercontent.com/binance/binance-connector-python/master/clients/stocks/examples/rest_api/Trade/equity_trade_history.py
        java: https://raw.githubusercontent.com/binance/binance-connector-java/master/examples/stocks/src/main/java/com/binance/connector/client/stocks/rest/trade/EquityTradeHistoryExample.java
        go: https://raw.githubusercontent.com/binance/binance-connector-go/main/clients/stocks/examples/restapi/TradeAPI/EquityTradeHistory/EquityTradeHistory.go
        php: https://raw.githubusercontent.com/binance/binance-connector-php/master/examples/stocks/trade/EquityTradeHistoryExample.php
      x-security-type: USER_DATA
      x-signed: true
      x-weight: 1
      parameters:
        - name: X-MBX-APIKEY
          in: header
          required: true
          description: 访问此接口需要 API Key，并且必须在请求头中携带。关于如何创建 API Key，请参考：https://www.binance.com/cn/support/faq/detail/360002502072。
          schema:
            type: string
            example: API_KEY
        - name: symbol
          in: query
          required: false
          schema:
            type: string
            example: NVDA
          description: 美股 ticker 过滤，例如 `NVDA`。
        - name: side
          in: query
          required: false
          schema:
            type: string
            enum:
              - BUY
              - SELL
            example: BUY
          description: 方向过滤：`BUY` / `SELL`。
        - name: orderId
          in: query
          required: false
          schema:
            type: string
            example: c3c58f49-7b0d-4b9e-a2db-1a2f9a3b8c71
          description: 将结果限定为单笔订单的成交记录。
        - name: startTime
          in: query
          required: true
          schema:
            type: integer
            format: int64
            example: 1735800000000
          description: 开始时间（毫秒时间戳）。
        - name: endTime
          in: query
          required: true
          schema:
            type: integer
            format: int64
            example: 1735900000000
          description: 结束时间（毫秒时间戳）。
        - name: current
          in: query
          required: false
          schema:
            type: integer
            example: 1
          description: 页码，从 1 起，默认 `1`。
        - name: size
          in: query
          required: false
          schema:
            type: integer
            example: 20
          description: 每页大小，默认 `20`，最大 `100`。
        - name: recvWindow
          in: query
          required: false
          schema:
            type: integer
            format: int64
            example: 5000
          description: 赋值不能大于 `60000`。
        - name: timestamp
          in: query
          required: true
          schema:
            type: integer
            format: int64
            example: 1770736694138
          description: 时间戳（毫秒）。
      responses:
        '200':
          description: 成交历史
          content:
            application/json:
              schema:
                type: object
                properties:
                  total:
                    type: integer
                    format: int64
                    example: 1
                    description: 符合过滤条件的总行数。
                  page:
                    type: integer
                    example: 1
                    description: 当前页码。
                  size:
                    type: integer
                    example: 20
                    description: 当前页大小。
                  rows:
                    type: array
                    description: 本页成交列表，无匹配时为空数组。
                    items:
                      type: object
                      properties:
                        executionId:
                          type: string
                          example: exec-20260504-0001
                          description: 逐笔成交 ID。
                        orderId:
                          type: string
                          example: c3c58f49-7b0d-4b9e-a2db-1a2f9a3b8c71
                          description: 所属订单 ID。
                        symbol:
                          type: string
                          example: AAPL
                          description: 美股 ticker。
                        quote:
                          type: string
                          example: USDC
                          description: 计价资产。
                        side:
                          type: string
                          example: BUY
                          description: '`BUY` / `SELL`。'
                        orderType:
                          type: string
                          example: LIMIT
                          description: '`MARKET` / `LIMIT`。'
                        price:
                          type: string
                          example: '180.50'
                          description: 成交价格（USD）。
                        qty:
                          type: string
                          example: '1'
                          description: 成交数量。
                        fee:
                          type: string
                          example: '0.10'
                          description: 此笔成交手续费（USD）。
                        total:
                          type: string
                          example: '180.50'
                          description: 此笔成交名义金额（`qty × price`）。
                        executionAt:
                          type: integer
                          format: int64
                          example: 1735900115000
                          description: 成交时间（毫秒时间戳）。
                        updatedAt:
                          type: integer
                          format: int64
                          example: 1735900115200
                          description: 最后更新时间（毫秒时间戳）。
  /sapi/v1/equity/tokenized/mint:
    post:
      summary: 铸造代币化资产 (TRADE)
      description: 从标的股票持仓铸造代币化资产。调用方的标的股票（如 `AAPL`）被销毁（或锁定），对应代币化资产（如 `AAPLB`）被划入账户。目标代币由服务端根据 `underlyingAsset` 查找；调用方只需提供标的 ticker 和数量。铸造为异步操作：接口立即返回 `issuerRequestId` 及临时状态；轮询 `/tokenized/convert-status` 查看终态，或查询 `/tokenized/history` 获取完整记录。频率限制：50 次 / 分钟（UID）。
      tags:
        - tokenized
      operationId: tokenizedMint
      externalDocs:
        url: https://developers.binance.com/en/docs/catalog/advanced-trading-stocks-trading/api/rest-api/tokenized#tokenized-mint
      x-connectors-examples:
        ts: https://raw.githubusercontent.com/binance/binance-connector-js/master/clients/stocks/examples/rest-api/TokenizedApi/tokenizedMint.ts
        rust: https://raw.githubusercontent.com/binance/binance-connector-rust/main/examples/stocks/rest_api/tokenized_api/tokenized_mint.rs
        python: https://raw.githubusercontent.com/binance/binance-connector-python/master/clients/stocks/examples/rest_api/Tokenized/tokenized_mint.py
        java: https://raw.githubusercontent.com/binance/binance-connector-java/master/examples/stocks/src/main/java/com/binance/connector/client/stocks/rest/tokenized/TokenizedMintExample.java
        go: https://raw.githubusercontent.com/binance/binance-connector-go/main/clients/stocks/examples/restapi/TokenizedAPI/TokenizedMint/TokenizedMint.go
        php: https://raw.githubusercontent.com/binance/binance-connector-php/master/examples/stocks/tokenized/TokenizedMintExample.php
      x-security-type: TRADE
      x-signed: true
      x-weight: 1
      parameters:
        - name: X-MBX-APIKEY
          in: header
          required: true
          description: 访问此接口需要 API Key，并且必须在请求头中携带。关于如何创建 API Key，请参考：https://www.binance.com/cn/support/faq/detail/360002502072。
          schema:
            type: string
            example: API_KEY
        - name: underlyingAsset
          in: query
          required: true
          schema:
            type: string
            example: AAPL
          description: 标的美股 ticker，例如 `AAPL`、`TSLA`。在上架 symbol 列表中解析；未知 ticker 返回 `-26004`。目标代币化资产通过 `/market/tokenized-assets` 接口根据此字段查找。
        - name: underlyingAssetAmount
          in: query
          required: true
          schema:
            type: string
            example: '1'
          description: 铸造所需标的资产数量，必须大于 0。
        - name: clientOrderId
          in: query
          required: false
          schema:
            type: string
            example: mint-client-id-32chars-0000000001
          description: 客户端幂等 ID，格式 `^[a-zA-Z0-9-_]{32,36}$`，不传则自动生成。
        - name: recvWindow
          in: query
          required: false
          schema:
            type: integer
            format: int64
            example: 5000
          description: 赋值不能大于 `60000`。
        - name: timestamp
          in: query
          required: true
          schema:
            type: integer
            format: int64
            example: 1770736694138
          description: 时间戳（毫秒）。
      responses:
        '200':
          description: 铸造响应
          content:
            application/json:
              schema:
                type: object
                properties:
                  issuerRequestId:
                    type: string
                    example: mint-20260505-8f3b9e1a2d3c4b5a
                    description: 服务端分配的转换请求 ID，用于轮询 `/tokenized/convert-status`。
                  status:
                    type: string
                    example: P
                    enum:
                      - P
                      - S
                      - F
                    description: 转换状态码：`P` = 处理中，`S` = 成功，`F` = 失败。
  /sapi/v1/equity/tokenized/redeem:
    post:
      summary: 赎回代币化资产 (TRADE)
      description: 将代币化资产赎回为标的股票。调用方的代币化资产（如 `AAPLB`）被销毁，对应标的股票（如 `AAPL`）被释放。目标标的由服务端根据 `tokenizedAsset` 查找；调用方只需提供代币化资产和数量。赎回为异步操作：接口立即返回 `issuerRequestId` 及临时状态；轮询 `/tokenized/convert-status` 查看终态，或查询 `/tokenized/history` 获取完整记录。频率限制：50 次 / 分钟（UID）。
      tags:
        - tokenized
      operationId: tokenizedRedeem
      externalDocs:
        url: https://developers.binance.com/en/docs/catalog/advanced-trading-stocks-trading/api/rest-api/tokenized#tokenized-redeem
      x-connectors-examples:
        ts: https://raw.githubusercontent.com/binance/binance-connector-js/master/clients/stocks/examples/rest-api/TokenizedApi/tokenizedRedeem.ts
        rust: https://raw.githubusercontent.com/binance/binance-connector-rust/main/examples/stocks/rest_api/tokenized_api/tokenized_redeem.rs
        python: https://raw.githubusercontent.com/binance/binance-connector-python/master/clients/stocks/examples/rest_api/Tokenized/tokenized_redeem.py
        java: https://raw.githubusercontent.com/binance/binance-connector-java/master/examples/stocks/src/main/java/com/binance/connector/client/stocks/rest/tokenized/TokenizedRedeemExample.java
        go: https://raw.githubusercontent.com/binance/binance-connector-go/main/clients/stocks/examples/restapi/TokenizedAPI/TokenizedRedeem/TokenizedRedeem.go
        php: https://raw.githubusercontent.com/binance/binance-connector-php/master/examples/stocks/tokenized/TokenizedRedeemExample.php
      x-security-type: TRADE
      x-signed: true
      x-weight: 1
      parameters:
        - name: X-MBX-APIKEY
          in: header
          required: true
          description: 访问此接口需要 API Key，并且必须在请求头中携带。关于如何创建 API Key，请参考：https://www.binance.com/cn/support/faq/detail/360002502072。
          schema:
            type: string
            example: API_KEY
        - name: tokenizedAsset
          in: query
          required: true
          schema:
            type: string
            example: AAPLB
          description: 要赎回的代币化资产，例如 `AAPLB`。这不是美股 ticker，而是链上代币化资产标识符。未知资产返回 `-1102`（当前报错信息称参数为空/畸形，但其实已发送、只是不存在）。目标标的 ticker 通过 `/market/tokenized-assets` 接口根据此字段查找。
        - name: tokenizedAssetAmount
          in: query
          required: true
          schema:
            type: string
            example: '1'
          description: 要赎回的代币化资产数量，必须大于 0。
        - name: clientOrderId
          in: query
          required: false
          schema:
            type: string
            example: redeem-client-id-32chars-000000001
          description: 客户端幂等 ID，格式 `^[a-zA-Z0-9-_]{32,36}$`，不传则自动生成。
        - name: recvWindow
          in: query
          required: false
          schema:
            type: integer
            format: int64
            example: 5000
          description: 赋值不能大于 `60000`。
        - name: timestamp
          in: query
          required: true
          schema:
            type: integer
            format: int64
            example: 1770736694138
          description: 时间戳（毫秒）。
      responses:
        '200':
          description: 赎回响应
          content:
            application/json:
              schema:
                type: object
                properties:
                  issuerRequestId:
                    type: string
                    example: redeem-20260505-a1b2c3d4e5f6
                    description: 服务端分配的转换请求 ID，用于轮询 `/tokenized/convert-status`。
                  status:
                    type: string
                    example: P
                    enum:
                      - P
                      - S
                      - F
                    description: 转换状态码：`P` = 处理中，`S` = 成功，`F` = 失败。
  /sapi/v1/equity/tokenized/convert-status:
    get:
      summary: 代币化转换状态 (USER_DATA)
      description: 通过 `issuerRequestId` 查询单笔铸造 / 赎回请求的当前状态。无匹配记录时返回空对象（仅限调用方 ID 范围）。
      tags:
        - tokenized
      operationId: tokenizedConvertStatus
      externalDocs:
        url: https://developers.binance.com/en/docs/catalog/advanced-trading-stocks-trading/api/rest-api/tokenized#tokenized-convert-status
      x-connectors-examples:
        ts: https://raw.githubusercontent.com/binance/binance-connector-js/master/clients/stocks/examples/rest-api/TokenizedApi/tokenizedConvertStatus.ts
        rust: https://raw.githubusercontent.com/binance/binance-connector-rust/main/examples/stocks/rest_api/tokenized_api/tokenized_convert_status.rs
        python: https://raw.githubusercontent.com/binance/binance-connector-python/master/clients/stocks/examples/rest_api/Tokenized/tokenized_convert_status.py
        java: https://raw.githubusercontent.com/binance/binance-connector-java/master/examples/stocks/src/main/java/com/binance/connector/client/stocks/rest/tokenized/TokenizedConvertStatusExample.java
        go: https://raw.githubusercontent.com/binance/binance-connector-go/main/clients/stocks/examples/restapi/TokenizedAPI/TokenizedConvertStatus/TokenizedConvertStatus.go
        php: https://raw.githubusercontent.com/binance/binance-connector-php/master/examples/stocks/tokenized/TokenizedConvertStatusExample.php
      x-security-type: USER_DATA
      x-signed: true
      x-weight: 1
      parameters:
        - name: X-MBX-APIKEY
          in: header
          required: true
          description: 访问此接口需要 API Key，并且必须在请求头中携带。关于如何创建 API Key，请参考：https://www.binance.com/cn/support/faq/detail/360002502072。
          schema:
            type: string
            example: API_KEY
        - name: issuerRequestId
          in: query
          required: true
          schema:
            type: string
            example: mint-20260505-8f3b9e1a2d3c4b5a
          description: 由 `/tokenized/mint` 或 `/tokenized/redeem` 返回的转换请求 ID。
        - name: convertType
          in: query
          required: true
          schema:
            type: string
            enum:
              - MINT
              - REDEEM
            example: MINT
          description: '`MINT` 或 `REDEEM`。'
        - name: recvWindow
          in: query
          required: false
          schema:
            type: integer
            format: int64
            example: 5000
          description: 赋值不能大于 `60000`。
        - name: timestamp
          in: query
          required: true
          schema:
            type: integer
            format: int64
            example: 1770736694138
          description: 时间戳（毫秒）。
      responses:
        '200':
          description: 代币化转换状态
          content:
            application/json:
              schema:
                type: object
                description: 无匹配记录时返回空对象 `{}`。
                properties:
                  underlyingAsset:
                    type: string
                    example: AAPL
                    description: 标的美股 ticker，例如 `AAPL`。
                  underlyingAssetAmount:
                    type: string
                    example: '1.000000000'
                    description: 涉及的标的资产数量。
                  tokenizedAsset:
                    type: string
                    example: AAPLB
                    description: 代币化资产，例如 `AAPLB`。
                  tokenizedAssetAmount:
                    type: string
                    example: '1.000000000'
                    description: 涉及的代币化资产数量。
                  issuerRequestId:
                    type: string
                    example: mint-20260505-8f3b9e1a2d3c4b5a
                    description: 回显请求的 ID。
                  convertType:
                    type: string
                    example: MINT
                    description: '`MINT` 或 `REDEEM`。'
                  status:
                    type: string
                    example: S
                    enum:
                      - P
                      - S
                      - F
                    description: 转换状态：`P` = 处理中，`S` = 成功，`F` = 失败。
                  createdAt:
                    type: integer
                    format: int64
                    example: 1735900000000
                    description: 创建时间（毫秒时间戳）。
                  updatedAt:
                    type: integer
                    format: int64
                    example: 1735900060000
                    description: 最后更新时间（毫秒时间戳）。
  /sapi/v1/equity/tokenized/history:
    get:
      summary: 代币化转换历史 (USER_DATA)
      description: 调用方的分页铸造 / 赎回转换历史。游标分页——提供上一页响应中的 `nextLastId` 作为 `lastId` 来获取下一页。
      tags:
        - tokenized
      operationId: tokenizedConvertHistory
      externalDocs:
        url: https://developers.binance.com/en/docs/catalog/advanced-trading-stocks-trading/api/rest-api/tokenized#tokenized-convert-history
      x-connectors-examples:
        ts: https://raw.githubusercontent.com/binance/binance-connector-js/master/clients/stocks/examples/rest-api/TokenizedApi/tokenizedConvertHistory.ts
        rust: https://raw.githubusercontent.com/binance/binance-connector-rust/main/examples/stocks/rest_api/tokenized_api/tokenized_convert_history.rs
        python: https://raw.githubusercontent.com/binance/binance-connector-python/master/clients/stocks/examples/rest_api/Tokenized/tokenized_convert_history.py
        java: https://raw.githubusercontent.com/binance/binance-connector-java/master/examples/stocks/src/main/java/com/binance/connector/client/stocks/rest/tokenized/TokenizedConvertHistoryExample.java
        go: https://raw.githubusercontent.com/binance/binance-connector-go/main/clients/stocks/examples/restapi/TokenizedAPI/TokenizedConvertHistory/TokenizedConvertHistory.go
        php: https://raw.githubusercontent.com/binance/binance-connector-php/master/examples/stocks/tokenized/TokenizedConvertHistoryExample.php
      x-security-type: USER_DATA
      x-signed: true
      x-weight: 1
      parameters:
        - name: X-MBX-APIKEY
          in: header
          required: true
          description: 访问此接口需要 API Key，并且必须在请求头中携带。关于如何创建 API Key，请参考：https://www.binance.com/cn/support/faq/detail/360002502072。
          schema:
            type: string
            example: API_KEY
        - name: startTime
          in: query
          required: false
          schema:
            type: integer
            format: int64
            example: 1735800000000
          description: 开始时间（毫秒时间戳）。
        - name: endTime
          in: query
          required: false
          schema:
            type: integer
            format: int64
            example: 1735900000000
          description: 结束时间（毫秒时间戳）。
        - name: lastId
          in: query
          required: false
          schema:
            type: integer
            format: int64
            example: 10019
          description: 上一页最后一条记录的 ID。省略（或不传）表示从第一页开始。
        - name: size
          in: query
          required: false
          schema:
            type: integer
            example: 20
          description: 每页大小，默认 `20`，最大 `100`。
        - name: recvWindow
          in: query
          required: false
          schema:
            type: integer
            format: int64
            example: 5000
          description: 赋值不能大于 `60000`。
        - name: timestamp
          in: query
          required: true
          schema:
            type: integer
            format: int64
            example: 1770736694138
          description: 时间戳（毫秒）。
      responses:
        '200':
          description: 代币化转换历史
          content:
            application/json:
              schema:
                type: object
                properties:
                  rows:
                    type: array
                    description: 本页转换历史列表，无匹配时为空数组。
                    items:
                      type: object
                      properties:
                        underlyingAsset:
                          type: string
                          example: AAPL
                          description: 标的美股 ticker，例如 `AAPL`。
                        underlyingAssetAmount:
                          type: string
                          example: '1.000000000'
                          description: 涉及的标的资产数量。
                        tokenizedAsset:
                          type: string
                          example: AAPLB
                          description: 代币化资产，例如 `AAPLB`。
                        tokenizedAssetAmount:
                          type: string
                          example: '1.000000000'
                          description: 涉及的代币化资产数量。
                        issuerRequestId:
                          type: string
                          example: mint-20260505-8f3b9e1a2d3c4b5a
                          description: 转换请求 ID。
                        convertType:
                          type: string
                          example: MINT
                          description: '`MINT` 或 `REDEEM`。'
                        status:
                          type: string
                          example: S
                          enum:
                            - P
                            - S
                            - F
                          description: 转换状态：`P` = 处理中，`S` = 成功，`F` = 失败。
                        createdAt:
                          type: integer
                          format: int64
                          example: 1735900000000
                          description: 创建时间（毫秒时间戳）。
                        updatedAt:
                          type: integer
                          format: int64
                          example: 1735900060000
                          description: 最后更新时间（毫秒时间戳）。
                  hasMore:
                    type: boolean
                    example: true
                    description: 还有更多页时为 `true`——将 `nextLastId` 作为下次请求的 `lastId`。
                  nextLastId:
                    type: integer
                    format: int64
                    example: 10020
                    description: 将此值作为下次请求的 `lastId` 以获取下一页。
  /sapi/v1/equity/account/disclaimer:
    post:
      summary: 签署美股免责声明 (TRADE)
      description: 记录用户对美股免责声明的确认与接受。账户必须先完成此步骤，才能使用部分美股交易功能。接受状态与该 API key 关联的账户绑定。
      tags:
        - account
      operationId: signUsEquityDisclaimer
      externalDocs:
        url: https://developers.binance.com/en/docs/catalog/advanced-trading-stocks-trading/api/rest-api/account#sign-us-equity-disclaimer
      x-connectors-examples:
        ts: https://raw.githubusercontent.com/binance/binance-connector-js/master/clients/stocks/examples/rest-api/AccountApi/signUsEquityDisclaimer.ts
        rust: https://raw.githubusercontent.com/binance/binance-connector-rust/main/examples/stocks/rest_api/account_api/sign_us_equity_disclaimer.rs
        python: https://raw.githubusercontent.com/binance/binance-connector-python/master/clients/stocks/examples/rest_api/Account/sign_us_equity_disclaimer.py
        java: https://raw.githubusercontent.com/binance/binance-connector-java/master/examples/stocks/src/main/java/com/binance/connector/client/stocks/rest/account/SignUsEquityDisclaimerExample.java
        go: https://raw.githubusercontent.com/binance/binance-connector-go/main/clients/stocks/examples/restapi/AccountAPI/SignUsEquityDisclaimer/SignUsEquityDisclaimer.go
        php: https://raw.githubusercontent.com/binance/binance-connector-php/master/examples/stocks/account/SignUsEquityDisclaimerExample.php
      x-security-type: TRADE
      x-signed: true
      x-weight: 1
      parameters:
        - name: X-MBX-APIKEY
          in: header
          required: true
          description: 访问此接口需要 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
            format: int64
            example: 5000
          description: 赋值不能大于 `60000`。
        - name: timestamp
          in: query
          required: true
          schema:
            type: integer
            format: int64
            example: 1770736694138
          description: 时间戳（毫秒）。
      responses:
        '200':
          description: 签署美股免责声明响应
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    example: true
                    description: '`true` = 已成功记录接受。'
  /sapi/v1/equity/listenKey:
    post:
      summary: 创建 / 续期 Listen Key (USER_STREAM)
      description: 创建新的 股票用户数据流 `listenKey`，或对已有的 `listenKey` 续期。对同一用户调用此接口且有活跃 `listenKey` 时，会延长其有效期；无活跃 key 时则创建新 key。使用返回的 `listenKey` 订阅 股票用户数据流。
      tags:
        - user-data-streams
      operationId: createRenewListenKey
      externalDocs:
        url: https://developers.binance.com/en/docs/catalog/advanced-trading-stocks-trading/api/rest-api/user-data-streams#create-renew-listen-key
      x-connectors-examples:
        ts: https://raw.githubusercontent.com/binance/binance-connector-js/master/clients/stocks/examples/rest-api/UserDataStreamsApi/createRenewListenKey.ts
        rust: https://raw.githubusercontent.com/binance/binance-connector-rust/main/examples/stocks/rest_api/user_data_streams_api/create_renew_listen_key.rs
        python: https://raw.githubusercontent.com/binance/binance-connector-python/master/clients/stocks/examples/rest_api/UserDataStreams/create_renew_listen_key.py
        java: https://raw.githubusercontent.com/binance/binance-connector-java/master/examples/stocks/src/main/java/com/binance/connector/client/stocks/rest/userdatastreams/CreateRenewListenKeyExample.java
        go: https://raw.githubusercontent.com/binance/binance-connector-go/main/clients/stocks/examples/restapi/UserDataStreamsAPI/CreateRenewListenKey/CreateRenewListenKey.go
        php: https://raw.githubusercontent.com/binance/binance-connector-php/master/examples/stocks/userdatastreams/CreateRenewListenKeyExample.php
      x-security-type: USER_STREAM
      x-weight: 1
      parameters:
        - name: X-MBX-APIKEY
          in: header
          required: true
          description: 访问此接口需要 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
            format: int64
            example: 5000
          description: 赋值不能大于 `60000`。
        - name: timestamp
          in: query
          required: true
          schema:
            type: integer
            format: int64
            example: 1770736694138
          description: 时间戳（毫秒）。
      responses:
        '200':
          description: 创建 / 续期 Listen Key 响应
          content:
            application/json:
              schema:
                type: object
                properties:
                  listenKey:
                    type: string
                    example: pqia91ma19a5s61cv6a81va65sdf19v8a65s1cv1zuz3ee1c5xz2ef6ad7
                    description: 股票用户数据流的会话标识符。
