openapi: 3.0.2
info:
  title: Spot REST API
  description: 访问市场数据、管理账户，并在 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/spot/rest-api#访问限制
x-security-guide: products/spot/rest-api#请求鉴权类型
x-api-key-guide: https://www.binance.com/cn/support/faq/detail/360002502072
externalDocs:
  description: Spot docs
  url: https://developers.binance.com/en/docs/products/spot
tags:
  - name: general
    x-displayName: 通用
  - name: market
    x-displayName: 行情
  - name: trade
    x-displayName: 交易
  - name: account
    x-displayName: 账户
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
  - url: https://demo-api.binance.com
  - url: https://data-api.binance.vision
  - url: https://testnet.binance.vision
  - url: https://api1.testnet.binance.vision
paths:
  /api/v3/account/commission:
    get:
      summary: 查询佣金费率 (USER_DATA)
      description: 获取当前账户的佣金费率。
      tags:
        - account
      operationId: accountCommission
      externalDocs:
        url: https://developers.binance.com/en/docs/catalog/core-trading-spot-trading/api/rest-api/account#account-commission
      x-connectors-examples:
        ts: https://raw.githubusercontent.com/binance/binance-connector-js/master/clients/spot/examples/rest-api/AccountApi/accountCommission.ts
        rust: https://raw.githubusercontent.com/binance/binance-connector-rust/main/examples/spot/rest_api/account_api/account_commission.rs
        python: https://raw.githubusercontent.com/binance/binance-connector-python/master/clients/spot/examples/rest_api/Account/account_commission.py
        java: https://raw.githubusercontent.com/binance/binance-connector-java/master/examples/spot/src/main/java/com/binance/connector/client/spot/rest/account/AccountCommissionExample.java
        go: https://raw.githubusercontent.com/binance/binance-connector-go/main/clients/spot/examples/restapi/AccountAPI/AccountCommission/AccountCommission.go
        php: https://raw.githubusercontent.com/binance/binance-connector-php/master/examples/spot/account/AccountCommissionExample.php
      x-ip-weight: 20
      x-security-type: USER_DATA
      x-signed: true
      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: BTCUSDT
        - name: timestamp
          in: query
          required: true
          schema:
            type: integer
            example: 1770736694138
            format: int64
          description: 用于请求签名的 Unix 时间戳，单位为毫秒. 该值必须反映客户端当前时间，并会在签名接口中由服务器进行校验.
      x-parameters-notes: '**数据源:** 数据库'
      responses:
        '200':
          description: 查询佣金费率
          content:
            application/json:
              schema:
                type: object
                properties:
                  symbol:
                    type: string
                    example: BTCUSDT
                  standardCommission:
                    type: object
                    properties:
                      maker:
                        type: string
                        example: '0.00000010'
                      taker:
                        type: string
                        example: '0.00000020'
                      buyer:
                        type: string
                        example: '0.00000030'
                      seller:
                        type: string
                        example: '0.00000040'
                    description: 订单交易的标准佣金率。
                  specialCommission:
                    type: object
                    properties:
                      maker:
                        type: string
                        example: '0.01000000'
                      taker:
                        type: string
                        example: '0.02000000'
                      buyer:
                        type: string
                        example: '0.03000000'
                      seller:
                        type: string
                        example: '0.04000000'
                    description: 订单交易的特殊佣金率。
                  taxCommission:
                    type: object
                    properties:
                      maker:
                        type: string
                        example: '0.00000112'
                      taker:
                        type: string
                        example: '0.00000114'
                      buyer:
                        type: string
                        example: '0.00000118'
                      seller:
                        type: string
                        example: '0.00000116'
                    description: 订单交易的税率。
                  discount:
                    type: object
                    properties:
                      enabledForAccount:
                        type: boolean
                        example: true
                      enabledForSymbol:
                        type: boolean
                        example: true
                      discountAsset:
                        type: string
                        example: BNB
                      discount:
                        type: string
                        example: '0.75000000'
                        description: 当用BNB支付佣金时，在标准佣金上按此比率打折
                    description: 使用BNB支付时的佣金折扣。
  /api/v3/allOrderList:
    get:
      summary: 查询所有订单列表 (USER_DATA)
      description: |-
        根据提供的可选参数检索所有的订单列表。

        请注意，`startTime`和`endTime`之间的时间不能超过 24 小时。
      tags:
        - account
      operationId: allOrderList
      externalDocs:
        url: https://developers.binance.com/en/docs/catalog/core-trading-spot-trading/api/rest-api/account#all-order-list
      x-connectors-examples:
        ts: https://raw.githubusercontent.com/binance/binance-connector-js/master/clients/spot/examples/rest-api/AccountApi/allOrderList.ts
        rust: https://raw.githubusercontent.com/binance/binance-connector-rust/main/examples/spot/rest_api/account_api/all_order_list.rs
        python: https://raw.githubusercontent.com/binance/binance-connector-python/master/clients/spot/examples/rest_api/Account/all_order_list.py
        java: https://raw.githubusercontent.com/binance/binance-connector-java/master/examples/spot/src/main/java/com/binance/connector/client/spot/rest/account/AllOrderListExample.java
        go: https://raw.githubusercontent.com/binance/binance-connector-go/main/clients/spot/examples/restapi/AccountAPI/AllOrderList/AllOrderList.go
        php: https://raw.githubusercontent.com/binance/binance-connector-php/master/examples/spot/account/AllOrderListExample.php
      x-ip-weight: 20
      x-security-type: USER_DATA
      x-signed: true
      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: fromId
          in: query
          required: false
          description: 提供该项后, startTime 和 endTime 都不可提供
          schema:
            type: integer
            format: int64
            example: 1
        - name: startTime
          in: query
          required: false
          schema:
            type: integer
            format: int64
            example: 1735693200000
        - name: endTime
          in: query
          required: false
          schema:
            type: integer
            format: int64
            example: 1735693200000
        - name: limit
          in: query
          required: false
          schema:
            type: integer
            example: 1
            default: 500
            maximum: 1000
        - name: recvWindow
          in: query
          required: false
          description: 支持最多三位小数的精度（例如 6000.346），以便可以指定微秒。
          schema:
            type: number
            format: float
            example: 5000
            maximum: 60000
        - name: timestamp
          in: query
          required: true
          schema:
            type: integer
            example: 1770736694138
            format: int64
          description: 用于请求签名的 Unix 时间戳，单位为毫秒. 该值必须反映客户端当前时间，并会在签名接口中由服务器进行校验.
      x-parameters-notes: '**数据源**: 数据库'
      responses:
        '200':
          description: 查询所有订单列表
          content:
            application/json:
              schema:
                type: array
                items:
                  type: object
                  properties:
                    orderListId:
                      type: integer
                      format: int64
                      example: 29
                    contingencyType:
                      type: string
                      example: OCO
                    listStatusType:
                      type: string
                      example: EXEC_STARTED
                    listOrderStatus:
                      type: string
                      example: EXECUTING
                    listClientOrderId:
                      type: string
                      example: amEEAXryFzFwYF1FeRpUoZ
                    transactionTime:
                      type: integer
                      format: int64
                      example: 1565245913483
                    symbol:
                      type: string
                      example: LTCBTC
                    orders:
                      type: array
                      items:
                        type: object
                        properties:
                          symbol:
                            type: string
                            example: LTCBTC
                          orderId:
                            type: integer
                            format: int64
                            example: 4
                          clientOrderId:
                            type: string
                            example: oD7aesZqjEGlZrbtRpy5zB
  /api/v3/allOrders:
    get:
      summary: All 订单 (USER_DATA)
      description: 获取all 账户 订单; active, canceled, 或 filled.
      tags:
        - account
      operationId: allOrders
      externalDocs:
        url: https://developers.binance.com/en/docs/catalog/core-trading-spot-trading/api/rest-api/account#all-orders
      x-connectors-examples:
        ts: https://raw.githubusercontent.com/binance/binance-connector-js/master/clients/spot/examples/rest-api/AccountApi/allOrders.ts
        rust: https://raw.githubusercontent.com/binance/binance-connector-rust/main/examples/spot/rest_api/account_api/all_orders.rs
        python: https://raw.githubusercontent.com/binance/binance-connector-python/master/clients/spot/examples/rest_api/Account/all_orders.py
        java: https://raw.githubusercontent.com/binance/binance-connector-java/master/examples/spot/src/main/java/com/binance/connector/client/spot/rest/account/AllOrdersExample.java
        go: https://raw.githubusercontent.com/binance/binance-connector-go/main/clients/spot/examples/restapi/AccountAPI/AllOrders/AllOrders.go
        php: https://raw.githubusercontent.com/binance/binance-connector-php/master/examples/spot/account/AllOrdersExample.php
      x-ip-weight: 20
      x-security-type: USER_DATA
      x-signed: true
      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: LTCBTC
        - name: orderId
          in: query
          required: false
          schema:
            type: integer
            format: int64
            example: 1
        - name: startTime
          in: query
          required: false
          schema:
            type: integer
            format: int64
            example: 1735693200000
        - name: endTime
          in: query
          required: false
          schema:
            type: integer
            format: int64
            example: 1735693200000
        - name: limit
          in: query
          required: false
          schema:
            type: integer
            example: 1
            default: 500
            maximum: 1000
        - name: recvWindow
          in: query
          required: false
          description: 最大值为 `60000` 毫秒。 <br> 支持最多三位小数的精度（例如 6000.346），以便可以指定微秒。
          schema:
            type: number
            format: float
            example: 5000
        - name: timestamp
          in: query
          required: true
          schema:
            type: integer
            example: 1770736694138
            format: int64
          description: 用于请求签名的 Unix 时间戳，单位为毫秒. 该值必须反映客户端当前时间，并会在签名接口中由服务器进行校验.
      x-parameters-notes: |-
        **数据源**: 数据库

        - **注意:** * 如设置 `orderId` , 订单量将 >= `orderId`。否则将返回最新订单。
        - 一些历史订单 `cummulativeQuoteQty` < 0, 是指数据此时不存在。
        - 如果设置 `startTime` 和 `endTime`, `orderId` 就不需要设置。
        - `startTime`和`endTime`之间的时间不能超过 24 小时。 **数据源:** 数据库
      responses:
        '200':
          description: All 订单
          content:
            application/json:
              schema:
                type: array
                items:
                  type: object
                  properties:
                    symbol:
                      type: string
                      example: LTCBTC
                    orderId:
                      type: integer
                      format: int64
                      example: 1
                    orderListId:
                      type: integer
                      format: int64
                      example: -1
                      description: 除非此单是订单列表的一部分, 否则此值为 -1
                    clientOrderId:
                      type: string
                      example: myOrder1
                    price:
                      type: string
                      example: '0.1'
                    origQty:
                      type: string
                      example: '1.0'
                    executedQty:
                      type: string
                      example: '0.0'
                    cummulativeQuoteQty:
                      type: string
                      example: '0.0'
                    status:
                      type: string
                      example: NEW
                    timeInForce:
                      type: string
                      example: GTC
                    type:
                      type: string
                      example: LIMIT
                    side:
                      type: string
                      example: BUY
                    stopPrice:
                      type: string
                      example: '0.00000000'
                      description: 出现在 STOP_LOSS, TAKE_PROFIT, STOP_LOSS_LIMIT 和 TAKE_PROFIT_LIMIT 订单中。
                    icebergQty:
                      type: string
                      example: '0.00000000'
                      description: 仅在请求中发送了 icebergQty 参数时出现。
                    time:
                      type: integer
                      format: int64
                      example: 1499827319559
                    updateTime:
                      type: integer
                      format: int64
                      example: 1499827319559
                    isWorking:
                      type: boolean
                      example: true
                    origQuoteOrderQty:
                      type: string
                      example: '0.000000'
                    workingTime:
                      type: integer
                      format: int64
                      example: 1499827319559
                    selfTradePreventionMode:
                      type: string
                      example: NONE
                    preventedMatchId:
                      type: integer
                      format: int64
                      example: 0
                      description: 仅在因 STP 导致订单失效时出现。
                    preventedQuantity:
                      type: string
                      example: '1.200000'
                      description: 因 STP 导致订单失效的数量。
                    strategyId:
                      type: integer
                      format: int64
                      example: 1
                      description: 仅在下单时提供了 strategyId 参数时出现。
                    strategyType:
                      type: integer
                      format: int64
                      example: 1000000
                      description: 仅在下单时提供了 strategyType 参数时出现。
                    trailingDelta:
                      type: integer
                      format: int64
                      example: 10
                      description: 订单激活前所需的价格变动。
                    trailingTime:
                      type: integer
                      format: int64
                      example: -1
                      description: 追踪单被激活和跟踪价格变化的时间。
                    usedSor:
                      type: boolean
                      example: true
                      description: 用于确定订单是否使用SOR的字段。
                    workingFloor:
                      type: string
                      example: SOR
                      description: 用以定义订单是通过 SOR 还是由订单簿成交的。
                    pegPriceType:
                      type: string
                      example: PRIMARY_PEG
                      description: 挂钩价格类型。仅用于挂钩订单。
                    pegOffsetType:
                      type: string
                      example: PRICE_LEVEL
                      description: 挂钩价格偏移类型。如若需要，仅用于挂钩订单。
                    pegOffsetValue:
                      type: integer
                      format: int64
                      example: 5
                      description: 挂钩价格偏移值。如若需要，仅用于挂钩订单。
                    peggedPrice:
                      type: string
                      example: '87523.83710000'
                      description: 订单对应的当前挂钩价格。一旦确定，仅用于挂钩订单。
                    expiryReason:
                      type: string
                      example: INSUFFICIENT_LIQUIDITY
                      description: 订单过期的原因。当订单过期时出现。
  /api/v3/account:
    get:
      summary: 账户信息 (USER_DATA)
      description: 获取当前账户信息。
      tags:
        - account
      operationId: getAccount
      externalDocs:
        url: https://developers.binance.com/en/docs/catalog/core-trading-spot-trading/api/rest-api/account#get-account
      x-connectors-examples:
        ts: https://raw.githubusercontent.com/binance/binance-connector-js/master/clients/spot/examples/rest-api/AccountApi/getAccount.ts
        rust: https://raw.githubusercontent.com/binance/binance-connector-rust/main/examples/spot/rest_api/account_api/get_account.rs
        python: https://raw.githubusercontent.com/binance/binance-connector-python/master/clients/spot/examples/rest_api/Account/get_account.py
        java: https://raw.githubusercontent.com/binance/binance-connector-java/master/examples/spot/src/main/java/com/binance/connector/client/spot/rest/account/GetAccountExample.java
        go: https://raw.githubusercontent.com/binance/binance-connector-go/main/clients/spot/examples/restapi/AccountAPI/GetAccount/GetAccount.go
        php: https://raw.githubusercontent.com/binance/binance-connector-php/master/examples/spot/account/GetAccountExample.php
      x-ip-weight: 20
      x-security-type: USER_DATA
      x-signed: true
      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: omitZeroBalances
          in: query
          required: false
          description: 如果`true`，将隐藏所有零余额。
          schema:
            type: boolean
            example: false
            default: false
        - name: recvWindow
          in: query
          required: false
          description: 支持最多三位小数的精度（例如 6000.346），以便可以指定微秒。
          schema:
            type: number
            format: float
            example: 5000
            maximum: 60000
        - name: timestamp
          in: query
          required: true
          schema:
            type: integer
            example: 1770736694138
            format: int64
          description: 用于请求签名的 Unix 时间戳，单位为毫秒. 该值必须反映客户端当前时间，并会在签名接口中由服务器进行校验.
      x-parameters-notes: '**数据源:** 缓存 => 数据库'
      responses:
        '200':
          description: 账户信息
          content:
            application/json:
              schema:
                type: object
                properties:
                  makerCommission:
                    type: integer
                    format: int64
                    example: 15
                  takerCommission:
                    type: integer
                    format: int64
                    example: 15
                  buyerCommission:
                    type: integer
                    format: int64
                    example: 0
                  sellerCommission:
                    type: integer
                    format: int64
                    example: 0
                  commissionRates:
                    type: object
                    properties:
                      maker:
                        type: string
                        example: '0.00150000'
                      taker:
                        type: string
                        example: '0.00150000'
                      buyer:
                        type: string
                        example: '0.00000000'
                      seller:
                        type: string
                        example: '0.00000000'
                  canTrade:
                    type: boolean
                    example: true
                  canWithdraw:
                    type: boolean
                    example: true
                  canDeposit:
                    type: boolean
                    example: true
                  brokered:
                    type: boolean
                    example: false
                  requireSelfTradePrevention:
                    type: boolean
                    example: false
                  preventSor:
                    type: boolean
                    example: false
                  updateTime:
                    type: integer
                    format: int64
                    example: 123456789
                  accountType:
                    type: string
                    example: SPOT
                  balances:
                    type: array
                    items:
                      type: object
                      properties:
                        asset:
                          type: string
                          example: BTC
                        free:
                          type: string
                          example: '4723846.89208129'
                        locked:
                          type: string
                          example: '0.00000000'
                  permissions:
                    type: array
                    items:
                      type: string
                      example: SPOT
                  uid:
                    type: integer
                    format: int64
                    example: 354937868
  /api/v3/openOrders:
    get:
      summary: 查看账户当前挂单 (USER_DATA)
      description: 请小心使用不带symbol参数的调用
      tags:
        - account
      operationId: getOpenOrders
      externalDocs:
        url: https://developers.binance.com/en/docs/catalog/core-trading-spot-trading/api/rest-api/account#get-open-orders
      x-connectors-examples:
        ts: https://raw.githubusercontent.com/binance/binance-connector-js/master/clients/spot/examples/rest-api/AccountApi/getOpenOrders.ts
        rust: https://raw.githubusercontent.com/binance/binance-connector-rust/main/examples/spot/rest_api/account_api/get_open_orders.rs
        python: https://raw.githubusercontent.com/binance/binance-connector-python/master/clients/spot/examples/rest_api/Account/get_open_orders.py
        java: https://raw.githubusercontent.com/binance/binance-connector-java/master/examples/spot/src/main/java/com/binance/connector/client/spot/rest/account/GetOpenOrdersExample.java
        go: https://raw.githubusercontent.com/binance/binance-connector-go/main/clients/spot/examples/restapi/AccountAPI/GetOpenOrders/GetOpenOrders.go
        php: https://raw.githubusercontent.com/binance/binance-connector-php/master/examples/spot/account/GetOpenOrdersExample.php
      x-security-type: USER_DATA
      x-signed: true
      x-weight: 6 for a single symbol; 80 when the symbol parameter is omitted
      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: LTCBTC
        - name: recvWindow
          in: query
          required: false
          description: 支持最多三位小数的精度（例如 6000.346），以便可以指定微秒。
          schema:
            type: number
            format: float
            example: 5000
            maximum: 60000
        - name: timestamp
          in: query
          required: true
          schema:
            type: integer
            example: 1770736694138
            format: int64
          description: 用于请求签名的 Unix 时间戳，单位为毫秒. 该值必须反映客户端当前时间，并会在签名接口中由服务器进行校验.
      x-parameters-notes: |-
        **数据源:** 缓存 => 数据库

        - 不带symbol参数，会返回所有交易对的挂单
      responses:
        '200':
          description: 查看账户当前挂单
          content:
            application/json:
              schema:
                type: array
                items:
                  type: object
                  properties:
                    symbol:
                      type: string
                      example: LTCBTC
                    orderId:
                      type: integer
                      format: int64
                      example: 1
                    orderListId:
                      type: integer
                      format: int64
                      example: -1
                      description: 除非此单是订单列表的一部分, 否则此值为 -1
                    clientOrderId:
                      type: string
                      example: myOrder1
                    price:
                      type: string
                      example: '0.1'
                    origQty:
                      type: string
                      example: '1.0'
                    executedQty:
                      type: string
                      example: '0.0'
                    origQuoteOrderQty:
                      type: string
                      example: '0.000000'
                    cummulativeQuoteQty:
                      type: string
                      example: '0.0'
                    status:
                      type: string
                      example: NEW
                    timeInForce:
                      type: string
                      example: GTC
                    type:
                      type: string
                      example: LIMIT
                    side:
                      type: string
                      example: BUY
                    stopPrice:
                      type: string
                      example: '0.00000000'
                      description: 出现在 STOP_LOSS, TAKE_PROFIT, STOP_LOSS_LIMIT 和 TAKE_PROFIT_LIMIT 订单中。
                    icebergQty:
                      type: string
                      example: '0.00000000'
                      description: 仅在请求中发送了 icebergQty 参数时出现。
                    time:
                      type: integer
                      format: int64
                      example: 1499827319559
                    updateTime:
                      type: integer
                      format: int64
                      example: 1499827319559
                    isWorking:
                      type: boolean
                      example: true
                    workingTime:
                      type: integer
                      format: int64
                      example: 1499827319559
                    selfTradePreventionMode:
                      type: string
                      example: NONE
                    preventedMatchId:
                      type: integer
                      format: int64
                      example: 0
                      description: 仅在因 STP 导致订单失效时出现。
                    preventedQuantity:
                      type: string
                      example: '1.200000'
                      description: 因 STP 导致订单失效的数量。
                    strategyId:
                      type: integer
                      format: int64
                      example: 1
                      description: 仅在下单时提供了 strategyId 参数时出现。
                    strategyType:
                      type: integer
                      format: int64
                      example: 1000000
                      description: 仅在下单时提供了 strategyType 参数时出现。
                    trailingDelta:
                      type: integer
                      format: int64
                      example: 10
                      description: 订单激活前所需的价格变动。
                    trailingTime:
                      type: integer
                      format: int64
                      example: -1
                      description: 追踪单被激活和跟踪价格变化的时间。
                    usedSor:
                      type: boolean
                      example: true
                      description: 用于确定订单是否使用SOR的字段。
                    workingFloor:
                      type: string
                      example: SOR
                      description: 用以定义订单是通过 SOR 还是由订单簿成交的。
                    pegPriceType:
                      type: string
                      example: PRIMARY_PEG
                      description: 挂钩价格类型。仅用于挂钩订单。
                    pegOffsetType:
                      type: string
                      example: PRICE_LEVEL
                      description: 挂钩价格偏移类型。如若需要，仅用于挂钩订单。
                    pegOffsetValue:
                      type: integer
                      format: int64
                      example: 5
                      description: 挂钩价格偏移值。如若需要，仅用于挂钩订单。
                    peggedPrice:
                      type: string
                      example: '87523.83710000'
                      description: 订单对应的当前挂钩价格。一旦确定，仅用于挂钩订单。
                    expiryReason:
                      type: string
                      example: INSUFFICIENT_LIQUIDITY
                      description: 订单过期的原因。当订单过期时出现。
    delete:
      summary: 撤销单一交易对的所有挂单 (TRADE)
      description: 撤销单一交易对下所有挂单。这也包括了来自订单列表的挂单。
      tags:
        - trade
      operationId: deleteOpenOrders
      externalDocs:
        url: https://developers.binance.com/en/docs/catalog/core-trading-spot-trading/api/rest-api/trade#delete-open-orders
      x-connectors-examples:
        ts: https://raw.githubusercontent.com/binance/binance-connector-js/master/clients/spot/examples/rest-api/TradeApi/deleteOpenOrders.ts
        rust: https://raw.githubusercontent.com/binance/binance-connector-rust/main/examples/spot/rest_api/trade_api/delete_open_orders.rs
        python: https://raw.githubusercontent.com/binance/binance-connector-python/master/clients/spot/examples/rest_api/Trade/delete_open_orders.py
        java: https://raw.githubusercontent.com/binance/binance-connector-java/master/examples/spot/src/main/java/com/binance/connector/client/spot/rest/trade/DeleteOpenOrdersExample.java
        go: https://raw.githubusercontent.com/binance/binance-connector-go/main/clients/spot/examples/restapi/TradeAPI/DeleteOpenOrders/DeleteOpenOrders.go
        php: https://raw.githubusercontent.com/binance/binance-connector-php/master/examples/spot/trade/DeleteOpenOrdersExample.php
      x-ip-weight: 1
      x-security-type: TRADE
      x-signed: true
      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: BNBUSDT
        - name: recvWindow
          in: query
          required: false
          description: 支持最多三位小数的精度（例如 6000.346），以便可以指定微秒。
          schema:
            type: number
            format: float
            example: 5000
            maximum: 60000
        - name: timestamp
          in: query
          required: true
          schema:
            type: integer
            example: 1770736694138
            format: int64
          description: 用于请求签名的 Unix 时间戳，单位为毫秒. 该值必须反映客户端当前时间，并会在签名接口中由服务器进行校验.
      x-parameters-notes: '**数据源:** 撮合引擎'
      responses:
        '200':
          description: 撤销单一交易对的所有挂单
          content:
            application/json:
              schema:
                type: array
                items:
                  type: object
                  properties:
                    symbol:
                      type: string
                      example: BTCUSDT
                    origClientOrderId:
                      type: string
                      example: E6APeyTJvkMvLMYMqu1KQ4
                    orderId:
                      type: integer
                      format: int64
                      example: 11
                    orderListId:
                      type: integer
                      format: int64
                      example: -1
                    clientOrderId:
                      type: string
                      example: pXLV6Hz6mprAcVYpVMTGgx
                    transactTime:
                      type: integer
                      format: int64
                      example: 1684804350068
                    price:
                      type: string
                      example: '0.089853'
                    origQty:
                      type: string
                      example: '0.178622'
                    executedQty:
                      type: string
                      example: '0.000000'
                    origQuoteOrderQty:
                      type: string
                      example: '0.000000'
                    cummulativeQuoteQty:
                      type: string
                      example: '0.000000'
                    status:
                      type: string
                      example: CANCELED
                    timeInForce:
                      type: string
                      example: GTC
                    type:
                      type: string
                      example: LIMIT
                    side:
                      type: string
                      example: BUY
                    selfTradePreventionMode:
                      type: string
                      example: NONE
  /api/v3/order:
    get:
      summary: 查询订单 (USER_DATA)
      description: 查询订单状态
      tags:
        - account
      operationId: getOrder
      externalDocs:
        url: https://developers.binance.com/en/docs/catalog/core-trading-spot-trading/api/rest-api/account#get-order
      x-connectors-examples:
        ts: https://raw.githubusercontent.com/binance/binance-connector-js/master/clients/spot/examples/rest-api/AccountApi/getOrder.ts
        rust: https://raw.githubusercontent.com/binance/binance-connector-rust/main/examples/spot/rest_api/account_api/get_order.rs
        python: https://raw.githubusercontent.com/binance/binance-connector-python/master/clients/spot/examples/rest_api/Account/get_order.py
        java: https://raw.githubusercontent.com/binance/binance-connector-java/master/examples/spot/src/main/java/com/binance/connector/client/spot/rest/account/GetOrderExample.java
        go: https://raw.githubusercontent.com/binance/binance-connector-go/main/clients/spot/examples/restapi/AccountAPI/GetOrder/GetOrder.go
        php: https://raw.githubusercontent.com/binance/binance-connector-php/master/examples/spot/account/GetOrderExample.php
      x-ip-weight: 4
      x-security-type: USER_DATA
      x-signed: true
      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: LTCBTC
        - name: orderId
          in: query
          required: false
          schema:
            type: integer
            format: int64
            example: 1
        - name: origClientOrderId
          in: query
          required: false
          schema:
            type: string
            example: myOrder1
        - name: recvWindow
          in: query
          required: false
          description: 支持最多三位小数的精度（例如 6000.346），以便可以指定微秒。
          schema:
            type: number
            format: float
            example: 5000
            maximum: 60000
        - name: timestamp
          in: query
          required: true
          schema:
            type: integer
            example: 1770736694138
            format: int64
          description: 用于请求签名的 Unix 时间戳，单位为毫秒. 该值必须反映客户端当前时间，并会在签名接口中由服务器进行校验.
      x-parameters-notes: |-
        **数据源:** 缓存 => 数据库

        - 至少需要发送 `orderId` 与 `origClientOrderId`中的一个。
        - 当同时提供 `orderId` 和 `origClientOrderId` 两个参数时，系统首先将会使用 `orderId` 来搜索订单。然后， 查找结果中的 `origClientOrderId` 的值将会被用来验证订单。如果两个条件都不满足，则请求将被拒绝。
        - 某些历史订单的 `cummulativeQuoteQty` 会 < 0, 表示当前暂无该数据。
      responses:
        '200':
          description: 查询订单
          content:
            application/json:
              schema:
                type: object
                properties:
                  symbol:
                    type: string
                    example: LTCBTC
                    description: symbol.
                  orderId:
                    type: integer
                    format: int64
                    example: 1
                    description: order Id.
                  orderListId:
                    type: integer
                    format: int64
                    example: -1
                    description: 除非此单是订单列表的一部分, 否则此值为 -1
                  clientOrderId:
                    type: string
                    example: myOrder1
                    description: client Order Id.
                  price:
                    type: string
                    example: '0.1'
                    description: price.
                  origQty:
                    type: string
                    example: '1.0'
                    description: orig Qty.
                  executedQty:
                    type: string
                    example: '0.0'
                    description: executed Qty.
                  origQuoteOrderQty:
                    type: string
                    example: '0.000000'
                    description: orig Quote Order Qty.
                  cummulativeQuoteQty:
                    type: string
                    example: '0.0'
                    description: cummulative Quote Qty.
                  status:
                    type: string
                    example: NEW
                    description: status.
                  timeInForce:
                    type: string
                    example: GTC
                    description: time In Force.
                  type:
                    type: string
                    example: LIMIT
                    description: type.
                  side:
                    type: string
                    example: BUY
                    description: side.
                  stopPrice:
                    type: string
                    example: '0.00000000'
                    description: 出现在 STOP_LOSS, TAKE_PROFIT, STOP_LOSS_LIMIT 和 TAKE_PROFIT_LIMIT 订单中。
                  icebergQty:
                    type: string
                    example: '0.00000000'
                    description: 仅在请求中发送了 icebergQty 参数时出现。
                  time:
                    type: integer
                    format: int64
                    example: 1499827319559
                    description: time.
                  updateTime:
                    type: integer
                    format: int64
                    example: 1499827319559
                    description: update Time.
                  isWorking:
                    type: boolean
                    example: true
                    description: is Working.
                  workingTime:
                    type: integer
                    format: int64
                    example: 1499827319559
                    description: working Time.
                  selfTradePreventionMode:
                    type: string
                    example: NONE
                    description: self Trade Prevention Mode.
                  preventedMatchId:
                    type: integer
                    format: int64
                    example: 0
                    description: 仅在因 STP 导致订单失效时出现。
                  preventedQuantity:
                    type: string
                    example: '1.200000'
                    description: 因 STP 导致订单失效的数量。
                  strategyId:
                    type: integer
                    format: int64
                    example: 1
                    description: 仅在下单时提供了 strategyId 参数时出现。
                  strategyType:
                    type: integer
                    format: int64
                    example: 1000000
                    description: 仅在下单时提供了 strategyType 参数时出现。
                  trailingDelta:
                    type: integer
                    format: int64
                    example: 10
                    description: 订单激活前所需的价格变动。
                  trailingTime:
                    type: integer
                    format: int64
                    example: -1
                    description: 追踪单被激活和跟踪价格变化的时间。
                  usedSor:
                    type: boolean
                    example: true
                    description: 用于确定订单是否使用SOR的字段。
                  workingFloor:
                    type: string
                    example: SOR
                    description: 用以定义订单是通过 SOR 还是由订单簿成交的。
                  pegPriceType:
                    type: string
                    example: PRIMARY_PEG
                    description: 挂钩价格类型。仅用于挂钩订单。
                  pegOffsetType:
                    type: string
                    example: PRICE_LEVEL
                    description: 挂钩价格偏移类型。如若需要，仅用于挂钩订单。
                  pegOffsetValue:
                    type: integer
                    format: int64
                    example: 5
                    description: 挂钩价格偏移值。如若需要，仅用于挂钩订单。
                  peggedPrice:
                    type: string
                    example: '87523.83710000'
                    description: 订单对应的当前挂钩价格。一旦确定，仅用于挂钩订单。
                  expiryReason:
                    type: string
                    example: INSUFFICIENT_LIQUIDITY
                    description: 订单过期的原因。当订单过期时出现。
    delete:
      summary: 撤销订单 (TRADE)
      description: 撤销订单.
      tags:
        - trade
      operationId: deleteOrder
      externalDocs:
        url: https://developers.binance.com/en/docs/catalog/core-trading-spot-trading/api/rest-api/trade#delete-order
      x-connectors-examples:
        ts: https://raw.githubusercontent.com/binance/binance-connector-js/master/clients/spot/examples/rest-api/TradeApi/deleteOrder.ts
        rust: https://raw.githubusercontent.com/binance/binance-connector-rust/main/examples/spot/rest_api/trade_api/delete_order.rs
        python: https://raw.githubusercontent.com/binance/binance-connector-python/master/clients/spot/examples/rest_api/Trade/delete_order.py
        java: https://raw.githubusercontent.com/binance/binance-connector-java/master/examples/spot/src/main/java/com/binance/connector/client/spot/rest/trade/DeleteOrderExample.java
        go: https://raw.githubusercontent.com/binance/binance-connector-go/main/clients/spot/examples/restapi/TradeAPI/DeleteOrder/DeleteOrder.go
        php: https://raw.githubusercontent.com/binance/binance-connector-php/master/examples/spot/trade/DeleteOrderExample.php
      x-ip-weight: 1
      x-security-type: TRADE
      x-signed: true
      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: BNBUSDT
        - name: orderId
          in: query
          required: false
          schema:
            type: integer
            format: int64
            example: 1
        - name: origClientOrderId
          in: query
          required: false
          schema:
            type: string
            example: myOrder1
        - name: newClientOrderId
          in: query
          required: false
          description: 用户自定义的本次撤销操作的ID(注意不是被撤销的订单的自定义ID)。如无指定会自动赋值。
          schema:
            type: string
            example: cancelMyOrder1
        - name: cancelRestrictions
          in: query
          required: false
          schema:
            type: string
            enum:
              - ONLY_NEW
              - ONLY_PARTIALLY_FILLED
            example: ONLY_NEW
          description: '支持的值: <br>`ONLY_NEW` - 如果订单状态为 `NEW`，撤销将成功。<br> `ONLY_PARTIALLY_FILLED` - 如果订单状态为 `PARTIALLY_FILLED`，撤销将成功。'
        - name: recvWindow
          in: query
          required: false
          description: 支持最多三位小数的精度（例如 6000.346），以便可以指定微秒。
          schema:
            type: number
            format: float
            example: 5000
            maximum: 60000
        - name: timestamp
          in: query
          required: true
          schema:
            type: integer
            example: 1770736694138
            format: int64
          description: 用于请求签名的 Unix 时间戳，单位为毫秒. 该值必须反映客户端当前时间，并会在签名接口中由服务器进行校验.
      x-parameters-notes: |-
        **数据源:** 撮合引擎

        - `orderId` 与 `origClientOrderId` 必须至少发送一个。
        - 当同时提供 `orderId` 和 `origClientOrderId` 两个参数时，系统首先将会使用 `orderId` 来搜索订单。然后， 查找结果中的 `origClientOrderId` 的值将会被用来验证订单。如果两个条件都不满足，则请求将被拒绝。
      responses:
        '200':
          description: 撤销订单
          content:
            application/json:
              schema:
                type: object
                additionalProperties: false
                properties:
                  symbol:
                    type: string
                    example: LTCBTC
                  orderId:
                    type: integer
                    format: int64
                    example: 4
                  orderListId:
                    type: integer
                    format: int64
                    example: -1
                    description: 除非此单是订单列表的一部分, 否则此值为 -1
                  origClientOrderId:
                    type: string
                    example: myOrder1
                  clientOrderId:
                    type: string
                    example: cancelMyOrder1
                  transactTime:
                    type: integer
                    format: int64
                    example: 1684804350068
                  price:
                    type: string
                    example: '2.00000000'
                  origQty:
                    type: string
                    example: '1.00000000'
                  executedQty:
                    type: string
                    example: '0.00000000'
                  origQuoteOrderQty:
                    type: string
                    example: '0.000000'
                  cummulativeQuoteQty:
                    type: string
                    example: '0.00000000'
                  status:
                    type: string
                    example: CANCELED
                  timeInForce:
                    type: string
                    example: GTC
                  type:
                    type: string
                    example: LIMIT
                  side:
                    type: string
                    example: BUY
                  selfTradePreventionMode:
                    type: string
                    example: NONE
                  icebergQty:
                    type: string
                    example: '0.00000000'
                    description: 冰山订单数量。仅当请求中发送了 `icebergQty` 参数时返回。
                  preventedMatchId:
                    type: integer
                    format: int64
                    example: 0
                    description: 与 `symbol` 搭配时可用于查询 prevented match。仅当订单因 STP 过期时返回。
                  preventedQuantity:
                    type: string
                    example: '1.200000'
                    description: 因 STP 过期的订单数量。仅当订单因 STP 过期时返回。
                  stopPrice:
                    type: string
                    example: '23500.00000000'
                    description: 算法订单触发价格。适用于 `STOP_LOSS`、`TAKE_PROFIT`、`STOP_LOSS_LIMIT` 和 `TAKE_PROFIT_LIMIT` 订单。
                  strategyId:
                    type: integer
                    format: int64
                    example: 37463720
                    description: 可用于标记订单策略中的订单。仅当请求中传入该参数时返回。
                  strategyType:
                    type: integer
                    format: int64
                    example: 1000000
                    description: 可用于标记使用订单策略的订单。仅当请求中传入该参数时返回。
                  trailingDelta:
                    type: integer
                    format: int64
                    example: 10
                    description: 订单激活前所需的价格变动幅度。适用于追踪止损订单。
                  trailingTime:
                    type: integer
                    format: int64
                    example: -1
                    description: 追踪订单激活并开始跟踪价格变化的时间。仅适用于追踪止损订单。
                  usedSor:
                    type: boolean
                    example: true
                    description: 表示订单是否使用了 SOR。仅在使用 SOR 下单时返回。
                  workingFloor:
                    type: string
                    example: SOR
                    description: 表示订单由 SOR 撮合还是由提交到的订单簿撮合。仅在使用 SOR 下单时返回。
                  pegPriceType:
                    type: string
                    example: PRIMARY_PEG
                    description: Peg 价格类型。仅适用于 pegged 订单。
                  pegOffsetType:
                    type: string
                    example: PRICE_LEVEL
                    description: Peg 价格偏移类型。仅适用于请求了该字段的 pegged 订单。
                  pegOffsetValue:
                    type: integer
                    format: int64
                    example: 5
                    description: Peg 价格偏移值。仅适用于请求了该字段的 pegged 订单。
                  peggedPrice:
                    type: string
                    example: '87523.83710000'
                    description: 订单当前 peg 到的价格。仅适用于已确定 peg 价格的订单。
                  expiryReason:
                    type: string
                    example: INSUFFICIENT_LIQUIDITY
                    description: 订单过期原因。仅当订单已过期时返回。
    post:
      summary: 下单 (TRADE)
      description: 这个请求会把1个订单添加到 `EXCHANGE_MAX_ORDERS` 过滤器和 `MAX_NUM_ORDERS` 过滤器中。
      tags:
        - trade
      operationId: newOrder
      externalDocs:
        url: https://developers.binance.com/en/docs/catalog/core-trading-spot-trading/api/rest-api/trade#new-order
      x-connectors-examples:
        ts: https://raw.githubusercontent.com/binance/binance-connector-js/master/clients/spot/examples/rest-api/TradeApi/newOrder.ts
        rust: https://raw.githubusercontent.com/binance/binance-connector-rust/main/examples/spot/rest_api/trade_api/new_order.rs
        python: https://raw.githubusercontent.com/binance/binance-connector-python/master/clients/spot/examples/rest_api/Trade/new_order.py
        java: https://raw.githubusercontent.com/binance/binance-connector-java/master/examples/spot/src/main/java/com/binance/connector/client/spot/rest/trade/NewOrderExample.java
        go: https://raw.githubusercontent.com/binance/binance-connector-go/main/clients/spot/examples/restapi/TradeAPI/NewOrder/NewOrder.go
        php: https://raw.githubusercontent.com/binance/binance-connector-php/master/examples/spot/trade/NewOrderExample.php
      x-ip-weight: 1
      x-order-weight: 1
      x-security-type: TRADE
      x-signed: true
      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
      x-parameters-notes: |-
        **数据源:** 撮合引擎

        根据 order `type`的不同，某些参数 有强制要求，具体如下:

        Type | 强制要求的参数 | 其他信息
        ------------ | ------------ | ------------
        `LIMIT` | `timeInForce`, `quantity`, `price`
        `MARKET` | `quantity` |  市价买卖单可用`quantity`参数来设置`base asset`数量.<br/> 例如：BTCUSDT 市价单，BTC 买卖数量取决于`quantity`参数. <br/><br/>市价买卖单可用`quoteOrderQty`参数来设置`quote asset`数量. 正确的`quantity`取决于市场的流动性与`quoteOrderQty`<br/> 例如: 市价 `BUY` BTCUSDT，单子会基于`quoteOrderQty`- USDT 的数量，购买 BTC.<br/> 市价 `SELL` BTCUSDT，单子会卖出 BTC 来满足`quoteOrderQty`- USDT 的数量.
        `STOP_LOSS` | `quantity`, `stopPrice`, `trailingDelta` | 条件满足后会下`MARKET`单子. (例如：达到`stopPrice`或`trailingDelta`被启动)
        `STOP_LOSS_LIMIT` | `timeInForce`, `quantity`,  `price`, `stopPrice`, `trailingDelta`
        `TAKE_PROFIT` | `quantity`, `stopPrice`, `trailingDelta` | 条件满足后会下`MARKET`单子. (例如：达到`stopPrice`或`trailingDelta`被启动)
        `TAKE_PROFIT_LIMIT` | `timeInForce`, `quantity`, `price`, `stopPrice`, `trailingDelta`
        `LIMIT_MAKER` | `quantity`, `price` | 订单大部分情况下与普通的限价单没有区别，但是如果在当前价格会立即吃对手单并成交则下单会被拒绝。因此使用这个订单类型可以保证订单一定是挂单方，不会成为吃单方。


        关于挂钩订单参数的注意事项：
        * 这些参数仅适用于 `LIMIT`， `LIMIT_MAKER`， `STOP_LOSS_LIMIT` 和 `TAKE_PROFIT_LIMIT` 订单。
        * 如果使用了 `pegPriceType`， 那么 `price` 字段将是可选的。 否则，`price` 字段依旧是必须的。
        * `pegPriceType=PRIMARY_PEG` 就是主要挂钩（`primary`），这是订单簿上与您的订单同一方向的最佳价格。
        * `pegPriceType=MARKET_PEG` 就是市场挂钩（`market`），这是订单簿上与您的订单相反方向的最佳价格。
        * 可以通过使用 `pegOffsetType` 和 `pegOffsetValue` 来获取最佳价格以外的价格水平。 这两个参数必须一起使用。

        其他:
        * 任何`LIMIT`或`LIMIT_MAKER`只要填`icebergQty`参数都可以下冰上订单。
        * 冰山订单的 `timeInForce`必须设置为`GTC`。
        * `STOP_LOSS`, `STOP_LOSS_LIMIT`, `TAKE_PROFIT_LIMIT` 与 `TAKE_PROFIT` 单子都能同时填上`trailingDelta`与`stopPrice`。
        * 填上`quoteOrderQty`的市价单不会触犯过滤器的`LOT_SIZE`限制。订单的`quantity`会尽量满足`quoteOrderQty`的数量。

        条件单的触发价格必须:
        * 比下单时当前市价高: `STOP_LOSS` `BUY`, `TAKE_PROFIT` `SELL`
        * 比下单时当前市价低: `STOP_LOSS` `SELL`, `TAKE_PROFIT` `BUY`
      requestBody:
        required: true
        content:
          application/x-www-form-urlencoded:
            schema:
              type: object
              required:
                - symbol
                - side
                - type
                - timestamp
              properties:
                symbol:
                  type: string
                  example: BNBUSDT
                side:
                  type: string
                  enum:
                    - BUY
                    - SELL
                  example: BUY
                  description: 详见枚举定义：[订单方向](/products/spot/enums#side)
                type:
                  type: string
                  enum:
                    - MARKET
                    - LIMIT
                    - STOP_LOSS
                    - STOP_LOSS_LIMIT
                    - TAKE_PROFIT
                    - TAKE_PROFIT_LIMIT
                    - LIMIT_MAKER
                  example: MARKET
                  description: 详见枚举定义：[订单类型](/products/spot/enums#ordertypes)
                timeInForce:
                  type: string
                  enum:
                    - GTC
                    - IOC
                    - FOK
                  example: GTC
                  description: 详见枚举定义：[生效时间](/products/spot/enums#timeinforce)
                quantity:
                  type: number
                  format: float
                  example: 1
                quoteOrderQty:
                  type: number
                  format: float
                  example: 1
                price:
                  type: number
                  format: float
                  example: 400
                newClientOrderId:
                  type: string
                  example: myOrder1
                  description: 用户自定义的orderid，如空缺系统会自动赋值。
                strategyId:
                  type: integer
                  format: int64
                  example: 1
                strategyType:
                  type: integer
                  example: 1
                  minimum: 1000000
                  description: 不能低于 `1000000`。
                stopPrice:
                  type: number
                  format: float
                  example: 1
                  description: 仅 `STOP_LOSS`, `STOP_LOSS_LIMIT`, `TAKE_PROFIT`, `TAKE_PROFIT_LIMIT` 需要此参数。
                trailingDelta:
                  type: integer
                  format: int64
                  example: 1
                  description: 参见 追踪止盈止损(Trailing Stop)订单常见问题
                icebergQty:
                  type: number
                  format: float
                  example: 1
                  description: 仅有限价单(包括条件限价单与限价做事单)可以使用该参数，含义为创建冰山订单并指定冰山订单的数量。
                newOrderRespType:
                  type: string
                  example: ACK
                  enum:
                    - ACK
                    - RESULT
                    - FULL
                  description: '`MARKET` 与 `LIMIT` 订单默认为`FULL`, 其他默认为`ACK`。'
                selfTradePreventionMode:
                  type: string
                  enum:
                    - NONE
                    - EXPIRE_TAKER
                    - EXPIRE_MAKER
                    - EXPIRE_BOTH
                    - DECREMENT
                    - TRANSFER
                  example: NONE
                  description: 允许的 ENUM 取决于交易对的配置。
                pegPriceType:
                  type: string
                  enum:
                    - PRIMARY_PEG
                    - MARKET_PEG
                  example: PRIMARY_PEG
                  description: 参阅 关于挂钩订单参数的注意事项
                pegOffsetValue:
                  type: integer
                  example: 1
                  maximum: 100
                  description: 用于挂钩的价格水平（最大值：100）。参阅 关于挂钩订单参数的注意事项
                pegOffsetType:
                  type: string
                  enum:
                    - PRICE_LEVEL
                  example: PRICE_LEVEL
                  description: 仅支持 `PRICE_LEVEL`。参阅 关于挂钩订单参数的注意事项
                recvWindow:
                  type: number
                  format: float
                  example: 5000
                  maximum: 60000
                  description: 最大值为 `60000` 毫秒。 <br> 支持最多三位小数的精度（例如 6000.346），以便可以指定微秒。
                timestamp:
                  type: integer
                  example: 1770736694138
                  format: int64
                  description: 用于请求签名的 Unix 时间戳，单位为毫秒. 该值必须反映客户端当前时间，并会在签名接口中由服务器进行校验.
      responses:
        '200':
          description: 下单
          content:
            application/json:
              schema:
                type: object
                properties:
                  symbol:
                    type: string
                    example: BTCUSDT
                  orderId:
                    type: integer
                    format: int64
                    example: 28
                  orderListId:
                    type: integer
                    format: int64
                    example: -1
                    description: 除非此单是订单列表的一部分, 否则此值为 -1
                  clientOrderId:
                    type: string
                    example: 6gCrw2kRUAF9CvJDGP16IP
                  transactTime:
                    type: integer
                    format: int64
                    example: 1507725176595
                  price:
                    type: string
                    example: 1
                  origQty:
                    type: string
                    example: 10
                  executedQty:
                    type: string
                    example: 10
                  origQuoteOrderQty:
                    type: string
                    example: 0
                  cummulativeQuoteQty:
                    type: string
                    example: 10
                  status:
                    type: string
                    example: FILLED
                  timeInForce:
                    type: string
                    example: GTC
                  type:
                    type: string
                    example: MARKET
                  side:
                    type: string
                    example: SELL
                  workingTime:
                    type: integer
                    format: int64
                    example: 1507725176595
                  selfTradePreventionMode:
                    type: string
                    example: NONE
                  fills:
                    type: array
                    items:
                      type: object
                      properties:
                        price:
                          type: string
                          example: 4000
                        qty:
                          type: string
                          example: 1
                        commission:
                          type: string
                          example: 4
                        commissionAsset:
                          type: string
                          example: USDT
                        tradeId:
                          type: integer
                          format: int64
                          example: 56
  /api/v3/orderList:
    get:
      summary: 查询订单列表 (USER_DATA)
      description: 根据提供的可选参数检索特定的订单列表。
      tags:
        - account
      operationId: getOrderList
      externalDocs:
        url: https://developers.binance.com/en/docs/catalog/core-trading-spot-trading/api/rest-api/account#get-order-list
      x-connectors-examples:
        ts: https://raw.githubusercontent.com/binance/binance-connector-js/master/clients/spot/examples/rest-api/AccountApi/getOrderList.ts
        rust: https://raw.githubusercontent.com/binance/binance-connector-rust/main/examples/spot/rest_api/account_api/get_order_list.rs
        python: https://raw.githubusercontent.com/binance/binance-connector-python/master/clients/spot/examples/rest_api/Account/get_order_list.py
        java: https://raw.githubusercontent.com/binance/binance-connector-java/master/examples/spot/src/main/java/com/binance/connector/client/spot/rest/account/GetOrderListExample.java
        go: https://raw.githubusercontent.com/binance/binance-connector-go/main/clients/spot/examples/restapi/AccountAPI/GetOrderList/GetOrderList.go
        php: https://raw.githubusercontent.com/binance/binance-connector-php/master/examples/spot/account/GetOrderListExample.php
      x-ip-weight: 4
      x-security-type: USER_DATA
      x-signed: true
      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: orderListId
          in: query
          required: false
          description: 通过 `orderListId` 获取订单列表。必须提供 `orderListId` 或 `origClientOrderId`。
          schema:
            type: integer
            format: int64
            example: 27
        - name: origClientOrderId
          in: query
          required: false
          schema:
            type: string
            example: 1
          description: 通过 `listClientOrderId` 查询订单列表。`orderListId` 或 `origClientOrderId` 必须被提供。
        - name: recvWindow
          in: query
          required: false
          description: 支持最多三位小数的精度（例如 6000.346），以便可以指定微秒。
          schema:
            type: number
            format: float
            example: 5000
            maximum: 60000
        - name: timestamp
          in: query
          required: true
          schema:
            type: integer
            example: 1770736694138
            format: int64
          description: 用于请求签名的 Unix 时间戳，单位为毫秒. 该值必须反映客户端当前时间，并会在签名接口中由服务器进行校验.
      x-parameters-notes: '**数据源**: 数据库'
      responses:
        '200':
          description: 查询订单列表
          content:
            application/json:
              schema:
                type: object
                properties:
                  orderListId:
                    type: integer
                    format: int64
                    example: 27
                  contingencyType:
                    type: string
                    example: OCO
                  listStatusType:
                    type: string
                    example: EXEC_STARTED
                  listOrderStatus:
                    type: string
                    example: EXECUTING
                  listClientOrderId:
                    type: string
                    example: h2USkA5YQpaXHPIrkd96xE
                  transactionTime:
                    type: integer
                    format: int64
                    example: 1565245656253
                  symbol:
                    type: string
                    example: LTCBTC
                  orders:
                    type: array
                    items:
                      type: object
                      properties:
                        symbol:
                          type: string
                          example: LTCBTC
                        orderId:
                          type: integer
                          format: int64
                          example: 4
                        clientOrderId:
                          type: string
                          example: qD1gy3kc3Gx0rihm9Y3xwS
    delete:
      summary: 取消订单列表 (TRADE)
      description: 取消整个订单列表。
      tags:
        - trade
      operationId: deleteOrderList
      externalDocs:
        url: https://developers.binance.com/en/docs/catalog/core-trading-spot-trading/api/rest-api/trade#delete-order-list
      x-connectors-examples:
        ts: https://raw.githubusercontent.com/binance/binance-connector-js/master/clients/spot/examples/rest-api/TradeApi/deleteOrderList.ts
        rust: https://raw.githubusercontent.com/binance/binance-connector-rust/main/examples/spot/rest_api/trade_api/delete_order_list.rs
        python: https://raw.githubusercontent.com/binance/binance-connector-python/master/clients/spot/examples/rest_api/Trade/delete_order_list.py
        java: https://raw.githubusercontent.com/binance/binance-connector-java/master/examples/spot/src/main/java/com/binance/connector/client/spot/rest/trade/DeleteOrderListExample.java
        go: https://raw.githubusercontent.com/binance/binance-connector-go/main/clients/spot/examples/restapi/TradeAPI/DeleteOrderList/DeleteOrderList.go
        php: https://raw.githubusercontent.com/binance/binance-connector-php/master/examples/spot/trade/DeleteOrderListExample.php
      x-ip-weight: 1
      x-security-type: TRADE
      x-signed: true
      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: BNBUSDT
        - name: orderListId
          in: query
          required: false
          description: '`orderListId` 或 `listClientOrderId` 必须被提供'
          schema:
            type: integer
            format: int64
            example: 1
        - name: listClientOrderId
          in: query
          required: false
          description: '`orderListId` 或 `listClientOrderId` 必须被提供'
          schema:
            type: string
            example: C3wyj4WVEktd7u9aVBRXcN
        - name: newClientOrderId
          in: query
          required: false
          description: 用户自定义的本次撤销操作的ID(注意不是被撤销的订单的自定义ID)。如无指定会自动赋值。
          schema:
            type: string
            example: cancelMyOrder1
        - name: recvWindow
          in: query
          required: false
          description: 支持最多三位小数的精度（例如 6000.346），以便可以指定微秒。
          schema:
            type: number
            format: float
            example: 5000
            maximum: 60000
        - name: timestamp
          in: query
          required: true
          schema:
            type: integer
            example: 1770736694138
            format: int64
          description: 用于请求签名的 Unix 时间戳，单位为毫秒. 该值必须反映客户端当前时间，并会在签名接口中由服务器进行校验.
      x-parameters-notes: |-
        **数据源:** 撮合引擎

        **其他注意点:**
          - 取消订单列表中的单个订单将取消整个订单列表.
          - 当同时提供 orderListId 和 listClientOrderId 两个参数时，系统首先将会使用 orderListId 来搜索订单。然后， 查找结果中的 listClientOrderId 的值将会被用来验证订单。如果两个条件都不满足，则请求将被拒绝。
      responses:
        '200':
          description: 取消订单列表
          content:
            application/json:
              schema:
                type: object
                properties:
                  orderListId:
                    type: integer
                    format: int64
                    example: 0
                  contingencyType:
                    type: string
                    example: OCO
                  listStatusType:
                    type: string
                    example: ALL_DONE
                  listOrderStatus:
                    type: string
                    example: ALL_DONE
                  listClientOrderId:
                    type: string
                    example: C3wyj4WVEktd7u9aVBRXcN
                  transactionTime:
                    type: integer
                    format: int64
                    example: 1574040868128
                  symbol:
                    type: string
                    example: LTCBTC
                  orders:
                    type: array
                    items:
                      type: object
                      properties:
                        symbol:
                          type: string
                          example: LTCBTC
                        orderId:
                          type: integer
                          format: int64
                          example: 2
                        clientOrderId:
                          type: string
                          example: pO9ufTiFGg3nw2fOdgeOXa
                  orderReports:
                    type: array
                    items:
                      type: object
                      properties:
                        symbol:
                          type: string
                          example: LTCBTC
                        origClientOrderId:
                          type: string
                          example: pO9ufTiFGg3nw2fOdgeOXa
                        orderId:
                          type: integer
                          format: int64
                          example: 2
                        orderListId:
                          type: integer
                          format: int64
                          example: 0
                        clientOrderId:
                          type: string
                          example: unfWT8ig8i0uj6lPuYLez6
                        transactTime:
                          type: integer
                          format: int64
                          example: 1688005070874
                        price:
                          type: string
                          example: '1.00000000'
                        origQty:
                          type: string
                          example: '10.00000000'
                        executedQty:
                          type: string
                          example: '0.00000000'
                        origQuoteOrderQty:
                          type: string
                          example: '0.000000'
                        cummulativeQuoteQty:
                          type: string
                          example: '0.00000000'
                        status:
                          type: string
                          example: CANCELED
                        timeInForce:
                          type: string
                          example: GTC
                        type:
                          type: string
                          example: STOP_LOSS_LIMIT
                        side:
                          type: string
                          example: SELL
                        icebergQty:
                          type: string
                          example: '0.00000000'
                          description: 仅在请求中发送了 icebergQty 参数时出现。
                        preventedMatchId:
                          type: integer
                          format: int64
                          example: 0
                          description: 仅在因 STP 导致订单失效时出现。
                        preventedQuantity:
                          type: string
                          example: '1.200000'
                          description: 因 STP 导致订单失效的数量。
                        stopPrice:
                          type: string
                          example: '0.00000000'
                          description: 出现在 STOP_LOSS, TAKE_PROFIT, STOP_LOSS_LIMIT 和 TAKE_PROFIT_LIMIT 订单中。
                        strategyId:
                          type: integer
                          format: int64
                          example: 1
                          description: 仅在下单时提供了 strategyId 参数时出现。
                        strategyType:
                          type: integer
                          format: int64
                          example: 1000000
                          description: 仅在下单时提供了 strategyType 参数时出现。
                        trailingDelta:
                          type: integer
                          format: int64
                          example: 10
                          description: 订单激活前所需的价格变动。
                        trailingTime:
                          type: integer
                          format: int64
                          example: -1
                          description: 追踪单被激活和跟踪价格变化的时间。
                        usedSor:
                          type: boolean
                          example: true
                          description: 用于确定订单是否使用SOR的字段。
                        workingFloor:
                          type: string
                          example: SOR
                          description: 用以定义订单是通过 SOR 还是由订单簿成交的。
                        pegPriceType:
                          type: string
                          example: PRIMARY_PEG
                          description: 挂钩价格类型。仅用于挂钩订单。
                        pegOffsetType:
                          type: string
                          example: PRICE_LEVEL
                          description: 挂钩价格偏移类型。如若需要，仅用于挂钩订单。
                        pegOffsetValue:
                          type: integer
                          format: int64
                          example: 5
                          description: 挂钩价格偏移值。如若需要，仅用于挂钩订单。
                        peggedPrice:
                          type: string
                          example: '87523.83710000'
                          description: 订单对应的当前挂钩价格。一旦确定，仅用于挂钩订单。
                        expiryReason:
                          type: string
                          example: INSUFFICIENT_LIQUIDITY
                          description: 订单过期的原因。当订单过期时出现。
  /api/v3/myAllocations:
    get:
      summary: 查询分配结果 (USER_DATA)
      description: 检索由 SOR 订单生成引起的分配结果。
      tags:
        - account
      operationId: myAllocations
      externalDocs:
        url: https://developers.binance.com/en/docs/catalog/core-trading-spot-trading/api/rest-api/account#my-allocations
      x-connectors-examples:
        ts: https://raw.githubusercontent.com/binance/binance-connector-js/master/clients/spot/examples/rest-api/AccountApi/myAllocations.ts
        rust: https://raw.githubusercontent.com/binance/binance-connector-rust/main/examples/spot/rest_api/account_api/my_allocations.rs
        python: https://raw.githubusercontent.com/binance/binance-connector-python/master/clients/spot/examples/rest_api/Account/my_allocations.py
        java: https://raw.githubusercontent.com/binance/binance-connector-java/master/examples/spot/src/main/java/com/binance/connector/client/spot/rest/account/MyAllocationsExample.java
        go: https://raw.githubusercontent.com/binance/binance-connector-go/main/clients/spot/examples/restapi/AccountAPI/MyAllocations/MyAllocations.go
        php: https://raw.githubusercontent.com/binance/binance-connector-php/master/examples/spot/account/MyAllocationsExample.php
      x-ip-weight: 20
      x-security-type: USER_DATA
      x-signed: true
      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: BTCUSDT
        - name: startTime
          in: query
          required: false
          schema:
            type: integer
            format: int64
            example: 1735693200000
        - name: endTime
          in: query
          required: false
          schema:
            type: integer
            format: int64
            example: 1735693200000
        - name: fromAllocationId
          in: query
          required: false
          schema:
            type: integer
            example: 0
        - name: limit
          in: query
          required: false
          schema:
            type: integer
            example: 1
            default: 500
            maximum: 1000
        - name: orderId
          in: query
          required: false
          schema:
            type: integer
            format: int64
            example: 1
        - name: recvWindow
          in: query
          required: false
          description: 支持最多三位小数的精度（例如 6000.346），以便可以指定微秒。
          schema:
            type: number
            format: float
            example: 5000
            maximum: 60000
        - name: timestamp
          in: query
          required: true
          schema:
            type: integer
            example: 1770736694138
            format: int64
          description: 用于请求签名的 Unix 时间戳，单位为毫秒. 该值必须反映客户端当前时间，并会在签名接口中由服务器进行校验.
      x-parameters-notes: |-
        **数据源:** 数据库

        支持的参数组合:

        参数                                  | 响应 |
        ------------------------------------------- | -------- |
        `symbol`                                    | 按从最旧到最新排序的分配 |
        `symbol` + `startTime`                      | 从 `startTime` 开始的最旧的分配 |
        `symbol` + `endTime`                        | 到 `endTime` 为止的最新的分配 |
        `symbol` + `startTime` + `endTime`          | 在指定时间范围内的分配 |
        `symbol` + `fromAllocationId`               | 从指定 `AllocationId` 开始的分配  |
        `symbol` + `orderId`                        | 按从最旧到最新排序并和特定订单关联的分配 |
        `symbol` + `orderId` + `fromAllocationId`   | 从指定 `AllocationId` 开始并和特定订单关联的分配 |

        **注意:** `startTime` 和 `endTime` 之间的时间不能超过 24 小时。
      responses:
        '200':
          description: 查询分配结果
          content:
            application/json:
              schema:
                type: array
                items:
                  type: object
                  properties:
                    symbol:
                      type: string
                      example: BTCUSDT
                    allocationId:
                      type: integer
                      format: int64
                      example: 0
                    allocationType:
                      type: string
                      example: SOR
                    orderId:
                      type: integer
                      format: int64
                      example: 1
                    orderListId:
                      type: integer
                      format: int64
                      example: -1
                    price:
                      type: string
                      example: '1.00000000'
                    qty:
                      type: string
                      example: '5.00000000'
                    quoteQty:
                      type: string
                      example: '5.00000000'
                    commission:
                      type: string
                      example: '0.00000000'
                    commissionAsset:
                      type: string
                      example: BTC
                    time:
                      type: integer
                      format: int64
                      example: 1687506878118
                    isBuyer:
                      type: boolean
                      example: true
                    isMaker:
                      type: boolean
                      example: false
                    isAllocator:
                      type: boolean
                      example: false
  /api/v3/myFilters:
    get:
      summary: 查询相关过滤器 (USER_DATA)
      description: 用于检索一个账户上指定交易对的 列表。这是唯一一个目前会显示账户是否应用了 `MAX_ASSET` 过滤器的端点。
      tags:
        - account
      operationId: myFilters
      externalDocs:
        url: https://developers.binance.com/en/docs/catalog/core-trading-spot-trading/api/rest-api/account#my-filters
      x-connectors-examples:
        ts: https://raw.githubusercontent.com/binance/binance-connector-js/master/clients/spot/examples/rest-api/AccountApi/myFilters.ts
        rust: https://raw.githubusercontent.com/binance/binance-connector-rust/main/examples/spot/rest_api/account_api/my_filters.rs
        python: https://raw.githubusercontent.com/binance/binance-connector-python/master/clients/spot/examples/rest_api/Account/my_filters.py
        java: https://raw.githubusercontent.com/binance/binance-connector-java/master/examples/spot/src/main/java/com/binance/connector/client/spot/rest/account/MyFiltersExample.java
        go: https://raw.githubusercontent.com/binance/binance-connector-go/main/clients/spot/examples/restapi/AccountAPI/MyFilters/MyFilters.go
        php: https://raw.githubusercontent.com/binance/binance-connector-php/master/examples/spot/account/MyFiltersExample.php
      x-ip-weight: 40
      x-security-type: USER_DATA
      x-signed: true
      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: BNBUSDT
        - name: recvWindow
          in: query
          required: false
          description: 支持最多三位小数的精度（例如 6000.346），以便可以指定微秒。
          schema:
            type: number
            format: float
            example: 5000
            maximum: 60000
        - name: timestamp
          in: query
          required: true
          schema:
            type: integer
            example: 1770736694138
            format: int64
          description: 用于请求签名的 Unix 时间戳，单位为毫秒. 该值必须反映客户端当前时间，并会在签名接口中由服务器进行校验.
      x-parameters-notes: '**数据源:** 缓存'
      responses:
        '200':
          description: 查询相关过滤器
          content:
            application/json:
              schema:
                type: object
                properties:
                  exchangeFilters:
                    type: array
                    items:
                      oneOf:
                        - type: object
                          properties:
                            filterType:
                              type: string
                              example: EXCHANGE_MAX_NUM_ORDERS
                            maxNumOrders:
                              type: integer
                              format: int64
                              example: 1000
                        - type: object
                          properties:
                            filterType:
                              type: string
                              example: EXCHANGE_MAX_NUM_ALGO_ORDERS
                            maxNumAlgoOrders:
                              type: integer
                              format: int64
                              example: 200
                        - type: object
                          properties:
                            filterType:
                              type: string
                              example: EXCHANGE_MAX_NUM_ICEBERG_ORDERS
                            maxNumIcebergOrders:
                              type: integer
                              format: int64
                              example: 10
                        - type: object
                          properties:
                            filterType:
                              type: string
                              example: EXCHANGE_MAX_NUM_ORDER_LISTS
                            maxNumOrderLists:
                              type: integer
                              format: int64
                              example: 20
                      discriminator:
                        propertyName: filterType
                        mapping:
                          EXCHANGE_MAX_NUM_ORDERS: '#/components/schemas/ExchangeMaxNumOrdersFilter'
                          EXCHANGE_MAX_NUM_ALGO_ORDERS: '#/components/schemas/ExchangeMaxNumAlgoOrdersFilter'
                          EXCHANGE_MAX_NUM_ICEBERG_ORDERS: '#/components/schemas/ExchangeMaxNumIcebergOrdersFilter'
                          EXCHANGE_MAX_NUM_ORDER_LISTS: '#/components/schemas/ExchangeMaxNumOrderListsFilter'
                  symbolFilters:
                    type: array
                    items:
                      oneOf:
                        - type: object
                          properties:
                            filterType:
                              type: string
                              example: PRICE_FILTER
                            priceExponent:
                              type: integer
                              example: 8
                            minPrice:
                              type: string
                              example: '0.00000100'
                            maxPrice:
                              type: string
                              example: '100000.00000000'
                            tickSize:
                              type: string
                              example: '0.00000100'
                        - type: object
                          properties:
                            filterType:
                              type: string
                              example: PERCENT_PRICE
                            multiplierExponent:
                              type: integer
                              example: 4
                            multiplierUp:
                              type: string
                              example: '1.3000'
                            multiplierDown:
                              type: string
                              example: '0.7000'
                            avgPriceMins:
                              type: integer
                              example: 5
                        - type: object
                          properties:
                            filterType:
                              type: string
                              example: PERCENT_PRICE_BY_SIDE
                            multiplierExponent:
                              type: integer
                              example: 4
                            bidMultiplierUp:
                              type: string
                              example: '1.2000'
                            bidMultiplierDown:
                              type: string
                              example: '0.8000'
                            askMultiplierUp:
                              type: string
                              example: '1.2000'
                            askMultiplierDown:
                              type: string
                              example: '0.8000'
                            avgPriceMins:
                              type: integer
                              example: 5
                        - type: object
                          properties:
                            filterType:
                              type: string
                              example: LOT_SIZE
                            qtyExponent:
                              type: integer
                              example: 8
                            minQty:
                              type: string
                              example: '0.00010000'
                            maxQty:
                              type: string
                              example: '100000.00000000'
                            stepSize:
                              type: string
                              example: '0.00010000'
                        - type: object
                          properties:
                            filterType:
                              type: string
                              example: MIN_NOTIONAL
                            priceExponent:
                              type: integer
                              example: 8
                            minNotional:
                              type: string
                              example: '10.00000000'
                            applyToMarket:
                              type: boolean
                              example: true
                            avgPriceMins:
                              type: integer
                              example: 5
                        - type: object
                          properties:
                            filterType:
                              type: string
                              example: NOTIONAL
                            priceExponent:
                              type: integer
                              example: 8
                            minNotional:
                              type: string
                              example: '10.00000000'
                            applyMinToMarket:
                              type: boolean
                              example: true
                            maxNotional:
                              type: string
                              example: '100000.00000000'
                            applyMaxToMarket:
                              type: boolean
                              example: false
                            avgPriceMins:
                              type: integer
                              example: 5
                        - type: object
                          properties:
                            filterType:
                              type: string
                              example: ICEBERG_PARTS
                            limit:
                              type: integer
                              format: int64
                              example: 10
                        - type: object
                          properties:
                            filterType:
                              type: string
                              example: MARKET_LOT_SIZE
                            qtyExponent:
                              type: integer
                              example: 8
                            minQty:
                              type: string
                              example: '0.00000000'
                            maxQty:
                              type: string
                              example: '1000.00000000'
                            stepSize:
                              type: string
                              example: '0.00000000'
                        - type: object
                          properties:
                            filterType:
                              type: string
                              example: MAX_NUM_ORDERS
                            maxNumOrders:
                              type: integer
                              format: int64
                              example: 200
                        - type: object
                          properties:
                            filterType:
                              type: string
                              example: MAX_NUM_ALGO_ORDERS
                            maxNumAlgoOrders:
                              type: integer
                              format: int64
                              example: 10
                        - type: object
                          properties:
                            filterType:
                              type: string
                              example: MAX_NUM_ICEBERG_ORDERS
                            maxNumIcebergOrders:
                              type: integer
                              format: int64
                              example: 5
                        - type: object
                          properties:
                            filterType:
                              type: string
                              example: MAX_POSITION
                            qtyExponent:
                              type: integer
                              example: 8
                            maxPosition:
                              type: string
                              example: '100.00000000'
                        - type: object
                          properties:
                            filterType:
                              type: string
                              example: TRAILING_DELTA
                            minTrailingAboveDelta:
                              type: integer
                              format: int64
                              example: 10
                            maxTrailingAboveDelta:
                              type: integer
                              format: int64
                              example: 2000
                            minTrailingBelowDelta:
                              type: integer
                              format: int64
                              example: 10
                            maxTrailingBelowDelta:
                              type: integer
                              format: int64
                              example: 2000
                        - type: object
                          properties:
                            filterType:
                              type: string
                              example: T_PLUS_SELL
                            endTime:
                              type: integer
                              format: int64
                              example: 1741672924895
                        - type: object
                          properties:
                            filterType:
                              type: string
                              example: MAX_NUM_ORDER_LISTS
                            maxNumOrderLists:
                              type: integer
                              format: int64
                              example: 20
                        - type: object
                          properties:
                            filterType:
                              type: string
                              example: MAX_NUM_ORDER_AMENDS
                            maxNumOrderAmends:
                              type: integer
                              format: int64
                              example: 10
                      discriminator:
                        propertyName: filterType
                        mapping:
                          PRICE_FILTER: '#/components/schemas/PriceFilter'
                          PERCENT_PRICE: '#/components/schemas/PercentPriceFilter'
                          PERCENT_PRICE_BY_SIDE: '#/components/schemas/PercentPriceBySideFilter'
                          LOT_SIZE: '#/components/schemas/LotSizeFilter'
                          MIN_NOTIONAL: '#/components/schemas/MinNotionalFilter'
                          NOTIONAL: '#/components/schemas/NotionalFilter'
                          ICEBERG_PARTS: '#/components/schemas/IcebergPartsFilter'
                          MARKET_LOT_SIZE: '#/components/schemas/MarketLotSizeFilter'
                          MAX_NUM_ORDERS: '#/components/schemas/MaxNumOrdersFilter'
                          MAX_NUM_ALGO_ORDERS: '#/components/schemas/MaxNumAlgoOrdersFilter'
                          MAX_NUM_ICEBERG_ORDERS: '#/components/schemas/MaxNumIcebergOrdersFilter'
                          MAX_POSITION: '#/components/schemas/MaxPositionFilter'
                          TRAILING_DELTA: '#/components/schemas/TrailingDeltaFilter'
                          T_PLUS_SELL: '#/components/schemas/TPlusSellFilter'
                          MAX_NUM_ORDER_LISTS: '#/components/schemas/MaxNumOrderListsFilter'
                          MAX_NUM_ORDER_AMENDS: '#/components/schemas/MaxNumOrderAmendsFilter'
                  assetFilters:
                    type: array
                    items:
                      oneOf:
                        - type: object
                          properties:
                            filterType:
                              type: string
                              example: MAX_ASSET
                            qtyExponent:
                              type: integer
                              example: 8
                            limit:
                              type: string
                              example: '100.00000000'
                            asset:
                              type: string
                              example: BNB
                      discriminator:
                        propertyName: filterType
                        mapping:
                          MAX_ASSET: '#/components/schemas/MaxAssetFilter'
                  rateLimits:
                    type: array
                    items:
                      type: object
                      properties:
                        rateLimitType:
                          type: string
                          example: REQUEST_WEIGHT
                        interval:
                          type: string
                          example: MINUTE
                        intervalNum:
                          type: integer
                          format: int64
                          example: 1
                        limit:
                          type: integer
                          format: int64
                          example: 6000
                        count:
                          type: integer
                          format: int64
                          example: 321
  /api/v3/myPreventedMatches:
    get:
      summary: 获取 Prevented Matches (USER_DATA)
      description: |-
        获取因 STP 而过期的订单列表。

        这些是支持的组合：
          - `symbol` + `preventedMatchId`
          - `symbol` + `orderId`
          - `symbol` + `orderId` + `fromPreventedMatchId` (`limit` 默认为 500)
          - `symbol` + `orderId` + `fromPreventedMatchId` + `limit`
      tags:
        - account
      operationId: myPreventedMatches
      externalDocs:
        url: https://developers.binance.com/en/docs/catalog/core-trading-spot-trading/api/rest-api/account#my-prevented-matches
      x-connectors-examples:
        ts: https://raw.githubusercontent.com/binance/binance-connector-js/master/clients/spot/examples/rest-api/AccountApi/myPreventedMatches.ts
        rust: https://raw.githubusercontent.com/binance/binance-connector-rust/main/examples/spot/rest_api/account_api/my_prevented_matches.rs
        python: https://raw.githubusercontent.com/binance/binance-connector-python/master/clients/spot/examples/rest_api/Account/my_prevented_matches.py
        java: https://raw.githubusercontent.com/binance/binance-connector-java/master/examples/spot/src/main/java/com/binance/connector/client/spot/rest/account/MyPreventedMatchesExample.java
        go: https://raw.githubusercontent.com/binance/binance-connector-go/main/clients/spot/examples/restapi/AccountAPI/MyPreventedMatches/MyPreventedMatches.go
        php: https://raw.githubusercontent.com/binance/binance-connector-php/master/examples/spot/account/MyPreventedMatchesExample.php
      x-security-type: USER_DATA
      x-signed: true
      x-weight: |-
        Case                            | Weight
        ----                            | -----
        If `symbol` is invalid          | 2
        Querying by `preventedMatchId`  | 2
        Querying by `orderId`           | 20
      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: BTCUSDT
        - name: preventedMatchId
          in: query
          required: false
          schema:
            type: integer
            format: int64
            example: 1
        - name: orderId
          in: query
          required: false
          schema:
            type: integer
            format: int64
            example: 1
        - name: fromPreventedMatchId
          in: query
          required: false
          schema:
            type: integer
            format: int64
            example: 1
        - name: limit
          in: query
          required: false
          schema:
            type: integer
            example: 1
            default: 500
            maximum: 1000
        - name: recvWindow
          in: query
          required: false
          description: 支持最多三位小数的精度（例如 6000.346），以便可以指定微秒。
          schema:
            type: number
            format: float
            example: 5000
            maximum: 60000
        - name: timestamp
          in: query
          required: true
          schema:
            type: integer
            example: 1770736694138
            format: int64
          description: 用于请求签名的 Unix 时间戳，单位为毫秒. 该值必须反映客户端当前时间，并会在签名接口中由服务器进行校验.
      x-parameters-notes: '**数据源:** 数据库'
      responses:
        '200':
          description: 获取 Prevented Matches
          content:
            application/json:
              schema:
                type: array
                items:
                  type: object
                  properties:
                    symbol:
                      type: string
                      example: BTCUSDT
                    preventedMatchId:
                      type: integer
                      format: int64
                      example: 1
                    takerOrderId:
                      type: integer
                      format: int64
                      example: 5
                    makerSymbol:
                      type: string
                      example: BTCUSDT
                    makerOrderId:
                      type: integer
                      format: int64
                      example: 3
                    tradeGroupId:
                      type: integer
                      format: int64
                      example: 1
                    selfTradePreventionMode:
                      type: string
                      example: EXPIRE_MAKER
                    price:
                      type: string
                      example: '1.100000'
                    makerPreventedQuantity:
                      type: string
                      example: '1.300000'
                    transactTime:
                      type: integer
                      format: int64
                      example: 1669101687094
  /api/v3/myTrades:
    get:
      summary: 账户成交历史 (USER_DATA)
      description: 获取某交易对的成交历史
      tags:
        - account
      operationId: myTrades
      externalDocs:
        url: https://developers.binance.com/en/docs/catalog/core-trading-spot-trading/api/rest-api/account#my-trades
      x-connectors-examples:
        ts: https://raw.githubusercontent.com/binance/binance-connector-js/master/clients/spot/examples/rest-api/AccountApi/myTrades.ts
        rust: https://raw.githubusercontent.com/binance/binance-connector-rust/main/examples/spot/rest_api/account_api/my_trades.rs
        python: https://raw.githubusercontent.com/binance/binance-connector-python/master/clients/spot/examples/rest_api/Account/my_trades.py
        java: https://raw.githubusercontent.com/binance/binance-connector-java/master/examples/spot/src/main/java/com/binance/connector/client/spot/rest/account/MyTradesExample.java
        go: https://raw.githubusercontent.com/binance/binance-connector-go/main/clients/spot/examples/restapi/AccountAPI/MyTrades/MyTrades.go
        php: https://raw.githubusercontent.com/binance/binance-connector-php/master/examples/spot/account/MyTradesExample.php
      x-security-type: USER_DATA
      x-signed: true
      x-weight: |-
        Condition| Weight|
        ---| ---
        |Without orderId|20|
        |With orderId|5|
      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: BNBBTC
        - name: orderId
          in: query
          required: false
          schema:
            type: integer
            format: int64
            example: 100234
          description: 必须要和参数`symbol`一起使用。
        - name: startTime
          in: query
          required: false
          schema:
            type: integer
            format: int64
            example: 1735693200000
        - name: endTime
          in: query
          required: false
          schema:
            type: integer
            format: int64
            example: 1735693200000
        - name: fromId
          in: query
          required: false
          description: 返回该fromId之后的成交，缺省返回最近的成交
          schema:
            type: integer
            format: int64
            example: 1
        - name: limit
          in: query
          required: false
          schema:
            type: integer
            example: 1
            default: 500
            maximum: 1000
        - name: recvWindow
          in: query
          required: false
          description: 支持最多三位小数的精度（例如 6000.346），以便可以指定微秒。
          schema:
            type: number
            format: float
            example: 5000
            maximum: 60000
        - name: timestamp
          in: query
          required: true
          schema:
            type: integer
            example: 1770736694138
            format: int64
          description: 用于请求签名的 Unix 时间戳，单位为毫秒. 该值必须反映客户端当前时间，并会在签名接口中由服务器进行校验.
      x-parameters-notes: |-
        **数据源:** 数据库

        **备注:** 
        - 如果设置了 `fromId`, 会返回ID大于此 `fromId` 的交易. 不然则会返回最近的交易。
        - `startTime` 和 `endTime` 设置的时间间隔不能超过24小时。
        - 支持的所有参数组合:
          - `symbol`
          - `symbol` + `orderId`
          - `symbol` + `startTime`
          - `symbol` + `endTime`
          - `symbol` + `fromId`
          - `symbol` + `startTime` + `endTime`
          - `symbol`+ `orderId` + `fromId`
      responses:
        '200':
          description: 账户成交历史
          content:
            application/json:
              schema:
                type: array
                items:
                  type: object
                  properties:
                    symbol:
                      type: string
                      example: BNBBTC
                    id:
                      type: integer
                      format: int64
                      example: 28457
                    orderId:
                      type: integer
                      format: int64
                      example: 100234
                    orderListId:
                      type: integer
                      format: int64
                      example: -1
                    price:
                      type: string
                      example: '4.00000100'
                    qty:
                      type: string
                      example: '12.00000000'
                    quoteQty:
                      type: string
                      example: '48.000012'
                    commission:
                      type: string
                      example: '10.10000000'
                    commissionAsset:
                      type: string
                      example: BNB
                    time:
                      type: integer
                      format: int64
                      example: 1499865549590
                    isBuyer:
                      type: boolean
                      example: true
                    isMaker:
                      type: boolean
                      example: false
                    isBestMatch:
                      type: boolean
                      example: true
  /api/v3/openOrderList:
    get:
      summary: 查询订单列表挂单 (USER_DATA)
      description: 查询订单列表挂单
      tags:
        - account
      operationId: openOrderList
      externalDocs:
        url: https://developers.binance.com/en/docs/catalog/core-trading-spot-trading/api/rest-api/account#open-order-list
      x-connectors-examples:
        ts: https://raw.githubusercontent.com/binance/binance-connector-js/master/clients/spot/examples/rest-api/AccountApi/openOrderList.ts
        rust: https://raw.githubusercontent.com/binance/binance-connector-rust/main/examples/spot/rest_api/account_api/open_order_list.rs
        python: https://raw.githubusercontent.com/binance/binance-connector-python/master/clients/spot/examples/rest_api/Account/open_order_list.py
        java: https://raw.githubusercontent.com/binance/binance-connector-java/master/examples/spot/src/main/java/com/binance/connector/client/spot/rest/account/OpenOrderListExample.java
        go: https://raw.githubusercontent.com/binance/binance-connector-go/main/clients/spot/examples/restapi/AccountAPI/OpenOrderList/OpenOrderList.go
        php: https://raw.githubusercontent.com/binance/binance-connector-php/master/examples/spot/account/OpenOrderListExample.php
      x-ip-weight: 6
      x-security-type: USER_DATA
      x-signed: true
      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
          description: 支持最多三位小数的精度（例如 6000.346），以便可以指定微秒。
          schema:
            type: number
            format: float
            example: 5000
            maximum: 60000
        - name: timestamp
          in: query
          required: true
          schema:
            type: integer
            example: 1770736694138
            format: int64
          description: 用于请求签名的 Unix 时间戳，单位为毫秒. 该值必须反映客户端当前时间，并会在签名接口中由服务器进行校验.
      x-parameters-notes: '**数据源:** 缓存 => 数据库'
      responses:
        '200':
          description: 查询订单列表挂单
          content:
            application/json:
              schema:
                type: array
                items:
                  type: object
                  properties:
                    orderListId:
                      type: integer
                      format: int64
                      example: 31
                    contingencyType:
                      type: string
                      example: OCO
                    listStatusType:
                      type: string
                      example: EXEC_STARTED
                    listOrderStatus:
                      type: string
                      example: EXECUTING
                    listClientOrderId:
                      type: string
                      example: wuB13fmulKj3YjdqWEcsnp
                    transactionTime:
                      type: integer
                      format: int64
                      example: 1565246080644
                    symbol:
                      type: string
                      example: LTCBTC
                    orders:
                      type: array
                      items:
                        type: object
                        properties:
                          symbol:
                            type: string
                            example: LTCBTC
                          orderId:
                            type: integer
                            format: int64
                            example: 4
                          clientOrderId:
                            type: string
                            example: r3EH2N76dHfLoSZWIUw1bT
  /api/v3/order/amendments:
    get:
      summary: 查询改单 (USER_DATA)
      description: 查询对一个订单的所有改单操作。
      tags:
        - account
      operationId: orderAmendments
      externalDocs:
        url: https://developers.binance.com/en/docs/catalog/core-trading-spot-trading/api/rest-api/account#order-amendments
      x-connectors-examples:
        ts: https://raw.githubusercontent.com/binance/binance-connector-js/master/clients/spot/examples/rest-api/AccountApi/orderAmendments.ts
        rust: https://raw.githubusercontent.com/binance/binance-connector-rust/main/examples/spot/rest_api/account_api/order_amendments.rs
        python: https://raw.githubusercontent.com/binance/binance-connector-python/master/clients/spot/examples/rest_api/Account/order_amendments.py
        java: https://raw.githubusercontent.com/binance/binance-connector-java/master/examples/spot/src/main/java/com/binance/connector/client/spot/rest/account/OrderAmendmentsExample.java
        go: https://raw.githubusercontent.com/binance/binance-connector-go/main/clients/spot/examples/restapi/AccountAPI/OrderAmendments/OrderAmendments.go
        php: https://raw.githubusercontent.com/binance/binance-connector-php/master/examples/spot/account/OrderAmendmentsExample.php
      x-ip-weight: 4
      x-security-type: USER_DATA
      x-signed: true
      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: BTCUSDT
        - name: orderId
          in: query
          required: true
          schema:
            type: integer
            format: int64
            example: 9
        - name: fromExecutionId
          in: query
          required: false
          schema:
            type: integer
            format: int64
            example: 22
        - name: limit
          in: query
          required: false
          schema:
            type: integer
            format: int64
            example: 1
            default: 500
            maximum: 1000
        - name: recvWindow
          in: query
          required: false
          description: 支持最多三位小数的精度（例如 6000.346），以便可以指定微秒。
          schema:
            type: number
            format: float
            example: 5000
            maximum: 60000
        - name: timestamp
          in: query
          required: true
          schema:
            type: integer
            example: 1770736694138
            format: int64
          description: 用于请求签名的 Unix 时间戳，单位为毫秒. 该值必须反映客户端当前时间，并会在签名接口中由服务器进行校验.
      x-parameters-notes: '**数据源:** 数据库'
      responses:
        '200':
          description: 查询改单
          content:
            application/json:
              schema:
                type: array
                items:
                  type: object
                  properties:
                    symbol:
                      type: string
                      example: BTCUSDT
                    orderId:
                      type: integer
                      format: int64
                      example: 9
                    executionId:
                      type: integer
                      format: int64
                      example: 22
                    origClientOrderId:
                      type: string
                      example: W0fJ9fiLKHOJutovPK3oJp
                    newClientOrderId:
                      type: string
                      example: UQ1Np3bmQ71jJzsSDW9Vpi
                    origQty:
                      type: string
                      example: '5.00000000'
                    newQty:
                      type: string
                      example: '4.00000000'
                    time:
                      type: integer
                      format: int64
                      example: 1741669661670
  /api/v3/rateLimit/order:
    get:
      summary: 查询未成交的订单计数 (USER_DATA)
      description: 显示用户在所有时间间隔内的未成交订单计数。
      tags:
        - account
      operationId: rateLimitOrder
      externalDocs:
        url: https://developers.binance.com/en/docs/catalog/core-trading-spot-trading/api/rest-api/account#rate-limit-order
      x-connectors-examples:
        ts: https://raw.githubusercontent.com/binance/binance-connector-js/master/clients/spot/examples/rest-api/AccountApi/rateLimitOrder.ts
        rust: https://raw.githubusercontent.com/binance/binance-connector-rust/main/examples/spot/rest_api/account_api/rate_limit_order.rs
        python: https://raw.githubusercontent.com/binance/binance-connector-python/master/clients/spot/examples/rest_api/Account/rate_limit_order.py
        java: https://raw.githubusercontent.com/binance/binance-connector-java/master/examples/spot/src/main/java/com/binance/connector/client/spot/rest/account/RateLimitOrderExample.java
        go: https://raw.githubusercontent.com/binance/binance-connector-go/main/clients/spot/examples/restapi/AccountAPI/RateLimitOrder/RateLimitOrder.go
        php: https://raw.githubusercontent.com/binance/binance-connector-php/master/examples/spot/account/RateLimitOrderExample.php
      x-ip-weight: 40
      x-security-type: USER_DATA
      x-signed: true
      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
          description: 支持最多三位小数的精度（例如 6000.346），以便可以指定微秒。
          schema:
            type: number
            format: float
            example: 5000
            maximum: 60000
        - name: timestamp
          in: query
          required: true
          schema:
            type: integer
            example: 1770736694138
            format: int64
          description: 用于请求签名的 Unix 时间戳，单位为毫秒. 该值必须反映客户端当前时间，并会在签名接口中由服务器进行校验.
      x-parameters-notes: '**数据源:** 缓存'
      responses:
        '200':
          description: 查询未成交的订单计数
          content:
            application/json:
              schema:
                type: array
                items:
                  type: object
                  properties:
                    rateLimitType:
                      type: string
                      example: ORDERS
                    interval:
                      type: string
                      example: SECOND
                    intervalNum:
                      type: integer
                      format: int64
                      example: 10
                    limit:
                      type: integer
                      format: int64
                      example: 50
                    count:
                      type: integer
                      format: int64
                      example: 0
  /api/v3/exchangeInfo:
    get:
      summary: 交易规范信息
      description: 获取此时的交易规范信息
      tags:
        - general
      operationId: exchangeInfo
      externalDocs:
        url: https://developers.binance.com/en/docs/catalog/core-trading-spot-trading/api/rest-api/general#exchange-info
      x-connectors-examples:
        ts: https://raw.githubusercontent.com/binance/binance-connector-js/master/clients/spot/examples/rest-api/GeneralApi/exchangeInfo.ts
        rust: https://raw.githubusercontent.com/binance/binance-connector-rust/main/examples/spot/rest_api/general_api/exchange_info.rs
        python: https://raw.githubusercontent.com/binance/binance-connector-python/master/clients/spot/examples/rest_api/General/exchange_info.py
        java: https://raw.githubusercontent.com/binance/binance-connector-java/master/examples/spot/src/main/java/com/binance/connector/client/spot/rest/general/ExchangeInfoExample.java
        go: https://raw.githubusercontent.com/binance/binance-connector-go/main/clients/spot/examples/restapi/GeneralAPI/ExchangeInfo/ExchangeInfo.go
        php: https://raw.githubusercontent.com/binance/binance-connector-php/master/examples/spot/general/ExchangeInfoExample.php
      x-ip-weight: 20
      x-security-type: NONE
      parameters:
        - name: symbol
          in: query
          required: false
          description: 示例：curl -X GET "https://api.binance.com/api/v3/exchangeInfo?symbol=BNBBTC"
          schema:
            type: string
            example: ETHBTC
        - name: symbols
          in: query
          required: false
          description: |-
            示例：curl -X GET
            "https://api.binance.com/api/v3/exchangeInfo?symbols=%5B%22BNBBTC%22,%22BTCUSDT%22%5D"
            <br/> 或 <br/> curl -g -X GET
            'https://api.binance.com/api/v3/exchangeInfo?symbols=["BTCUSDT","BNBBTC"]'
          schema:
            type: array
            example:
              - BTCUSDT
              - BNBBTC
            items:
              type: string
              example: BTCUSDT
        - name: permissions
          in: query
          required: false
          description: |-
            示例：curl -X GET
            "https://api.binance.com/api/v3/exchangeInfo?permissions=SPOT" <br/>
            or <br/> curl -X GET
            "https://api.binance.com/api/v3/exchangeInfo?permissions=%5B%22MARGIN%22%2C%22LEVERAGED%22%5D"
            <br/> or <br/> curl -g -X GET
            'https://api.binance.com/api/v3/exchangeInfo?permissions=["MARGIN","LEVERAGED"]'
          schema:
            type: array
            example:
              - SPOT
            items:
              type: string
              example: SPOT
              enum:
                - SPOT
                - MARGIN
                - LEVERAGED
                - TRD_GRP_002
                - TRD_GRP_003
                - TRD_GRP_004
                - TRD_GRP_005
                - TRD_GRP_006
                - TRD_GRP_007
                - TRD_GRP_008
                - TRD_GRP_009
                - TRD_GRP_010
                - TRD_GRP_011
                - TRD_GRP_012
                - TRD_GRP_013
                - TRD_GRP_014
                - TRD_GRP_015
                - TRD_GRP_016
                - TRD_GRP_017
                - TRD_GRP_018
                - TRD_GRP_019
                - TRD_GRP_020
                - TRD_GRP_021
                - TRD_GRP_022
                - TRD_GRP_023
                - TRD_GRP_024
                - TRD_GRP_025
        - name: showPermissionSets
          in: query
          required: false
          description: 用于控制是否提供 `permissionSets` 字段的内容。
          schema:
            type: boolean
            example: false
            default: true
        - name: symbolStatus
          in: query
          required: false
          schema:
            type: string
            example: TRADING
            enum:
              - TRADING
              - HALT
              - BREAK
          description: 用于过滤具有此 `tradingStatus` 的交易对。不能与 `symbols` 或 `symbol` 组合使用。
      x-parameters-notes: |-
        **数据源:** 缓存

        **备注**:
          - 如果参数 `symbol` 或者 `symbols` 提供的交易对不存在, 系统会返回错误并提示交易对不正确。
          - 所有的参数都是可选的。
          - `permissions` 可以支持单个或多个值（例如 `SPOT`, `["MARGIN","LEVERAGED"]`）。此参数不能与 `symbol` 或 `symbols` 组合使用。
          - 如果未提供 `permissions` 参数，那么所有具有 `SPOT`、`MARGIN` 或 `LEVERAGED` 权限的交易对都将被返回。
            - 要显示具有任何权限的交易对，您需要在 `permissions` 中明确指定它们：（例如 `["SPOT","MARGIN",...]`)。有关完整列表，请参阅 [可用权限]
            
        **解释响应中的 `permissionSets`：**
          - `[["A","B"]]` 有权限"A"**或**权限"B"的账户可以下订单。
          - `[["A"],["B"]]` 有权限"A"**和**权限"B"的账户可以下订单。
          - `[["A"],["B","C"]]` 有权限"A"**和**权限"B"或权限"C"的账户可以下订单。（此处应用的是包含或，而不是排除或，因此账户可以同时拥有权限"B"和权限"C"。）
      responses:
        '200':
          description: 交易规范信息
          content:
            application/json:
              schema:
                type: object
                properties:
                  timezone:
                    type: string
                    example: UTC
                  serverTime:
                    type: integer
                    format: int64
                    example: 1565246363776
                  rateLimits:
                    type: array
                    items:
                      type: object
                      properties:
                        rateLimitType:
                          type: string
                          example: REQUEST_WEIGHT
                        interval:
                          type: string
                          example: MINUTE
                        intervalNum:
                          type: integer
                          format: int64
                          example: 1
                        limit:
                          type: integer
                          format: int64
                          example: 6000
                        count:
                          type: integer
                          format: int64
                          example: 321
                  exchangeFilters:
                    type: array
                    items:
                      oneOf:
                        - type: object
                          properties:
                            filterType:
                              type: string
                              example: EXCHANGE_MAX_NUM_ORDERS
                            maxNumOrders:
                              type: integer
                              format: int64
                              example: 1000
                        - type: object
                          properties:
                            filterType:
                              type: string
                              example: EXCHANGE_MAX_NUM_ALGO_ORDERS
                            maxNumAlgoOrders:
                              type: integer
                              format: int64
                              example: 200
                        - type: object
                          properties:
                            filterType:
                              type: string
                              example: EXCHANGE_MAX_NUM_ICEBERG_ORDERS
                            maxNumIcebergOrders:
                              type: integer
                              format: int64
                              example: 10
                        - type: object
                          properties:
                            filterType:
                              type: string
                              example: EXCHANGE_MAX_NUM_ORDER_LISTS
                            maxNumOrderLists:
                              type: integer
                              format: int64
                              example: 20
                      discriminator:
                        propertyName: filterType
                        mapping:
                          EXCHANGE_MAX_NUM_ORDERS: '#/components/schemas/ExchangeMaxNumOrdersFilter'
                          EXCHANGE_MAX_NUM_ALGO_ORDERS: '#/components/schemas/ExchangeMaxNumAlgoOrdersFilter'
                          EXCHANGE_MAX_NUM_ICEBERG_ORDERS: '#/components/schemas/ExchangeMaxNumIcebergOrdersFilter'
                          EXCHANGE_MAX_NUM_ORDER_LISTS: '#/components/schemas/ExchangeMaxNumOrderListsFilter'
                  symbols:
                    type: array
                    items:
                      type: object
                      properties:
                        symbol:
                          type: string
                          example: ETHBTC
                        status:
                          type: string
                          example: TRADING
                        baseAsset:
                          type: string
                          example: ETH
                        baseAssetPrecision:
                          type: integer
                          format: int64
                          example: 8
                        quoteAsset:
                          type: string
                          example: BTC
                        quotePrecision:
                          type: integer
                          format: int64
                          example: 8
                        quoteAssetPrecision:
                          type: integer
                          format: int64
                          example: 8
                        baseCommissionPrecision:
                          type: integer
                          format: int64
                          example: 8
                        quoteCommissionPrecision:
                          type: integer
                          format: int64
                          example: 8
                        orderTypes:
                          type: array
                          items:
                            type: string
                            example: LIMIT
                        icebergAllowed:
                          type: boolean
                          example: true
                        ocoAllowed:
                          type: boolean
                          example: true
                        otoAllowed:
                          type: boolean
                          example: true
                        opoAllowed:
                          type: boolean
                          example: true
                        quoteOrderQtyMarketAllowed:
                          type: boolean
                          example: true
                        allowTrailingStop:
                          type: boolean
                          example: false
                        cancelReplaceAllowed:
                          type: boolean
                          example: false
                        amendAllowed:
                          type: boolean
                          example: false
                        pegInstructionsAllowed:
                          type: boolean
                          example: true
                        isSpotTradingAllowed:
                          type: boolean
                          example: true
                        isMarginTradingAllowed:
                          type: boolean
                          example: true
                        filters:
                          type: array
                          items:
                            oneOf:
                              - type: object
                                properties:
                                  filterType:
                                    type: string
                                    example: PRICE_FILTER
                                  priceExponent:
                                    type: integer
                                    example: 8
                                  minPrice:
                                    type: string
                                    example: '0.00000100'
                                  maxPrice:
                                    type: string
                                    example: '100000.00000000'
                                  tickSize:
                                    type: string
                                    example: '0.00000100'
                              - type: object
                                properties:
                                  filterType:
                                    type: string
                                    example: PERCENT_PRICE
                                  multiplierExponent:
                                    type: integer
                                    example: 4
                                  multiplierUp:
                                    type: string
                                    example: '1.3000'
                                  multiplierDown:
                                    type: string
                                    example: '0.7000'
                                  avgPriceMins:
                                    type: integer
                                    example: 5
                              - type: object
                                properties:
                                  filterType:
                                    type: string
                                    example: PERCENT_PRICE_BY_SIDE
                                  multiplierExponent:
                                    type: integer
                                    example: 4
                                  bidMultiplierUp:
                                    type: string
                                    example: '1.2000'
                                  bidMultiplierDown:
                                    type: string
                                    example: '0.8000'
                                  askMultiplierUp:
                                    type: string
                                    example: '1.2000'
                                  askMultiplierDown:
                                    type: string
                                    example: '0.8000'
                                  avgPriceMins:
                                    type: integer
                                    example: 5
                              - type: object
                                properties:
                                  filterType:
                                    type: string
                                    example: LOT_SIZE
                                  qtyExponent:
                                    type: integer
                                    example: 8
                                  minQty:
                                    type: string
                                    example: '0.00010000'
                                  maxQty:
                                    type: string
                                    example: '100000.00000000'
                                  stepSize:
                                    type: string
                                    example: '0.00010000'
                              - type: object
                                properties:
                                  filterType:
                                    type: string
                                    example: MIN_NOTIONAL
                                  priceExponent:
                                    type: integer
                                    example: 8
                                  minNotional:
                                    type: string
                                    example: '10.00000000'
                                  applyToMarket:
                                    type: boolean
                                    example: true
                                  avgPriceMins:
                                    type: integer
                                    example: 5
                              - type: object
                                properties:
                                  filterType:
                                    type: string
                                    example: NOTIONAL
                                  priceExponent:
                                    type: integer
                                    example: 8
                                  minNotional:
                                    type: string
                                    example: '10.00000000'
                                  applyMinToMarket:
                                    type: boolean
                                    example: true
                                  maxNotional:
                                    type: string
                                    example: '100000.00000000'
                                  applyMaxToMarket:
                                    type: boolean
                                    example: false
                                  avgPriceMins:
                                    type: integer
                                    example: 5
                              - type: object
                                properties:
                                  filterType:
                                    type: string
                                    example: ICEBERG_PARTS
                                  limit:
                                    type: integer
                                    format: int64
                                    example: 10
                              - type: object
                                properties:
                                  filterType:
                                    type: string
                                    example: MARKET_LOT_SIZE
                                  qtyExponent:
                                    type: integer
                                    example: 8
                                  minQty:
                                    type: string
                                    example: '0.00000000'
                                  maxQty:
                                    type: string
                                    example: '1000.00000000'
                                  stepSize:
                                    type: string
                                    example: '0.00000000'
                              - type: object
                                properties:
                                  filterType:
                                    type: string
                                    example: MAX_NUM_ORDERS
                                  maxNumOrders:
                                    type: integer
                                    format: int64
                                    example: 200
                              - type: object
                                properties:
                                  filterType:
                                    type: string
                                    example: MAX_NUM_ALGO_ORDERS
                                  maxNumAlgoOrders:
                                    type: integer
                                    format: int64
                                    example: 10
                              - type: object
                                properties:
                                  filterType:
                                    type: string
                                    example: MAX_NUM_ICEBERG_ORDERS
                                  maxNumIcebergOrders:
                                    type: integer
                                    format: int64
                                    example: 5
                              - type: object
                                properties:
                                  filterType:
                                    type: string
                                    example: MAX_POSITION
                                  qtyExponent:
                                    type: integer
                                    example: 8
                                  maxPosition:
                                    type: string
                                    example: '100.00000000'
                              - type: object
                                properties:
                                  filterType:
                                    type: string
                                    example: TRAILING_DELTA
                                  minTrailingAboveDelta:
                                    type: integer
                                    format: int64
                                    example: 10
                                  maxTrailingAboveDelta:
                                    type: integer
                                    format: int64
                                    example: 2000
                                  minTrailingBelowDelta:
                                    type: integer
                                    format: int64
                                    example: 10
                                  maxTrailingBelowDelta:
                                    type: integer
                                    format: int64
                                    example: 2000
                              - type: object
                                properties:
                                  filterType:
                                    type: string
                                    example: T_PLUS_SELL
                                  endTime:
                                    type: integer
                                    format: int64
                                    example: 1741672924895
                              - type: object
                                properties:
                                  filterType:
                                    type: string
                                    example: MAX_NUM_ORDER_LISTS
                                  maxNumOrderLists:
                                    type: integer
                                    format: int64
                                    example: 20
                              - type: object
                                properties:
                                  filterType:
                                    type: string
                                    example: MAX_NUM_ORDER_AMENDS
                                  maxNumOrderAmends:
                                    type: integer
                                    format: int64
                                    example: 10
                            discriminator:
                              propertyName: filterType
                              mapping:
                                PRICE_FILTER: '#/components/schemas/PriceFilter'
                                PERCENT_PRICE: '#/components/schemas/PercentPriceFilter'
                                PERCENT_PRICE_BY_SIDE: '#/components/schemas/PercentPriceBySideFilter'
                                LOT_SIZE: '#/components/schemas/LotSizeFilter'
                                MIN_NOTIONAL: '#/components/schemas/MinNotionalFilter'
                                NOTIONAL: '#/components/schemas/NotionalFilter'
                                ICEBERG_PARTS: '#/components/schemas/IcebergPartsFilter'
                                MARKET_LOT_SIZE: '#/components/schemas/MarketLotSizeFilter'
                                MAX_NUM_ORDERS: '#/components/schemas/MaxNumOrdersFilter'
                                MAX_NUM_ALGO_ORDERS: '#/components/schemas/MaxNumAlgoOrdersFilter'
                                MAX_NUM_ICEBERG_ORDERS: '#/components/schemas/MaxNumIcebergOrdersFilter'
                                MAX_POSITION: '#/components/schemas/MaxPositionFilter'
                                TRAILING_DELTA: '#/components/schemas/TrailingDeltaFilter'
                                T_PLUS_SELL: '#/components/schemas/TPlusSellFilter'
                                MAX_NUM_ORDER_LISTS: '#/components/schemas/MaxNumOrderListsFilter'
                                MAX_NUM_ORDER_AMENDS: '#/components/schemas/MaxNumOrderAmendsFilter'
                        permissions:
                          type: array
                          items:
                            type: string
                            example: undefined
                        permissionSets:
                          type: array
                          items:
                            type: array
                            items:
                              type: string
                              example: SPOT
                        defaultSelfTradePreventionMode:
                          type: string
                          example: NONE
                        allowedSelfTradePreventionModes:
                          type: array
                          items:
                            type: string
                            example: NONE
                  sors:
                    type: array
                    description: 可选。仅当 SOR 可用时出现。
                    items:
                      type: object
                      properties:
                        baseAsset:
                          type: string
                          example: BTC
                        symbols:
                          type: array
                          items:
                            type: string
                            example: BTCUSDT
              example:
                timezone: UTC
                serverTime: 1565246363776
                rateLimits:
                  - rateLimitType: REQUEST_WEIGHT
                    interval: MINUTE
                    intervalNum: 1
                    limit: 6000
                  - rateLimitType: ORDERS
                    interval: DAY
                    intervalNum: 1
                    limit: 160000
                  - rateLimitType: RAW_REQUESTS
                    interval: MINUTE
                    intervalNum: 5
                    limit: 61000
                exchangeFilters: []
                symbols:
                  - symbol: ETHBTC
                    status: TRADING
                    baseAsset: ETH
                    baseAssetPrecision: 8
                    quoteAsset: BTC
                    quotePrecision: 8
                    quoteAssetPrecision: 8
                    baseCommissionPrecision: 8
                    quoteCommissionPrecision: 8
                    orderTypes:
                      - LIMIT LIMIT_MAKER MARKET STOP_LOSS STOP_LOSS_LIMIT TAKE_PROFIT TAKE_PROFIT_LIMIT
                    icebergAllowed: true
                    ocoAllowed: true
                    otoAllowed: true
                    opoAllowed: true
                    quoteOrderQtyMarketAllowed: true
                    allowTrailingStop: false
                    cancelReplaceAllowed: false
                    amendAllowed: false
                    pegInstructionsAllowed: true
                    isSpotTradingAllowed: true
                    isMarginTradingAllowed: true
                    filters: []
                    permissions: []
                    permissionSets:
                      - - SPOT
                        - MARGIN
                    defaultSelfTradePreventionMode: NONE
                    allowedSelfTradePreventionModes:
                      - NONE
  /api/v3/executionRules:
    get:
      summary: 查询执行规则
      description: 查询交易对的执行规则。
      tags:
        - general
      operationId: executionRules
      externalDocs:
        url: https://developers.binance.com/en/docs/catalog/core-trading-spot-trading/api/rest-api/general#execution-rules
      x-connectors-examples:
        ts: https://raw.githubusercontent.com/binance/binance-connector-js/master/clients/spot/examples/rest-api/GeneralApi/executionRules.ts
        rust: https://raw.githubusercontent.com/binance/binance-connector-rust/main/examples/spot/rest_api/general_api/execution_rules.rs
        python: https://raw.githubusercontent.com/binance/binance-connector-python/master/clients/spot/examples/rest_api/General/execution_rules.py
        java: https://raw.githubusercontent.com/binance/binance-connector-java/master/examples/spot/src/main/java/com/binance/connector/client/spot/rest/general/ExecutionRulesExample.java
        go: https://raw.githubusercontent.com/binance/binance-connector-go/main/clients/spot/examples/restapi/GeneralAPI/ExecutionRules/ExecutionRules.go
        php: https://raw.githubusercontent.com/binance/binance-connector-php/master/examples/spot/general/ExecutionRulesExample.php
      x-security-type: NONE
      x-weight: |-
        Parameter | Weight
        --- | ---
        `symbol` | 2
        `symbols` | 2 for each `symbol`, capped at a max of 40
        `symbolStatus` | 40
        None | 40
      parameters:
        - name: symbol
          in: query
          required: false
          description: 查询指定的交易对。
          schema:
            type: string
            example: BAZUSD
        - name: symbols
          in: query
          required: false
          description: 查询多个交易对。
          schema:
            type: array
            example:
              - BAZUSD
              - BNBUSDT
            items:
              type: string
              example: BAZUSD
        - name: symbolStatus
          in: query
          required: false
          description: 查询指定状态的所有交易对。
          schema:
            type: string
            enum:
              - TRADING
              - HALT
              - BREAK
            example: TRADING
      x-parameters-notes: |-
        **数据源:** 缓存

        **注意:** 不允许多个参数组合使用。
      responses:
        '200':
          description: 查询执行规则
          content:
            application/json:
              schema:
                type: object
                properties:
                  symbolRules:
                    type: array
                    items:
                      type: object
                      properties:
                        symbol:
                          type: string
                          example: BAZUSD
                        rules:
                          type: array
                          items:
                            type: object
                            properties:
                              ruleType:
                                type: string
                                example: PRICE_RANGE
                              bidLimitMultUp:
                                type: string
                                example: '1.0001'
                              bidLimitMultDown:
                                type: string
                                example: '0.9999'
                              askLimitMultUp:
                                type: string
                                example: '1.0001'
                              askLimitMultDown:
                                type: string
                                example: '0.9999'
  /api/v3/ping:
    get:
      summary: 测试服务器连通性 PING
      description: 测试能否联通
      tags:
        - general
      operationId: ping
      externalDocs:
        url: https://developers.binance.com/en/docs/catalog/core-trading-spot-trading/api/rest-api/general#ping
      x-connectors-examples:
        ts: https://raw.githubusercontent.com/binance/binance-connector-js/master/clients/spot/examples/rest-api/GeneralApi/ping.ts
        rust: https://raw.githubusercontent.com/binance/binance-connector-rust/main/examples/spot/rest_api/general_api/ping.rs
        python: https://raw.githubusercontent.com/binance/binance-connector-python/master/clients/spot/examples/rest_api/General/ping.py
        java: https://raw.githubusercontent.com/binance/binance-connector-java/master/examples/spot/src/main/java/com/binance/connector/client/spot/rest/general/PingExample.java
        go: https://raw.githubusercontent.com/binance/binance-connector-go/main/clients/spot/examples/restapi/GeneralAPI/Ping/Ping.go
        php: https://raw.githubusercontent.com/binance/binance-connector-php/master/examples/spot/general/PingExample.php
      x-ip-weight: 1
      x-security-type: NONE
      parameters: []
      responses:
        '200':
          description: 成功
  /api/v3/time:
    get:
      summary: 获取服务器时间
      description: 获取服务器时间
      tags:
        - general
      operationId: time
      externalDocs:
        url: https://developers.binance.com/en/docs/catalog/core-trading-spot-trading/api/rest-api/general#time
      x-connectors-examples:
        ts: https://raw.githubusercontent.com/binance/binance-connector-js/master/clients/spot/examples/rest-api/GeneralApi/time.ts
        rust: https://raw.githubusercontent.com/binance/binance-connector-rust/main/examples/spot/rest_api/general_api/time.rs
        python: https://raw.githubusercontent.com/binance/binance-connector-python/master/clients/spot/examples/rest_api/General/time.py
        java: https://raw.githubusercontent.com/binance/binance-connector-java/master/examples/spot/src/main/java/com/binance/connector/client/spot/rest/general/TimeExample.java
        go: https://raw.githubusercontent.com/binance/binance-connector-go/main/clients/spot/examples/restapi/GeneralAPI/Time/Time.go
        php: https://raw.githubusercontent.com/binance/binance-connector-php/master/examples/spot/general/TimeExample.php
      x-ip-weight: 1
      x-security-type: NONE
      parameters: []
      responses:
        '200':
          description: 获取服务器时间
          content:
            application/json:
              schema:
                type: object
                properties:
                  serverTime:
                    type: integer
                    format: int64
                    example: 1499827319559
  /api/v3/aggTrades:
    get:
      summary: 近期成交(归集
      description: 与trades的区别是，同一个taker在同一时间同一价格与多个maker的成交会被合并为一条记录
      tags:
        - market
      operationId: aggTrades
      externalDocs:
        url: https://developers.binance.com/en/docs/catalog/core-trading-spot-trading/api/rest-api/market#agg-trades
      x-connectors-examples:
        ts: https://raw.githubusercontent.com/binance/binance-connector-js/master/clients/spot/examples/rest-api/MarketApi/aggTrades.ts
        rust: https://raw.githubusercontent.com/binance/binance-connector-rust/main/examples/spot/rest_api/market_api/agg_trades.rs
        python: https://raw.githubusercontent.com/binance/binance-connector-python/master/clients/spot/examples/rest_api/Market/agg_trades.py
        java: https://raw.githubusercontent.com/binance/binance-connector-java/master/examples/spot/src/main/java/com/binance/connector/client/spot/rest/market/AggTradesExample.java
        go: https://raw.githubusercontent.com/binance/binance-connector-go/main/clients/spot/examples/restapi/MarketAPI/AggTrades/AggTrades.go
        php: https://raw.githubusercontent.com/binance/binance-connector-php/master/examples/spot/market/AggTradesExample.php
      x-ip-weight: 4
      x-security-type: NONE
      parameters:
        - name: symbol
          in: query
          required: true
          schema:
            type: string
            example: BNBUSDT
        - name: fromId
          in: query
          required: false
          description: 从包含fromID的成交开始返回结果
          schema:
            type: integer
            format: int64
            example: 1
        - name: startTime
          in: query
          required: false
          description: 从该时刻之后的成交记录开始返回结果
          schema:
            type: integer
            format: int64
            example: 1735693200000
        - name: endTime
          in: query
          required: false
          description: 返回该时刻为止的成交记录
          schema:
            type: integer
            format: int64
            example: 1735693200000
        - name: limit
          in: query
          required: false
          schema:
            type: integer
            example: 1
            default: 500
            maximum: 1000
      x-parameters-notes: |-
        **数据源:** 数据库

        - 如果没有发送任何筛选参数(fromId, startTime, endTime)，默认返回最近的成交记录
      responses:
        '200':
          description: 近期成交(归集
          content:
            application/json:
              schema:
                type: array
                items:
                  type: object
                  properties:
                    a:
                      type: integer
                      format: int64
                      example: 26129
                      description: 归集成交ID
                    p:
                      type: string
                      example: '0.01633102'
                      description: 成交价
                    q:
                      type: string
                      example: '4.70443515'
                      description: 成交量
                    f:
                      type: integer
                      format: int64
                      example: 27781
                      description: 被归集的首个成交ID
                    l:
                      type: integer
                      format: int64
                      example: 27781
                      description: 被归集的末个成交ID
                    T:
                      type: integer
                      format: int64
                      example: 1498793709153
                      description: 成交时间
                    m:
                      type: boolean
                      example: true
                      description: 是否为主动卖出单
                    M:
                      type: boolean
                      example: true
                      description: 是否为最优撮合单(可忽略，目前总为最优撮合)
  /api/v3/avgPrice:
    get:
      summary: 当前平均价格
      description: 当前平均价格
      tags:
        - market
      operationId: avgPrice
      externalDocs:
        url: https://developers.binance.com/en/docs/catalog/core-trading-spot-trading/api/rest-api/market#avg-price
      x-connectors-examples:
        ts: https://raw.githubusercontent.com/binance/binance-connector-js/master/clients/spot/examples/rest-api/MarketApi/avgPrice.ts
        rust: https://raw.githubusercontent.com/binance/binance-connector-rust/main/examples/spot/rest_api/market_api/avg_price.rs
        python: https://raw.githubusercontent.com/binance/binance-connector-python/master/clients/spot/examples/rest_api/Market/avg_price.py
        java: https://raw.githubusercontent.com/binance/binance-connector-java/master/examples/spot/src/main/java/com/binance/connector/client/spot/rest/market/AvgPriceExample.java
        go: https://raw.githubusercontent.com/binance/binance-connector-go/main/clients/spot/examples/restapi/MarketAPI/AvgPrice/AvgPrice.go
        php: https://raw.githubusercontent.com/binance/binance-connector-php/master/examples/spot/market/AvgPriceExample.php
      x-ip-weight: 2
      x-security-type: NONE
      parameters:
        - name: symbol
          in: query
          required: true
          schema:
            type: string
            example: BNBUSDT
      x-parameters-notes: '**数据源:** 缓存'
      responses:
        '200':
          description: 当前平均价格
          content:
            application/json:
              schema:
                type: object
                properties:
                  mins:
                    type: integer
                    format: int64
                    example: 5
                    description: 平均价格间隔（以分钟为单位）
                  price:
                    type: string
                    example: '9.35751834'
                    description: 平均价格
                  closeTime:
                    type: integer
                    format: int64
                    example: 1694061154503
                    description: 最近成交时间
  /api/v3/depth:
    get:
      summary: 深度信息
      description: 深度信息
      tags:
        - market
      operationId: depth
      externalDocs:
        url: https://developers.binance.com/en/docs/catalog/core-trading-spot-trading/api/rest-api/market#depth
      x-connectors-examples:
        ts: https://raw.githubusercontent.com/binance/binance-connector-js/master/clients/spot/examples/rest-api/MarketApi/depth.ts
        rust: https://raw.githubusercontent.com/binance/binance-connector-rust/main/examples/spot/rest_api/market_api/depth.rs
        python: https://raw.githubusercontent.com/binance/binance-connector-python/master/clients/spot/examples/rest_api/Market/depth.py
        java: https://raw.githubusercontent.com/binance/binance-connector-java/master/examples/spot/src/main/java/com/binance/connector/client/spot/rest/market/DepthExample.java
        go: https://raw.githubusercontent.com/binance/binance-connector-go/main/clients/spot/examples/restapi/MarketAPI/Depth/Depth.go
        php: https://raw.githubusercontent.com/binance/binance-connector-php/master/examples/spot/market/DepthExample.php
      x-security-type: NONE
      x-weight: |-
        Adjusted based on the limit:

        |Limit|Request Weight
        ------|-------
        1-100|  5
        101-500| 25
        501-1000| 50
        1001-5000| 250
      parameters:
        - name: symbol
          in: query
          required: true
          schema:
            type: string
            example: BNBUSDT
        - name: limit
          in: query
          required: false
          description: 如果 limit > 5000, 最多返回5000条数据。
          schema:
            type: integer
            example: 1
            default: 100
            maximum: 5000
        - name: symbolStatus
          in: query
          required: false
          schema:
            type: string
            enum:
              - TRADING
              - HALT
              - BREAK
            example: TRADING
          description: |-
            过滤具有此 `tradingStatus` 的交易对。
            如果状态不匹配，将返回错误 `-1220 交易对与状态不匹配`
      x-parameters-notes: '**数据源:** 缓存'
      responses:
        '200':
          description: 深度信息
          content:
            application/json:
              schema:
                type: object
                properties:
                  lastUpdateId:
                    type: integer
                    format: int64
                    example: 1027024
                  bids:
                    type: array
                    description: 买单列表。每项为 [价格, 数量]。
                    example:
                      - - '4.00000000'
                        - '431.00000000'
                    items:
                      type: array
                      minItems: 2
                      maxItems: 2
                      x-prefixItems:
                        - type: string
                          description: Price
                          example: '4.00000000'
                        - type: string
                          description: Quantity
                          example: '431.00000000'
                      items:
                        oneOf:
                          - type: string
                            description: Price
                            example: '4.00000000'
                          - type: string
                            description: Quantity
                            example: '431.00000000'
                  asks:
                    type: array
                    description: 卖单列表。每项为 [价格, 数量]。
                    example:
                      - - '4.00000200'
                        - '12.00000000'
                    items:
                      type: array
                      minItems: 2
                      maxItems: 2
                      x-prefixItems:
                        - type: string
                          description: Price
                          example: '4.00000200'
                        - type: string
                          description: Quantity
                          example: '12.00000000'
                      items:
                        oneOf:
                          - type: string
                            description: Price
                            example: '4.00000200'
                          - type: string
                            description: Quantity
                            example: '12.00000000'
  /api/v3/trades:
    get:
      summary: 近期成交
      description: 获取近期成交
      tags:
        - market
      operationId: getTrades
      externalDocs:
        url: https://developers.binance.com/en/docs/catalog/core-trading-spot-trading/api/rest-api/market#get-trades
      x-connectors-examples:
        ts: https://raw.githubusercontent.com/binance/binance-connector-js/master/clients/spot/examples/rest-api/MarketApi/getTrades.ts
        rust: https://raw.githubusercontent.com/binance/binance-connector-rust/main/examples/spot/rest_api/market_api/get_trades.rs
        python: https://raw.githubusercontent.com/binance/binance-connector-python/master/clients/spot/examples/rest_api/Market/get_trades.py
        java: https://raw.githubusercontent.com/binance/binance-connector-java/master/examples/spot/src/main/java/com/binance/connector/client/spot/rest/market/GetTradesExample.java
        go: https://raw.githubusercontent.com/binance/binance-connector-go/main/clients/spot/examples/restapi/MarketAPI/GetTrades/GetTrades.go
        php: https://raw.githubusercontent.com/binance/binance-connector-php/master/examples/spot/market/GetTradesExample.php
      x-ip-weight: 25
      x-security-type: NONE
      parameters:
        - name: symbol
          in: query
          required: true
          schema:
            type: string
            example: BNBUSDT
        - name: limit
          in: query
          required: false
          schema:
            type: integer
            example: 1
            default: 500
            maximum: 1000
      x-parameters-notes: '**数据源:** 缓存'
      responses:
        '200':
          description: 近期成交
          content:
            application/json:
              schema:
                type: array
                items:
                  type: object
                  properties:
                    id:
                      type: integer
                      format: int64
                      example: 28457
                    price:
                      type: string
                      example: '4.00000100'
                    qty:
                      type: string
                      example: '12.00000000'
                    quoteQty:
                      type: string
                      example: '48.000012'
                    time:
                      type: integer
                      format: int64
                      example: 1499865549590
                    isBuyerMaker:
                      type: boolean
                      example: true
                    isBestMatch:
                      type: boolean
                      example: true
  /api/v3/historicalTrades:
    get:
      summary: 查询历史成交
      description: 查询历史成交
      tags:
        - market
      operationId: historicalTrades
      externalDocs:
        url: https://developers.binance.com/en/docs/catalog/core-trading-spot-trading/api/rest-api/market#historical-trades
      x-connectors-examples:
        ts: https://raw.githubusercontent.com/binance/binance-connector-js/master/clients/spot/examples/rest-api/MarketApi/historicalTrades.ts
        rust: https://raw.githubusercontent.com/binance/binance-connector-rust/main/examples/spot/rest_api/market_api/historical_trades.rs
        python: https://raw.githubusercontent.com/binance/binance-connector-python/master/clients/spot/examples/rest_api/Market/historical_trades.py
        java: https://raw.githubusercontent.com/binance/binance-connector-java/master/examples/spot/src/main/java/com/binance/connector/client/spot/rest/market/HistoricalTradesExample.java
        go: https://raw.githubusercontent.com/binance/binance-connector-go/main/clients/spot/examples/restapi/MarketAPI/HistoricalTrades/HistoricalTrades.go
        php: https://raw.githubusercontent.com/binance/binance-connector-php/master/examples/spot/market/HistoricalTradesExample.php
      x-ip-weight: 25
      x-security-type: NONE
      parameters:
        - name: symbol
          in: query
          required: true
          schema:
            type: string
            example: BNBUSDT
        - name: limit
          in: query
          required: false
          schema:
            type: integer
            example: 1
            default: 500
            maximum: 1000
        - name: fromId
          in: query
          required: false
          description: 从哪一条成交id开始返回，缺省返回最近的成交记录
          schema:
            type: integer
            format: int64
            example: 1
      x-parameters-notes: '**数据源:** 数据库'
      responses:
        '200':
          description: 查询历史成交
          content:
            application/json:
              schema:
                type: array
                items:
                  type: object
                  properties:
                    id:
                      type: integer
                      format: int64
                      example: 28457
                    price:
                      type: string
                      example: '4.00000100'
                    qty:
                      type: string
                      example: '12.00000000'
                    quoteQty:
                      type: string
                      example: '48.000012'
                    time:
                      type: integer
                      format: int64
                      example: 1499865549590
                    isBuyerMaker:
                      type: boolean
                      example: true
                    isBestMatch:
                      type: boolean
                      example: true
  /api/v3/historicalBlockTrades:
    get:
      summary: 历史大宗交易 (MARKET_DATA)
      description: 获取大宗交易记录。
      tags:
        - market
      operationId: historicalBlockTrades
      externalDocs:
        url: https://developers.binance.com/en/docs/catalog/core-trading-spot-trading/api/rest-api/market#historical-block-trades
      x-connectors-examples:
        ts: https://raw.githubusercontent.com/binance/binance-connector-js/master/clients/spot/examples/rest-api/MarketApi/historicalBlockTrades.ts
        rust: https://raw.githubusercontent.com/binance/binance-connector-rust/main/examples/spot/rest_api/market_api/historical_block_trades.rs
        python: https://raw.githubusercontent.com/binance/binance-connector-python/master/clients/spot/examples/rest_api/Market/historical_block_trades.py
        java: https://raw.githubusercontent.com/binance/binance-connector-java/master/examples/spot/src/main/java/com/binance/connector/client/spot/rest/market/HistoricalBlockTradesExample.java
        go: https://raw.githubusercontent.com/binance/binance-connector-go/main/clients/spot/examples/restapi/MarketAPI/HistoricalBlockTrades/HistoricalBlockTrades.go
        php: https://raw.githubusercontent.com/binance/binance-connector-php/master/examples/spot/market/HistoricalBlockTradesExample.php
      x-ip-weight: 25
      x-security-type: MARKET_DATA
      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: BNBBTC
        - name: fromId
          in: query
          required: true
          schema:
            type: integer
            format: int64
            example: 582
          description: 从该大宗交易ID开始查询
        - name: limit
          in: query
          required: false
          schema:
            type: integer
            format: int64
            example: 500
            default: 500
            maximum: 1000
          description: '默认: 500; 最大: 1000'
      x-parameters-notes: '- 数据源: 数据库'
      responses:
        '200':
          description: 历史大宗交易
          content:
            application/json:
              schema:
                type: array
                items:
                  type: object
                  properties:
                    id:
                      type: integer
                      example: 582
                      format: int64
                    price:
                      type: string
                      example: '0.052'
                    qty:
                      type: string
                      example: '5838'
                    quoteQty:
                      type: string
                      example: '303.576'
                    time:
                      type: integer
                      example: 1772506983321
                      format: int64
                    isBuyerMaker:
                      type: boolean
                      example: true
  /api/v3/klines:
    get:
      summary: K线数据
      description: 每根K线的开盘时间可视为唯一ID
      tags:
        - market
      operationId: klines
      externalDocs:
        url: https://developers.binance.com/en/docs/catalog/core-trading-spot-trading/api/rest-api/market#klines
      x-connectors-examples:
        ts: https://raw.githubusercontent.com/binance/binance-connector-js/master/clients/spot/examples/rest-api/MarketApi/klines.ts
        rust: https://raw.githubusercontent.com/binance/binance-connector-rust/main/examples/spot/rest_api/market_api/klines.rs
        python: https://raw.githubusercontent.com/binance/binance-connector-python/master/clients/spot/examples/rest_api/Market/klines.py
        java: https://raw.githubusercontent.com/binance/binance-connector-java/master/examples/spot/src/main/java/com/binance/connector/client/spot/rest/market/KlinesExample.java
        go: https://raw.githubusercontent.com/binance/binance-connector-go/main/clients/spot/examples/restapi/MarketAPI/Klines/Klines.go
        php: https://raw.githubusercontent.com/binance/binance-connector-php/master/examples/spot/market/KlinesExample.php
      x-ip-weight: 2
      x-security-type: NONE
      parameters:
        - name: symbol
          in: query
          required: true
          schema:
            type: string
            example: BNBUSDT
        - name: interval
          in: query
          required: true
          schema:
            type: string
            example: 1s
            enum:
              - 1s
              - 1m
              - 3m
              - 5m
              - 15m
              - 30m
              - 1h
              - 2h
              - 4h
              - 6h
              - 8h
              - 12h
              - 1d
              - 3d
              - 1w
              - 1M
        - name: startTime
          in: query
          required: false
          schema:
            type: integer
            format: int64
            example: 1735693200000
        - name: endTime
          in: query
          required: false
          schema:
            type: integer
            format: int64
            example: 1735693200000
        - name: timeZone
          in: query
          required: false
          description: 默认值： 0 (UTC)
          schema:
            type: string
            example: '0'
        - name: limit
          in: query
          required: false
          schema:
            type: integer
            example: 1
            default: 500
            maximum: 1000
      x-parameters-notes: |-
        **数据源:** 数据库

        支持的K线间隔 （区分大小写）：

        间隔  | `间隔` 值
        --------- | ----------------
        seconds -> 秒   | `1s`
        minutes -> 分钟 | `1m`， `3m`， `5m`， `15m`， `30m`
        hours -> 小时   | `1h`， `2h`， `4h`， `6h`， `8h`， `12h`
        days -> 天      | `1d`， `3d`
        weeks -> 周    | `1w`
        months -> 月  | `1M`

        **请注意：**

        * 如果未发送`startTime`和`endTime`，将返回最近的K线数据。
        * `timeZone`支持的值包括：
            * 小时和分钟（例如 `-1:00`，`05:45`）
            * 仅小时（例如 `0`，`8`，`4`）
            * 接受的值范围严格为 [-12:00 到 +14:00]（包括边界）
        * 如果提供了`timeZone`，K线间隔将在该时区中解释，而不是在UTC中。
        * 请注意，无论`timeZone`如何，`startTime`和`endTime`始终以UTC时区解释。
      responses:
        '200':
          description: K线数据
          content:
            application/json:
              schema:
                type: array
                items:
                  type: array
                  minItems: 12
                  maxItems: 12
                  x-prefixItems:
                    - type: integer
                      format: int64
                      description: 开盘时间
                      example: 1499040000000
                    - type: string
                      description: 开盘价
                      example: '0.01634790'
                    - type: string
                      description: 最高价
                      example: '0.80000000'
                    - type: string
                      description: 最低价
                      example: '0.01575800'
                    - type: string
                      description: 收盘价
                      example: '0.01577100'
                    - type: string
                      description: 成交量
                      example: '148976.11427815'
                    - type: integer
                      format: int64
                      description: 收盘时间
                      example: 1499644799999
                    - type: string
                      description: 成交额
                      example: '2434.19055334'
                    - type: integer
                      description: 成交笔数
                      example: 308
                    - type: string
                      description: 主动买入成交量
                      example: '1756.87402397'
                    - type: string
                      description: 主动买入成交额
                      example: '28.46694368'
                    - type: string
                      description: 忽略字段
                      example: '0'
                  items:
                    oneOf:
                      - type: integer
                        format: int64
                        description: 开盘时间
                        example: 1499040000000
                      - type: string
                        description: 开盘价
                        example: '0.01634790'
                      - type: string
                        description: 最高价
                        example: '0.80000000'
                      - type: string
                        description: 最低价
                        example: '0.01575800'
                      - type: string
                        description: 收盘价
                        example: '0.01577100'
                      - type: string
                        description: 成交量
                        example: '148976.11427815'
                      - type: integer
                        format: int64
                        description: 收盘时间
                        example: 1499644799999
                      - type: string
                        description: 成交额
                        example: '2434.19055334'
                      - type: integer
                        description: 成交笔数
                        example: 308
                      - type: string
                        description: 主动买入成交量
                        example: '1756.87402397'
                      - type: string
                        description: 主动买入成交额
                        example: '28.46694368'
                      - type: string
                        description: 忽略字段
                        example: '0'
  /api/v3/ticker:
    get:
      summary: 滚动窗口价格变动统计
      description: |-
        **注意:** 此接口和 `GET /api/v3/ticker/24hr` 有所不同.

        此接口统计的时间范围比请求的`windowSize`多不超过59999ms.

        接口的 `openTime` 是某一分钟的起始，而结束是当前的时间. 所以实际的统计区间会比请求的时间窗口多不超过59999ms.

        比如, 结束时间 `closeTime` 是 1641287867099 (January 04, 2022 09:17:47:099 UTC)
        , `windowSize` 为 `1d`. 那么开始时间 `openTime` 则为 1641201420000 (January 3,
        2022, 09:17:00 UTC)
      tags:
        - market
      operationId: ticker
      externalDocs:
        url: https://developers.binance.com/en/docs/catalog/core-trading-spot-trading/api/rest-api/market#ticker
      x-connectors-examples:
        ts: https://raw.githubusercontent.com/binance/binance-connector-js/master/clients/spot/examples/rest-api/MarketApi/ticker.ts
        rust: https://raw.githubusercontent.com/binance/binance-connector-rust/main/examples/spot/rest_api/market_api/ticker.rs
        python: https://raw.githubusercontent.com/binance/binance-connector-python/master/clients/spot/examples/rest_api/Market/ticker.py
        java: https://raw.githubusercontent.com/binance/binance-connector-java/master/examples/spot/src/main/java/com/binance/connector/client/spot/rest/market/TickerExample.java
        go: https://raw.githubusercontent.com/binance/binance-connector-go/main/clients/spot/examples/restapi/MarketAPI/Ticker/Ticker.go
        php: https://raw.githubusercontent.com/binance/binance-connector-php/master/examples/spot/market/TickerExample.php
      x-security-type: NONE
      x-weight: |-
        4 for each requested symbol regardless of windowSize.

        The weight for this request will cap at 200 once the number of `symbols` in the request is more than 50.
      parameters:
        - name: symbol
          in: query
          required: false
          description: 参数 `symbol` 和 `symbols` 不可以一起使用
          schema:
            type: string
            example: BNBUSDT
        - name: symbols
          in: query
          required: false
          description: |-
            参数 `symbol` 和 `symbols` 不可以一起使用
            如果都不提供, 所有symbol的ticker数据都会返回. symbols参数可接受的格式： ["BTCUSDT","BNBUSDT"]
            %5B%22BTCUSDT%22,%22BNBUSDT%22%5D
          schema:
            type: array
            example:
              - BTCUSDT
              - BNBUSDT
            items:
              type: string
              example: BTCUSDT
        - name: windowSize
          in: query
          required: false
          description: 不可以组合使用, 比如`1d2h`
          schema:
            type: string
            example: 1m
            default: 1d
            enum:
              - 1m
              - 2m
              - 3m
              - 4m
              - 5m
              - 6m
              - 7m
              - 8m
              - 9m
              - 10m
              - 11m
              - 12m
              - 13m
              - 14m
              - 15m
              - 16m
              - 17m
              - 18m
              - 19m
              - 20m
              - 21m
              - 22m
              - 23m
              - 24m
              - 25m
              - 26m
              - 27m
              - 28m
              - 29m
              - 30m
              - 31m
              - 32m
              - 33m
              - 34m
              - 35m
              - 36m
              - 37m
              - 38m
              - 39m
              - 40m
              - 41m
              - 42m
              - 43m
              - 44m
              - 45m
              - 46m
              - 47m
              - 48m
              - 49m
              - 50m
              - 51m
              - 52m
              - 53m
              - 54m
              - 55m
              - 56m
              - 57m
              - 58m
              - 59m
              - 1h
              - 2h
              - 3h
              - 4h
              - 5h
              - 6h
              - 7h
              - 8h
              - 9h
              - 10h
              - 11h
              - 12h
              - 13h
              - 14h
              - 15h
              - 16h
              - 17h
              - 18h
              - 19h
              - 20h
              - 21h
              - 22h
              - 23h
              - 1d
              - 2d
              - 3d
              - 4d
              - 5d
              - 6d
              - 7d
        - name: type
          in: query
          required: false
          schema:
            type: string
            example: FULL
            default: FULL
            enum:
              - FULL
              - MINI
        - name: symbolStatus
          in: query
          required: false
          schema:
            type: string
            enum:
              - TRADING
              - HALT
              - BREAK
            example: TRADING
            description: |-
              过滤具有此 `tradingStatus` 的交易对。
              对于单个交易对，如果状态不匹配，将返回错误 `-1220 交易对与状态不匹配`。
              对于多个或者全部交易对， 响应中不会包括状态不匹配的交易对。
      x-parameters-notes: '**数据源:** 数据库'
      responses:
        '200':
          description: Rolling 窗口 价格 修改 statistics
          content:
            application/json:
              schema:
                oneOf:
                  - type: object
                    properties:
                      symbol:
                        type: string
                        example: LTCBTC
                      priceChange:
                        type: string
                        example: -8
                        description: 价格变化
                      priceChangePercent:
                        type: string
                        example: -88.889
                        description: 价格变化百分比
                      weightedAvgPrice:
                        type: string
                        example: 2.60427807
                        description: QuoteVolume / 成交量
                      openPrice:
                        type: string
                        example: 0.1
                      highPrice:
                        type: string
                        example: 2
                      lowPrice:
                        type: string
                        example: 0.1
                      lastPrice:
                        type: string
                        example: 2
                      volume:
                        type: string
                        example: 39
                      quoteVolume:
                        type: string
                        example: 13.4
                        description: 此k线内所有交易的price(价格) x volume(交易量)的总和
                      openTime:
                        type: integer
                        format: int64
                        example: 1656986580000
                        description: ticker的开始时间
                      closeTime:
                        type: integer
                        format: int64
                        example: 1657001016795
                        description: ticker的结束时间
                      firstId:
                        type: integer
                        format: int64
                        example: 0
                        description: 统计时间内的第一笔trade id
                      lastId:
                        type: integer
                        format: int64
                        example: 34
                      count:
                        type: integer
                        format: int64
                        example: 35
                        description: 统计时间内交易笔数
                  - type: array
                    items:
                      type: object
                      properties:
                        symbol:
                          type: string
                          example: BTCUSDT
                        priceChange:
                          type: string
                          example: -154.13
                          description: 价格变化
                        priceChangePercent:
                          type: string
                          example: -0.74
                          description: 价格变化百分比
                        weightedAvgPrice:
                          type: string
                          example: 20677.4630525
                          description: QuoteVolume / 成交量
                        openPrice:
                          type: string
                          example: 20825.27
                        highPrice:
                          type: string
                          example: 20972.46
                        lowPrice:
                          type: string
                          example: 20327.92
                        lastPrice:
                          type: string
                          example: 20671.14
                        volume:
                          type: string
                          example: 72.651123
                        quoteVolume:
                          type: string
                          example: 1502240.91155513
                          description: 此k线内所有交易的price(价格) x volume(交易量)的总和
                        openTime:
                          type: integer
                          format: int64
                          example: 1655432400000
                          description: ticker的开始时间
                        closeTime:
                          type: integer
                          format: int64
                          example: 1655446835460
                          description: ticker的结束时间
                        firstId:
                          type: integer
                          format: int64
                          example: 11147809
                          description: 统计时间内的第一笔trade id
                        lastId:
                          type: integer
                          format: int64
                          example: 11149775
                        count:
                          type: integer
                          format: int64
                          example: 1967
                          description: 统计时间内交易笔数
  /api/v3/ticker/24hr:
    get:
      summary: 24hr价格变动情况
      description: 请注意，不携带symbol参数会返回全部交易对数据，不仅数据庞大，而且权重极高
      tags:
        - market
      operationId: ticker24hr
      externalDocs:
        url: https://developers.binance.com/en/docs/catalog/core-trading-spot-trading/api/rest-api/market#ticker24hr
      x-connectors-examples:
        ts: https://raw.githubusercontent.com/binance/binance-connector-js/master/clients/spot/examples/rest-api/MarketApi/ticker24hr.ts
        rust: https://raw.githubusercontent.com/binance/binance-connector-rust/main/examples/spot/rest_api/market_api/ticker24hr.rs
        python: https://raw.githubusercontent.com/binance/binance-connector-python/master/clients/spot/examples/rest_api/Market/ticker24hr.py
        java: https://raw.githubusercontent.com/binance/binance-connector-java/master/examples/spot/src/main/java/com/binance/connector/client/spot/rest/market/Ticker24hrExample.java
        go: https://raw.githubusercontent.com/binance/binance-connector-go/main/clients/spot/examples/restapi/MarketAPI/Ticker24hr/Ticker24hr.go
        php: https://raw.githubusercontent.com/binance/binance-connector-php/master/examples/spot/market/Ticker24hrExample.php
      x-security-type: NONE
      x-weight: |-
        <table>
          <thead>
              <tr>
                  <th>Parameter</th>
                  <th>Symbols Provided</th>
                  <th>Weight</th>
              </tr>
          </thead>
          <tbody>
              <tr>
                  <td rowspan="2">symbol</td>
                  <td>1</td>
                  <td>2</td>
              </tr>
              <tr>
                  <td>symbol parameter is omitted</td>
                  <td>80</td>
              </tr>
              <tr>
                  <td rowspan="4">symbols</td>
                  <td>1-20</td>
                  <td>2</td>
              </tr>
              <tr>
                  <td>21-100</td>
                  <td>40</td>
              </tr>
              <tr>
                  <td>101 or more</td>
                  <td>80</td>
              </tr>
              <tr>
                  <td>symbols parameter is omitted</td>
                  <td>80</td>
              </tr>
          </tbody>
        </table>
      parameters:
        - name: symbol
          in: query
          required: false
          description: 参数 `symbol` 和 `symbols` 不可以一起使用
          schema:
            type: string
            example: BNBUSDT
        - name: symbols
          in: query
          required: false
          description: |-
            参数 `symbol` 和 `symbols` 不可以一起使用
            如果都不提供, 所有symbol的ticker数据都会返回. symbols参数可接受的格式： ["BTCUSDT","BNBUSDT"]
            %5B%22BTCUSDT%22,%22BNBUSDT%22%5D
          schema:
            type: array
            example:
              - BTCUSDT
              - BNBUSDT
            items:
              type: string
              example: BTCUSDT
        - name: type
          in: query
          required: false
          schema:
            type: string
            example: FULL
            default: FULL
            enum:
              - FULL
              - MINI
        - name: symbolStatus
          in: query
          required: false
          schema:
            type: string
            enum:
              - TRADING
              - HALT
              - BREAK
            example: TRADING
            description: |-
              过滤具有此 `tradingStatus` 的交易对。
              对于单个交易对，如果状态不匹配，将返回错误 `-1220 交易对与状态不匹配`。
              对于多个或者全部交易对， 响应中不会包括状态不匹配的交易对。
      x-parameters-notes: '**数据源:** 缓存'
      responses:
        '200':
          description: 24hr ticker 价格 修改 statistics
          content:
            application/json:
              schema:
                oneOf:
                  - type: object
                    properties:
                      symbol:
                        type: string
                        example: BNBBTC
                        description: 交易对
                      priceChange:
                        type: string
                        example: -94.999998
                      priceChangePercent:
                        type: string
                        example: -95.96
                      weightedAvgPrice:
                        type: string
                        example: 0.29628482
                      prevClosePrice:
                        type: string
                        example: 0.10002
                      lastPrice:
                        type: string
                        example: 4.000002
                        description: 间隔收盘价
                      lastQty:
                        type: string
                        example: 200
                      bidPrice:
                        type: string
                        example: 4
                      bidQty:
                        type: string
                        example: 100
                      askPrice:
                        type: string
                        example: 4.000002
                      askQty:
                        type: string
                        example: 100
                      openPrice:
                        type: string
                        example: 99
                        description: 间隔开盘价
                      highPrice:
                        type: string
                        example: 100
                        description: 间隔最高价
                      lowPrice:
                        type: string
                        example: 0.1
                        description: 间隔最低价
                      volume:
                        type: string
                        example: 8913.3
                        description: 总交易量 (base asset)
                      quoteVolume:
                        type: string
                        example: 15.3
                        description: 总交易量 (quote asset)
                      openTime:
                        type: integer
                        format: int64
                        example: 1499783499040
                        description: ticker间隔的开始时间
                      closeTime:
                        type: integer
                        format: int64
                        example: 1499869899040
                        description: ticker间隔的结束时间
                      firstId:
                        type: integer
                        format: int64
                        example: 28385
                        description: 首笔成交id
                      lastId:
                        type: integer
                        format: int64
                        example: 28460
                        description: 末笔成交id
                      count:
                        type: integer
                        format: int64
                        example: 76
                        description: 成交笔数
                  - type: array
                    items:
                      type: object
                      properties:
                        symbol:
                          type: string
                          example: BNBBTC
                          description: 交易对
                        priceChange:
                          type: string
                          example: -94.999998
                        priceChangePercent:
                          type: string
                          example: -95.96
                        weightedAvgPrice:
                          type: string
                          example: 0.29628482
                        prevClosePrice:
                          type: string
                          example: 0.10002
                        lastPrice:
                          type: string
                          example: 4.000002
                          description: 间隔收盘价
                        lastQty:
                          type: string
                          example: 200
                        bidPrice:
                          type: string
                          example: 4
                        bidQty:
                          type: string
                          example: 100
                        askPrice:
                          type: string
                          example: 4.000002
                        askQty:
                          type: string
                          example: 100
                        openPrice:
                          type: string
                          example: 99
                          description: 间隔开盘价
                        highPrice:
                          type: string
                          example: 100
                          description: 间隔最高价
                        lowPrice:
                          type: string
                          example: 0.1
                          description: 间隔最低价
                        volume:
                          type: string
                          example: 8913.3
                          description: 总交易量 (base asset)
                        quoteVolume:
                          type: string
                          example: 15.3
                          description: 总交易量 (quote asset)
                        openTime:
                          type: integer
                          format: int64
                          example: 1499783499040
                          description: ticker间隔的开始时间
                        closeTime:
                          type: integer
                          format: int64
                          example: 1499869899040
                          description: ticker间隔的结束时间
                        firstId:
                          type: integer
                          format: int64
                          example: 28385
                          description: 首笔成交id
                        lastId:
                          type: integer
                          format: int64
                          example: 28460
                          description: 末笔成交id
                        count:
                          type: integer
                          format: int64
                          example: 76
                          description: 成交笔数
  /api/v3/ticker/bookTicker:
    get:
      summary: 最优挂单接口
      description: 返回当前最优的挂单(最高买单，最低卖单)
      tags:
        - market
      operationId: tickerBookTicker
      externalDocs:
        url: https://developers.binance.com/en/docs/catalog/core-trading-spot-trading/api/rest-api/market#ticker-book-ticker
      x-connectors-examples:
        ts: https://raw.githubusercontent.com/binance/binance-connector-js/master/clients/spot/examples/rest-api/MarketApi/tickerBookTicker.ts
        rust: https://raw.githubusercontent.com/binance/binance-connector-rust/main/examples/spot/rest_api/market_api/ticker_book_ticker.rs
        python: https://raw.githubusercontent.com/binance/binance-connector-python/master/clients/spot/examples/rest_api/Market/ticker_book_ticker.py
        java: https://raw.githubusercontent.com/binance/binance-connector-java/master/examples/spot/src/main/java/com/binance/connector/client/spot/rest/market/TickerBookTickerExample.java
        go: https://raw.githubusercontent.com/binance/binance-connector-go/main/clients/spot/examples/restapi/MarketAPI/TickerBookTicker/TickerBookTicker.go
        php: https://raw.githubusercontent.com/binance/binance-connector-php/master/examples/spot/market/TickerBookTickerExample.php
      x-security-type: NONE
      x-weight: |-
        |Parameter|Symbols Provided|Weight|
        |---|---|---|
        |symbol| 1 |2|
        | |omitted| 4|
        |symbols| Any |4|
      parameters:
        - name: symbol
          in: query
          required: false
          description: |-
            参数 `symbol` 和 `symbols` 不可以一起使用
            如果都不提供, 所有symbol的bookTicker数据都会返回.
          schema:
            type: string
            example: BNBUSDT
        - name: symbols
          in: query
          required: false
          description: |-
            参数 `symbol` 和 `symbols` 不可以一起使用
            如果都不提供, 所有symbol的bookTicker数据都会返回.

            symbols参数可接受的格式： ["BTCUSDT","BNBUSDT"] 或 %5B%22BTCUSDT%22,%22BNBUSDT%22%5D
          schema:
            type: array
            example:
              - BTCUSDT
              - BNBUSDT
            items:
              type: string
              example: BTCUSDT
        - name: symbolStatus
          in: query
          required: false
          description: |-
            过滤具有此 `tradingStatus` 的交易对。
            对于单个交易对，如果状态不匹配，将返回错误 `-1220 交易对与状态不匹配`。
            对于多个或者全部交易对，响应中不会包括状态不匹配的交易对。
          schema:
            type: string
            enum:
              - TRADING
              - HALT
              - BREAK
            example: TRADING
      x-parameters-notes: '**数据源:** 缓存'
      responses:
        '200':
          description: 最优挂单接口
          content:
            application/json:
              schema:
                oneOf:
                  - type: object
                    properties:
                      symbol:
                        type: string
                        example: LTCBTC
                      bidPrice:
                        type: string
                        example: 4
                        description: best bid price.
                      bidQty:
                        type: string
                        example: 431
                        description: bid/ask qty.
                      askPrice:
                        type: string
                        example: 4.000002
                        description: best ask price.
                      askQty:
                        type: string
                        example: 9
                        description: bid/ask qty.
                  - type: array
                    items:
                      type: object
                      properties:
                        symbol:
                          type: string
                          example: LTCBTC
                        bidPrice:
                          type: string
                          example: 4
                          description: best bid price.
                        bidQty:
                          type: string
                          example: 431
                          description: bid/ask qty.
                        askPrice:
                          type: string
                          example: 4.000002
                          description: best ask price.
                        askQty:
                          type: string
                          example: 9
                          description: bid/ask qty.
  /api/v3/ticker/price:
    get:
      summary: 最新价格接口
      description: 返回最近价格
      tags:
        - market
      operationId: tickerPrice
      externalDocs:
        url: https://developers.binance.com/en/docs/catalog/core-trading-spot-trading/api/rest-api/market#ticker-price
      x-connectors-examples:
        ts: https://raw.githubusercontent.com/binance/binance-connector-js/master/clients/spot/examples/rest-api/MarketApi/tickerPrice.ts
        rust: https://raw.githubusercontent.com/binance/binance-connector-rust/main/examples/spot/rest_api/market_api/ticker_price.rs
        python: https://raw.githubusercontent.com/binance/binance-connector-python/master/clients/spot/examples/rest_api/Market/ticker_price.py
        java: https://raw.githubusercontent.com/binance/binance-connector-java/master/examples/spot/src/main/java/com/binance/connector/client/spot/rest/market/TickerPriceExample.java
        go: https://raw.githubusercontent.com/binance/binance-connector-go/main/clients/spot/examples/restapi/MarketAPI/TickerPrice/TickerPrice.go
        php: https://raw.githubusercontent.com/binance/binance-connector-php/master/examples/spot/market/TickerPriceExample.php
      x-security-type: NONE
      x-weight: |-
        |Parameter|Symbols Provided|Weight|
        |---|---|---|
        |symbol| 1 |2|
        | |omitted| 4|
        |symbols| Any |4|
      parameters:
        - name: symbol
          in: query
          required: false
          description: |-
            参数 `symbol` 和 `symbols` 不可以一起使用
            如果都不提供, 所有symbol的价格数据都会返回.
          schema:
            type: string
            example: BNBUSDT
        - name: symbols
          in: query
          required: false
          description: |-
            参数 `symbol` 和 `symbols` 不可以一起使用
            如果都不提供, 所有symbol的价格数据都会返回.

            symbols参数可接受的格式： ["BTCUSDT","BNBUSDT"] 或 %5B%22BTCUSDT%22,%22BNBUSDT%22%5D
          schema:
            type: array
            example:
              - BTCUSDT
              - BNBUSDT
            items:
              type: string
              example: BTCUSDT
        - name: symbolStatus
          in: query
          required: false
          description: |-
            过滤具有此 `tradingStatus` 的交易对。
            对于单个交易对，如果状态不匹配，将返回错误 `-1220 交易对与状态不匹配`。
            对于多个或者全部交易对，响应中不会包括状态不匹配的交易对。
          schema:
            type: string
            enum:
              - TRADING
              - HALT
              - BREAK
            example: TRADING
      x-parameters-notes: '**数据源:** 缓存'
      responses:
        '200':
          description: 最新价格接口
          content:
            application/json:
              schema:
                oneOf:
                  - type: object
                    properties:
                      symbol:
                        type: string
                        example: LTCBTC
                      price:
                        type: string
                        example: 4.000002
                  - type: array
                    items:
                      type: object
                      properties:
                        symbol:
                          type: string
                          example: LTCBTC
                        price:
                          type: string
                          example: 4.000002
  /api/v3/ticker/tradingDay:
    get:
      summary: 交易日行情(Ticker
      description: 交易日价格变动统计。
      tags:
        - market
      operationId: tickerTradingDay
      externalDocs:
        url: https://developers.binance.com/en/docs/catalog/core-trading-spot-trading/api/rest-api/market#ticker-trading-day
      x-connectors-examples:
        ts: https://raw.githubusercontent.com/binance/binance-connector-js/master/clients/spot/examples/rest-api/MarketApi/tickerTradingDay.ts
        rust: https://raw.githubusercontent.com/binance/binance-connector-rust/main/examples/spot/rest_api/market_api/ticker_trading_day.rs
        python: https://raw.githubusercontent.com/binance/binance-connector-python/master/clients/spot/examples/rest_api/Market/ticker_trading_day.py
        java: https://raw.githubusercontent.com/binance/binance-connector-java/master/examples/spot/src/main/java/com/binance/connector/client/spot/rest/market/TickerTradingDayExample.java
        go: https://raw.githubusercontent.com/binance/binance-connector-go/main/clients/spot/examples/restapi/MarketAPI/TickerTradingDay/TickerTradingDay.go
        php: https://raw.githubusercontent.com/binance/binance-connector-php/master/examples/spot/market/TickerTradingDayExample.php
      x-security-type: NONE
      x-weight: 4 for each requested symbol. The weight for this request will cap at 200 once the number of symbols in the request is more than 50.
      parameters:
        - name: symbol
          in: query
          required: false
          description: '`symbol` 或者 `symbols` 必须提供之'
          schema:
            type: string
            example: BNBUSDT
        - name: symbols
          in: query
          required: false
          description: |-
            `symbol` 或者 `symbols` 必须提供之一
            `symbols` 可以接受的格式: ["BTCUSDT","BNBUSDT"] 或者 %5B%22BTCUSDT%22,%22BNBUSDT%22%5D.
            `symbols` 最多可以发送100个.
          schema:
            type: array
            example:
              - BTCUSDT
              - BNBUSDT
            items:
              type: string
              example: BTCUSDT
        - name: timeZone
          in: query
          required: false
          description: 默认值： 0 (UTC)
          schema:
            type: string
            example: '0'
            default: '0'
        - name: type
          in: query
          required: false
          schema:
            type: string
            enum:
              - FULL
              - MINI
            example: FULL
            default: FULL
        - name: symbolStatus
          in: query
          required: false
          description: |-
            过滤具有此 `tradingStatus` 的交易对。
            对于单个交易对，如果状态不匹配，将返回错误 `-1220 交易对与状态不匹配`。
            对于多个交易对，响应中不会包括状态不匹配的交易对。
          schema:
            type: string
            enum:
              - TRADING
              - HALT
              - BREAK
            example: TRADING
      x-parameters-notes: |-
        **数据源:** 数据库

        **注意:**
          - `timeZone`支持的值包括：
            - 小时和分钟（例如 `-1:00`，`05:45`）
            - 仅小时（例如 `0`，`8`，`4`）
      responses:
        '200':
          description: Trading Day 行情
          content:
            application/json:
              schema:
                oneOf:
                  - type: object
                    properties:
                      symbol:
                        type: string
                        example: BTCUSDT
                      priceChange:
                        type: string
                        example: -83.13
                        description: 绝对价格变动
                      priceChangePercent:
                        type: string
                        example: -0.317
                        description: 相对价格变动百分比
                      weightedAvgPrice:
                        type: string
                        example: 26234.58803036
                        description: 报价成交量 / 成交量
                      openPrice:
                        type: string
                        example: 26304.8
                      highPrice:
                        type: string
                        example: 26397.46
                      lowPrice:
                        type: string
                        example: 26088.34
                      lastPrice:
                        type: string
                        example: 26221.67
                      volume:
                        type: string
                        example: 18495.35066
                        description: 基础资产的成交量
                      quoteVolume:
                        type: string
                        example: 485217905.0421048
                        description: 报价资产的成交量
                      openTime:
                        type: integer
                        format: int64
                        example: 1695686400000
                      closeTime:
                        type: integer
                        format: int64
                        example: 1695772799999
                      firstId:
                        type: integer
                        format: int64
                        example: 3220151555
                        description: 区间内的第一个交易的交易ID
                      lastId:
                        type: integer
                        format: int64
                        example: 3220849281
                        description: 区间内的最后一个交易的交易ID
                      count:
                        type: integer
                        format: int64
                        example: 697727
                        description: 区间内的交易数量
                  - type: array
                    items:
                      type: object
                      properties:
                        symbol:
                          type: string
                          example: BTCUSDT
                        priceChange:
                          type: string
                          example: -83.13
                          description: 绝对价格变动
                        priceChangePercent:
                          type: string
                          example: -0.317
                          description: 相对价格变动百分比
                        weightedAvgPrice:
                          type: string
                          example: 26234.58803036
                          description: 报价成交量 / 成交量
                        openPrice:
                          type: string
                          example: 26304.8
                        highPrice:
                          type: string
                          example: 26397.46
                        lowPrice:
                          type: string
                          example: 26088.34
                        lastPrice:
                          type: string
                          example: 26221.67
                        volume:
                          type: string
                          example: 18495.35066
                          description: 基础资产的成交量
                        quoteVolume:
                          type: string
                          example: 485217905.0421048
                          description: 报价资产的成交量
                        openTime:
                          type: integer
                          format: int64
                          example: 1695686400000
                        closeTime:
                          type: integer
                          format: int64
                          example: 1695772799999
                        firstId:
                          type: integer
                          format: int64
                          example: 3220151555
                          description: 区间内的第一个交易的交易ID
                        lastId:
                          type: integer
                          format: int64
                          example: 3220849281
                          description: 区间内的最后一个交易的交易ID
                        count:
                          type: integer
                          format: int64
                          example: 697727
                          description: 区间内的交易数量
  /api/v3/uiKlines:
    get:
      summary: UIK线数据
      description: |-
        请求参数与响应和k线接口相同。

        `uiKlines` 返回修改后的k线数据，针对k线图的呈现进行了优化。
      tags:
        - market
      operationId: uiKlines
      externalDocs:
        url: https://developers.binance.com/en/docs/catalog/core-trading-spot-trading/api/rest-api/market#ui-klines
      x-connectors-examples:
        ts: https://raw.githubusercontent.com/binance/binance-connector-js/master/clients/spot/examples/rest-api/MarketApi/uiKlines.ts
        rust: https://raw.githubusercontent.com/binance/binance-connector-rust/main/examples/spot/rest_api/market_api/ui_klines.rs
        python: https://raw.githubusercontent.com/binance/binance-connector-python/master/clients/spot/examples/rest_api/Market/ui_klines.py
        java: https://raw.githubusercontent.com/binance/binance-connector-java/master/examples/spot/src/main/java/com/binance/connector/client/spot/rest/market/UiKlinesExample.java
        go: https://raw.githubusercontent.com/binance/binance-connector-go/main/clients/spot/examples/restapi/MarketAPI/UiKlines/UiKlines.go
        php: https://raw.githubusercontent.com/binance/binance-connector-php/master/examples/spot/market/UiKlinesExample.php
      x-ip-weight: 2
      x-security-type: NONE
      parameters:
        - name: symbol
          in: query
          required: true
          schema:
            type: string
            example: BNBUSDT
        - name: interval
          in: query
          required: true
          schema:
            type: string
            enum:
              - 1s
              - 1m
              - 3m
              - 5m
              - 15m
              - 30m
              - 1h
              - 2h
              - 4h
              - 6h
              - 8h
              - 12h
              - 1d
              - 3d
              - 1w
              - 1M
            example: 1s
        - name: startTime
          in: query
          required: false
          schema:
            type: integer
            format: int64
            example: 1735693200000
        - name: endTime
          in: query
          required: false
          schema:
            type: integer
            format: int64
            example: 1735693200000
        - name: timeZone
          in: query
          required: false
          description: 默认值： 0 (UTC)
          schema:
            type: string
            example: '0'
            default: '0'
        - name: limit
          in: query
          required: false
          schema:
            type: integer
            example: 1
            default: 500
            maximum: 1000
      x-parameters-notes: |-
        **数据源:** 数据库

        - 如果未发送 `startTime` 和 `endTime`，默认返回最近的交易。
        - `timeZone`支持的值包括：
            - 小时和分钟（例如 `-1:00`，`05:45`）
            - 仅小时（例如 `0`，`8`，`4`） 
            - 接受的值范围严格为 [-12:00 到 +14:00]（包括边界）
        - 如果提供了`timeZone`，K线间隔将在该时区中解释，而不是在UTC中。
        - 请注意，无论`timeZone`如何，`startTime`和`endTime`始终以UTC时区解释。
      responses:
        '200':
          description: UIK线数据
          content:
            application/json:
              schema:
                type: array
                items:
                  type: array
                  minItems: 12
                  maxItems: 12
                  x-prefixItems:
                    - type: integer
                      format: int64
                      description: 开盘时间
                      example: 1499040000000
                    - type: string
                      description: 开盘价
                      example: '0.01634790'
                    - type: string
                      description: 最高价
                      example: '0.80000000'
                    - type: string
                      description: 最低价
                      example: '0.01575800'
                    - type: string
                      description: 收盘价
                      example: '0.01577100'
                    - type: string
                      description: 成交量
                      example: '148976.11427815'
                    - type: integer
                      format: int64
                      description: 收盘时间
                      example: 1499644799999
                    - type: string
                      description: 成交额
                      example: '2434.19055334'
                    - type: integer
                      description: 成交笔数
                      example: 308
                    - type: string
                      description: 主动买入成交量
                      example: '1756.87402397'
                    - type: string
                      description: 主动买入成交额
                      example: '28.46694368'
                    - type: string
                      description: 忽略字段
                      example: '0'
                  items:
                    oneOf:
                      - type: integer
                        format: int64
                        description: 开盘时间
                        example: 1499040000000
                      - type: string
                        description: 开盘价
                        example: '0.01634790'
                      - type: string
                        description: 最高价
                        example: '0.80000000'
                      - type: string
                        description: 最低价
                        example: '0.01575800'
                      - type: string
                        description: 收盘价
                        example: '0.01577100'
                      - type: string
                        description: 成交量
                        example: '148976.11427815'
                      - type: integer
                        format: int64
                        description: 收盘时间
                        example: 1499644799999
                      - type: string
                        description: 成交额
                        example: '2434.19055334'
                      - type: integer
                        description: 成交笔数
                        example: 308
                      - type: string
                        description: 主动买入成交量
                        example: '1756.87402397'
                      - type: string
                        description: 主动买入成交额
                        example: '28.46694368'
                      - type: string
                        description: 忽略字段
                        example: '0'
  /api/v3/referencePrice:
    get:
      summary: 查询参考价格
      description: 查询某个交易对的参考价格。
      tags:
        - market
      operationId: referencePrice
      externalDocs:
        url: https://developers.binance.com/en/docs/catalog/core-trading-spot-trading/api/rest-api/market#reference-price
      x-connectors-examples:
        ts: https://raw.githubusercontent.com/binance/binance-connector-js/master/clients/spot/examples/rest-api/MarketApi/referencePrice.ts
        rust: https://raw.githubusercontent.com/binance/binance-connector-rust/main/examples/spot/rest_api/market_api/reference_price.rs
        python: https://raw.githubusercontent.com/binance/binance-connector-python/master/clients/spot/examples/rest_api/Market/reference_price.py
        java: https://raw.githubusercontent.com/binance/binance-connector-java/master/examples/spot/src/main/java/com/binance/connector/client/spot/rest/market/ReferencePriceExample.java
        go: https://raw.githubusercontent.com/binance/binance-connector-go/main/clients/spot/examples/restapi/MarketAPI/ReferencePrice/ReferencePrice.go
        php: https://raw.githubusercontent.com/binance/binance-connector-php/master/examples/spot/market/ReferencePriceExample.php
      x-ip-weight: 2
      x-security-type: NONE
      parameters:
        - name: symbol
          in: query
          required: true
          schema:
            type: string
            example: BNBUSDT
      x-parameters-notes: '**数据源:** 缓存'
      responses:
        '200':
          description: 参考价格
          content:
            application/json:
              schema:
                type: object
                properties:
                  symbol:
                    type: string
                    example: BAZUSD
                  referencePrice:
                    type: string
                    example: '10.00'
                    description: 参考价格。如果没有设置参考价格，则为 `null`。
                  timestamp:
                    type: integer
                    format: int64
                    example: 1770736694138
                    description: 参考价格有效时的时间戳。
  /api/v3/referencePrice/calculation:
    get:
      summary: 查询参考价格计算方式
      description: 描述某个交易对的参考价格是如何计算的。
      tags:
        - market
      operationId: referencePriceCalculation
      externalDocs:
        url: https://developers.binance.com/en/docs/catalog/core-trading-spot-trading/api/rest-api/market#reference-price-calculation
      x-connectors-examples:
        ts: https://raw.githubusercontent.com/binance/binance-connector-js/master/clients/spot/examples/rest-api/MarketApi/referencePriceCalculation.ts
        rust: https://raw.githubusercontent.com/binance/binance-connector-rust/main/examples/spot/rest_api/market_api/reference_price_calculation.rs
        python: https://raw.githubusercontent.com/binance/binance-connector-python/master/clients/spot/examples/rest_api/Market/reference_price_calculation.py
        java: https://raw.githubusercontent.com/binance/binance-connector-java/master/examples/spot/src/main/java/com/binance/connector/client/spot/rest/market/ReferencePriceCalculationExample.java
        go: https://raw.githubusercontent.com/binance/binance-connector-go/main/clients/spot/examples/restapi/MarketAPI/ReferencePriceCalculation/ReferencePriceCalculation.go
        php: https://raw.githubusercontent.com/binance/binance-connector-php/master/examples/spot/market/ReferencePriceCalculationExample.php
      x-ip-weight: 2
      x-security-type: NONE
      parameters:
        - name: symbol
          in: query
          required: true
          schema:
            type: string
            example: BNBUSDT
        - name: symbolStatus
          in: query
          required: false
          description: '支持的值: `TRADING`, `HALT`, `BREAK`'
          schema:
            type: string
            enum:
              - TRADING
              - HALT
              - BREAK
            example: TRADING
      x-parameters-notes: '**数据源:** 缓存'
      responses:
        '200':
          description: 参考价格计算方式
          content:
            application/json:
              schema:
                type: object
                properties:
                  symbol:
                    type: string
                    example: BAZUSD
                  calculationType:
                    type: string
                    example: ARITHMETIC_MEAN
                    description: '`ARITHMETIC_MEAN` 或 `EXTERNAL`。'
                  bucketCount:
                    type: integer
                    format: int64
                    example: 10
                    description: 当 calculationType 为 ARITHMETIC_MEAN 时存在。
                  bucketWidthMs:
                    type: integer
                    format: int64
                    example: 1000
                    description: 当 calculationType 为 ARITHMETIC_MEAN 时存在。
                  externalCalculationId:
                    type: integer
                    format: int64
                    example: 42
                    description: 当 calculationType 为 EXTERNAL 时存在。
  /api/v3/order/amend/keepPriority:
    put:
      summary: 修改订单并保留优先级 (TRADE)
      description: |-
        由客户发送以减少其现有当前订单的原始数量。

        这个请求将添加0个订单到 `EXCHANGE_MAX_ORDERS` 过滤器和 `MAX_NUM_ORDERS` 过滤器中。

        请阅读 保留优先权的修改订单常见问题 了解更多信息。
      tags:
        - trade
      operationId: orderAmendKeepPriority
      externalDocs:
        url: https://developers.binance.com/en/docs/catalog/core-trading-spot-trading/api/rest-api/trade#order-amend-keep-priority
      x-connectors-examples:
        ts: https://raw.githubusercontent.com/binance/binance-connector-js/master/clients/spot/examples/rest-api/TradeApi/orderAmendKeepPriority.ts
        rust: https://raw.githubusercontent.com/binance/binance-connector-rust/main/examples/spot/rest_api/trade_api/order_amend_keep_priority.rs
        python: https://raw.githubusercontent.com/binance/binance-connector-python/master/clients/spot/examples/rest_api/Trade/order_amend_keep_priority.py
        java: https://raw.githubusercontent.com/binance/binance-connector-java/master/examples/spot/src/main/java/com/binance/connector/client/spot/rest/trade/OrderAmendKeepPriorityExample.java
        go: https://raw.githubusercontent.com/binance/binance-connector-go/main/clients/spot/examples/restapi/TradeAPI/OrderAmendKeepPriority/OrderAmendKeepPriority.go
        php: https://raw.githubusercontent.com/binance/binance-connector-php/master/examples/spot/trade/OrderAmendKeepPriorityExample.php
      x-ip-weight: 4
      x-order-weight: 0
      x-security-type: TRADE
      x-signed: true
      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
      x-parameters-notes: '**数据源:** 撮合引擎'
      requestBody:
        required: true
        content:
          application/x-www-form-urlencoded:
            schema:
              type: object
              required:
                - symbol
                - newQty
                - timestamp
              properties:
                symbol:
                  type: string
                  example: BNBUSDT
                orderId:
                  type: integer
                  format: int64
                  example: 1
                  description: 需提供 `orderId` 或 `origClientOrderId`。
                origClientOrderId:
                  type: string
                  example: myOrder1
                  description: 需提供 `orderId` 或 `origClientOrderId`。
                newClientOrderId:
                  type: string
                  example: myOrder2
                  description: 订单在被修改后被赋予的新 client order ID。 <br> 如果未发送则自动生成。 <br> 可以将当前 clientOrderId 作为 `newClientOrderId` 发送来重用当前 clientOrderId 的值。
                newQty:
                  type: number
                  format: float
                  example: 1
                  description: 交易的新数量。 `newQty` 必须大于0, 但是必须比订单的原始数量小。
                recvWindow:
                  type: number
                  format: float
                  example: 5000
                  description: 最大值为 `60000` 毫秒。 <br> 支持最多三位小数的精度（例如 6000.346），以便可以指定微秒。
                timestamp:
                  type: integer
                  example: 1770736694138
                  format: int64
                  description: 用于请求签名的 Unix 时间戳，单位为毫秒. 该值必须反映客户端当前时间，并会在签名接口中由服务器进行校验.
      responses:
        '200':
          description: 修改订单并保留优先级
          content:
            application/json:
              schema:
                type: object
                properties:
                  transactTime:
                    type: integer
                    format: int64
                    example: 1741926410255
                  executionId:
                    type: integer
                    format: int64
                    example: 75
                  amendedOrder:
                    type: object
                    properties:
                      symbol:
                        type: string
                        example: BTCUSDT
                      orderId:
                        type: integer
                        format: int64
                        example: 33
                      orderListId:
                        type: integer
                        format: int64
                        example: -1
                      origClientOrderId:
                        type: string
                        example: 5xrgbMyg6z36NzBn2pbT8H
                      clientOrderId:
                        type: string
                        example: PFaq6hIHxqFENGfdtn4J6Q
                      price:
                        type: string
                        example: '6.00000000'
                      qty:
                        type: string
                        example: '5.00000000'
                      executedQty:
                        type: string
                        example: '0.00000000'
                      preventedQty:
                        type: string
                        example: '0.00000000'
                      quoteOrderQty:
                        type: string
                        example: '0.00000000'
                      cumulativeQuoteQty:
                        type: string
                        example: '0.00000000'
                      status:
                        type: string
                        example: NEW
                      timeInForce:
                        type: string
                        example: GTC
                      type:
                        type: string
                        example: LIMIT
                      side:
                        type: string
                        example: SELL
                      workingTime:
                        type: integer
                        format: int64
                        example: 1741926410242
                      selfTradePreventionMode:
                        type: string
                        example: NONE
                      icebergQty:
                        type: string
                        example: '0.00000000'
                        description: 仅在请求中发送了 icebergQty 参数时出现。
                      preventedMatchId:
                        type: integer
                        format: int64
                        example: 0
                        description: 仅在因 STP 导致订单失效时出现。
                      preventedQuantity:
                        type: string
                        example: '1.200000'
                        description: 因 STP 导致订单失效的数量。
                      stopPrice:
                        type: string
                        example: '0.00000000'
                        description: 出现在 STOP_LOSS, TAKE_PROFIT, STOP_LOSS_LIMIT 和 TAKE_PROFIT_LIMIT 订单中。
                      strategyId:
                        type: integer
                        format: int64
                        example: 1
                        description: 仅在下单时提供了 strategyId 参数时出现。
                      strategyType:
                        type: integer
                        format: int64
                        example: 1000000
                        description: 仅在下单时提供了 strategyType 参数时出现。
                      trailingDelta:
                        type: integer
                        format: int64
                        example: 10
                        description: 订单激活前所需的价格变动。
                      trailingTime:
                        type: integer
                        format: int64
                        example: -1
                        description: 追踪单被激活和跟踪价格变化的时间。
                      usedSor:
                        type: boolean
                        example: true
                        description: 用于确定订单是否使用SOR的字段。
                      workingFloor:
                        type: string
                        example: SOR
                        description: 用以定义订单是通过 SOR 还是由订单簿成交的。
                      pegPriceType:
                        type: string
                        example: PRIMARY_PEG
                        description: 挂钩价格类型。仅用于挂钩订单。
                      pegOffsetType:
                        type: string
                        example: PRICE_LEVEL
                        description: 挂钩价格偏移类型。如若需要，仅用于挂钩订单。
                      pegOffsetValue:
                        type: integer
                        format: int64
                        example: 5
                        description: 挂钩价格偏移值。如若需要，仅用于挂钩订单。
                      peggedPrice:
                        type: string
                        example: '87523.83710000'
                        description: 订单对应的当前挂钩价格。一旦确定，仅用于挂钩订单。
                      expiryReason:
                        type: string
                        example: INSUFFICIENT_LIQUIDITY
                        description: 订单过期的原因。当订单过期时出现。
                  listStatus:
                    type: object
                    properties:
                      orderListId:
                        type: integer
                        format: int64
                        example: 1
                      contingencyType:
                        type: string
                        example: OTO
                      listOrderStatus:
                        type: string
                        example: EXECUTING
                      listClientOrderId:
                        type: string
                        example: AT7FTxZXylVSwRoZs52mt3
                      symbol:
                        type: string
                        example: BTCUSDT
                      orders:
                        type: array
                        items:
                          type: object
                          properties:
                            symbol:
                              type: string
                              example: BTCUSDT
                            orderId:
                              type: integer
                              format: int64
                              example: 8
                            clientOrderId:
                              type: string
                              example: GkwwHZUUbFtZOoH1YsZk9Q
  /api/v3/order/cancelReplace:
    post:
      summary: 撤消挂单再下单 (TRADE)
      description: |-
        - 撤消挂单并在同个交易对上重新下单。
        - 在撤消订单和下单前会判断: 1) 过滤器参数, 以及 2) 目前下单数量。
        - 即使请求中没有尝试发送新订单，比如(`newOrderResult: NOT_ATTEMPTED`)，未成交订单的数量仍然会加1。
        - 通过此接口只能撤消订单列表中的单个订单，但结果与撤消整个订单列表相同。
      tags:
        - trade
      operationId: orderCancelReplace
      externalDocs:
        url: https://developers.binance.com/en/docs/catalog/core-trading-spot-trading/api/rest-api/trade#order-cancel-replace
      x-connectors-examples:
        ts: https://raw.githubusercontent.com/binance/binance-connector-js/master/clients/spot/examples/rest-api/TradeApi/orderCancelReplace.ts
        rust: https://raw.githubusercontent.com/binance/binance-connector-rust/main/examples/spot/rest_api/trade_api/order_cancel_replace.rs
        python: https://raw.githubusercontent.com/binance/binance-connector-python/master/clients/spot/examples/rest_api/Trade/order_cancel_replace.py
        java: https://raw.githubusercontent.com/binance/binance-connector-java/master/examples/spot/src/main/java/com/binance/connector/client/spot/rest/trade/OrderCancelReplaceExample.java
        go: https://raw.githubusercontent.com/binance/binance-connector-go/main/clients/spot/examples/restapi/TradeAPI/OrderCancelReplace/OrderCancelReplace.go
        php: https://raw.githubusercontent.com/binance/binance-connector-php/master/examples/spot/trade/OrderCancelReplaceExample.php
      x-ip-weight: 1
      x-order-weight: 1
      x-security-type: TRADE
      x-signed: true
      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
      x-parameters-notes: |-
        **数据源:** 撮合引擎

        如同 `POST /api/v3/order`，额外的强制参数取决于 `type` 。
        响应格式根据消息的处理是成功、部分成功还是失败而有所不同。

        <table>
          <thead>
              <tr>
                  <th colspan=3 align=left>请求</th>
                  <th colspan=3 align=left>响应</th>
              </tr>
              <tr>
                  <th><code>cancelReplaceMode</code></th>
                  <th><code>orderRateLimitExceededMode</code></th>
                  <th>未成交订单数</th>
                  <th><code>cancelResult</code></th>
                  <th><code>newOrderResult</code></th>
                  <th><code>status</code></th>
              </tr>
          </thead>
          <tbody>
              <tr>
                  <td rowspan="11"><code>STOP_ON_FAILURE</code></td>
                  <td rowspan="6"><code>DO_NOTHING</code></td>
                  <td rowspan="3">在限制范围内</td>
                  <td>✅ <code>SUCCESS</code></td>
                  <td>✅ <code>SUCCESS</code></td>
                  <td align=right><code>200</code></td>
              </tr>
              <tr>
                  <td>❌ <code>FAILURE</code></td>
                  <td>➖ <code>NOT_ATTEMPTED</code></td>
                  <td align=right><code>400</code></td>
              </tr>
              <tr>
                  <td>✅ <code>SUCCESS</code></td>
                  <td>❌ <code>FAILURE</code></td>
                  <td align=right><code>409</code></td>
              </tr>
              <tr>
                  <td rowspan="3">超出限制范围</td>
                  <td>✅ <code>SUCCESS</code></td>
                  <td>✅ <code>SUCCESS</code></td>
                  <td align=right>N/A</td>
              </tr>
              <tr>
                  <td>❌ <code>FAILURE</code></td>
                  <td>➖ <code>NOT_ATTEMPTED</code></td>
                  <td align=right>N/A</td>
              </tr>
              <tr>
                  <td>✅ <code>SUCCESS</code></td>
                  <td>❌ <code>FAILURE</code></td>
                  <td align=right>N/A</td>
              </tr>
              <tr>
                  <td rowspan="5"><code>CANCEL_ONLY</code></td>
                  <td rowspan="3">在限制范围内</td>
                  <td>✅ <code>SUCCESS</code></td>
                  <td>✅ <code>SUCCESS</code></td>
                  <td align=right><code>200</code></td>
              </tr>
              <tr>
                  <td>❌ <code>FAILURE</code></td>
                  <td>➖ <code>NOT_ATTEMPTED</code></td>
                  <td align=right><code>400</code></td>
              </tr>
              <tr>
                  <td>✅ <code>SUCCESS</code></td>
                  <td>❌ <code>FAILURE</code></td>
                  <td align=right><code>409</code></td>
              </tr>
              <tr>
                  <td rowspan="2">超出限制范围</td>
                  <td>❌ <code>FAILURE</code></td>
                  <td>➖ <code>NOT_ATTEMPTED</code></td>
                  <td align=right><code>429</code></td>
              </tr>
              <tr>
                  <td>✅ <code>SUCCESS</code></td>
                  <td>❌ <code>FAILURE</code></td>
                  <td align=right><code>429</code></td>
              </tr>
              <tr>
                  <td rowspan="16"><code>ALLOW_FAILURE</code></td>
                  <td rowspan="8"><code>DO_NOTHING</code></td>
                  <td rowspan="4">在限制范围内</td>
                  <td>✅ <code>SUCCESS</code></td>
                  <td>✅ <code>SUCCESS</code></td>
                  <td align=right><code>200</code></td>
              </tr>
              <tr>
                  <td>❌ <code>FAILURE</code></td>
                  <td>❌ <code>FAILURE</code></td>
                  <td align=right><code>400</code></td>
              </tr>
              <tr>
                  <td>❌ <code>FAILURE</code></td>
                  <td>✅ <code>SUCCESS</code></td>
                  <td align=right><code>409</code></td>
              </tr>
              <tr>
                  <td>✅ <code>SUCCESS</code></td>
                  <td>❌ <code>FAILURE</code></td>
                  <td align=right><code>409</code></td>
              </tr>
              <tr>
              <td rowspan="4">超出限制范围</td>
                  <td>✅ <code>SUCCESS</code></td>
                  <td>✅ <code>SUCCESS</code></td>
                  <td align=right>N/A</td>
              </tr>
              <tr>
                  <td>❌ <code>FAILURE</code></td>
                  <td>❌ <code>FAILURE</code></td>
                  <td align=right>N/A</td>
              </tr>
              <tr>
                  <td>❌ <code>FAILURE</code></td>
                  <td>✅ <code>SUCCESS</code></td>
                  <td align=right>N/A</td>
              </tr>
              <tr>
                  <td>✅ <code>SUCCESS</code></td>
                  <td>❌ <code>FAILURE</code></td>
                  <td align=right>N/A</td>
              </tr>
              <tr>
                  <td rowspan="8"><CODE>CANCEL_ONLY</CODE></td>
                  <td rowspan="4">在限制范围内</td>
                  <td>✅ <code>SUCCESS</code></td>
                  <td>✅ <code>SUCCESS</code></td>
                  <td align=right><code>200</code></td>
              </tr>
              <tr>
                  <td>❌ <code>FAILURE</code></td>
                  <td>❌ <code>FAILURE</code></td>
                  <td align=right><code>400</code></td>
              </tr>
              <tr>
                  <td>❌ <code>FAILURE</code></td>
                  <td>✅ <code>SUCCESS</code></td>
                  <td align=right><code>409</code></td>
              </tr>
              <tr>
                  <td>✅ <code>SUCCESS</code></td>
                  <td>❌ <code>FAILURE</code></td>
                  <td align=right><code>409</code></td>
              </tr>
              <tr>
                  <td rowspan="4">超出限制范围</td>
                  <td>✅ <code>SUCCESS</code></td>
                  <td>✅ <code>SUCCESS</code></td>
                  <td align=right><code>N/A</code></td>
              </tr>
              <tr>
                  <td>❌ <code>FAILURE</code></td>
                  <td>❌ <code>FAILURE</code></td>
                  <td align=right><code>400</code></td>
              </tr>
              <tr>
                  <td>❌ <code>FAILURE</code></td>
                  <td>✅ <code>SUCCESS</code></td>
                  <td align=right>N/A</td>
              </tr>
              <tr>
                  <td>✅ <code>SUCCESS</code></td>
                  <td>❌ <code>FAILURE</code></td>
                  <td align=right><code>409</code></td>
              </tr>
          </tbody>
        </table>

        **注意:**
          - 当仅发送 `orderId` 时,取消订单的执行(单个 Cancel 或作为 Cancel-Replace 的一部分)总是更快。发送 `origClientOrderId` 或同时发送 `orderId` + `origClientOrderId` 会稍慢。
      requestBody:
        required: true
        content:
          application/x-www-form-urlencoded:
            schema:
              type: object
              required:
                - symbol
                - side
                - type
                - cancelReplaceMode
                - timestamp
              properties:
                symbol:
                  type: string
                  example: BNBUSDT
                side:
                  type: string
                  enum:
                    - BUY
                    - SELL
                  example: BUY
                type:
                  type: string
                  enum:
                    - MARKET
                    - LIMIT
                    - STOP_LOSS
                    - STOP_LOSS_LIMIT
                    - TAKE_PROFIT
                    - TAKE_PROFIT_LIMIT
                    - LIMIT_MAKER
                  example: MARKET
                cancelReplaceMode:
                  type: string
                  enum:
                    - STOP_ON_FAILURE
                    - ALLOW_FAILURE
                  example: STOP_ON_FAILURE
                  description: 指定类型：`STOP_ON_FAILURE` - 如果撤消订单失败将不会继续重新下单。<br/> `ALLOW_FAILURE` - 不管撤消订单是否成功都会继续重新下单。
                timeInForce:
                  type: string
                  enum:
                    - GTC
                    - IOC
                    - FOK
                  example: GTC
                quantity:
                  type: number
                  format: float
                  example: 1
                quoteOrderQty:
                  type: number
                  format: float
                  example: 1
                price:
                  type: number
                  format: float
                  example: 400
                cancelNewClientOrderId:
                  type: string
                  example: cancelMyOrder1
                  description: 用户自定义的id，如空缺系统会自动赋值
                cancelOrigClientOrderId:
                  type: string
                  example: myOrder1
                  description: 必须提供 `cancelOrderId` 或者 `cancelOrigClientOrderId`。 <br></br> 当同时提供 `cancelOrderId` 和 `cancelOrigClientOrderId` 两个参数时，系统首先将会使用 `cancelOrderId` 来搜索订单。<br></br> 然后， 查找结果中的 `cancelOrigClientOrderId` 的值将会被用来验证订单。<br></br> 如果两个条件都不满足，则请求将被拒绝。
                cancelOrderId:
                  type: integer
                  format: int64
                  example: 1
                  description: 必须提供 `cancelOrderId` 或者 `cancelOrigClientOrderId`。 <br></br> 当同时提供 `cancelOrderId` 和 `cancelOrigClientOrderId` 两个参数时，系统首先将会使用 `cancelOrderId` 来搜索订单。<br></br> 然后， 查找结果中的 `cancelOrigClientOrderId` 的值将会被用来验证订单。<br></br> 如果两个条件都不满足，则请求将被拒绝。
                newClientOrderId:
                  type: string
                  example: myOrder2
                  description: 用于辨识新订单。
                strategyId:
                  type: integer
                  format: int64
                  example: 1
                strategyType:
                  type: integer
                  example: 1
                  description: 不能低于 `1000000`。
                stopPrice:
                  type: number
                  format: float
                  example: 1
                trailingDelta:
                  type: integer
                  format: int64
                  example: 1
                  description: 参考 [追踪止盈止损(Trailing Stop)订单常见问题](/products/spot/faqs/trailing-stop-faq)
                icebergQty:
                  type: number
                  format: float
                  example: 1
                newOrderRespType:
                  type: string
                  enum:
                    - ACK
                    - RESULT
                    - FULL
                  example: ACK
                  description: '指定响应类型: <br/> 指定响应类型 `ACK`, `RESULT`, or `FULL`; `MARKET` 与 `LIMIT` 订单默认为`FULL`， 其他默认为`ACK`。'
                selfTradePreventionMode:
                  type: string
                  enum:
                    - NONE
                    - EXPIRE_TAKER
                    - EXPIRE_MAKER
                    - EXPIRE_BOTH
                    - DECREMENT
                    - TRANSFER
                  example: NONE
                  description: 允许的 ENUM 取决于交易对的配置。支持的值有：[STP 模式](/products/spot/enums#stpmodes)。
                cancelRestrictions:
                  type: string
                  enum:
                    - ONLY_NEW
                    - ONLY_PARTIALLY_FILLED
                  example: ONLY_NEW
                  description: '支持的值: <br>`ONLY_NEW` - 如果订单状态为 `NEW`，撤销将成功。<br> `ONLY_PARTIALLY_FILLED` - 如果订单状态为 `PARTIALLY_FILLED`，撤销将成功。'
                orderRateLimitExceededMode:
                  type: string
                  enum:
                    - DO_NOTHING
                    - CANCEL_ONLY
                  example: DO_NOTHING
                  description: 支持的值： <br></br> `DO_NOTHING`（默认值）- 仅在账户未超过未成交订单频率限制时，会尝试取消订单。<br></br> `CANCEL_ONLY` - 将始终取消订单。
                pegPriceType:
                  type: string
                  enum:
                    - PRIMARY_PEG
                    - MARKET_PEG
                  example: PRIMARY_PEG
                  description: '`PRIMARY_PEG` 或 `MARKET_PEG`。 <br> 参阅 关于挂钩订单参数的注意事项'
                pegOffsetValue:
                  type: integer
                  example: 1
                  description: 用于挂钩的价格水平（最大值：100）。 <br> 参阅 关于挂钩订单参数的注意事项
                pegOffsetType:
                  type: string
                  enum:
                    - PRICE_LEVEL
                  example: PRICE_LEVEL
                  description: 仅支持 `PRICE_LEVEL`。 <br> 参阅 关于挂钩订单参数的注意事项
                recvWindow:
                  type: number
                  format: float
                  example: 5000
                  maximum: 60000
                  description: 最大值为 `60000` 毫秒。 <br> 支持最多三位小数的精度（例如 6000.346），以便可以指定微秒。
                timestamp:
                  type: integer
                  example: 1770736694138
                  format: int64
                  description: 用于请求签名的 Unix 时间戳，单位为毫秒. 该值必须反映客户端当前时间，并会在签名接口中由服务器进行校验.
      responses:
        '200':
          description: 撤单和下单都成功
          content:
            application/json:
              schema:
                type: object
                properties:
                  cancelResult:
                    type: string
                    example: SUCCESS
                  newOrderResult:
                    type: string
                    example: SUCCESS
                  cancelResponse:
                    type: object
                    properties:
                      symbol:
                        type: string
                        example: BTCUSDT
                      origClientOrderId:
                        type: string
                        example: DnLo3vTAQcjha43lAZhZ0y
                      orderId:
                        type: integer
                        format: int64
                        example: 9
                      orderListId:
                        type: integer
                        format: int64
                        example: -1
                        description: 除非此单是订单列表的一部分, 否则此值为 -1
                      clientOrderId:
                        type: string
                        example: osxN3JXAtJvKvCqGeMWMVR
                      transactTime:
                        type: integer
                        format: int64
                        example: 1684804350068
                      price:
                        type: string
                        example: '0.01000000'
                      origQty:
                        type: string
                        example: '0.000100'
                      executedQty:
                        type: string
                        example: '0.00000000'
                      origQuoteOrderQty:
                        type: string
                        example: '0.000000'
                      cummulativeQuoteQty:
                        type: string
                        example: '0.00000000'
                      status:
                        type: string
                        example: CANCELED
                      timeInForce:
                        type: string
                        example: GTC
                      type:
                        type: string
                        example: LIMIT
                      side:
                        type: string
                        example: SELL
                      selfTradePreventionMode:
                        type: string
                        example: NONE
                      icebergQty:
                        type: string
                        example: '0.00000000'
                        description: 仅在请求中发送了 icebergQty 参数时出现。
                      preventedMatchId:
                        type: integer
                        format: int64
                        example: 0
                        description: 仅在因 STP 导致订单失效时出现。
                      preventedQuantity:
                        type: string
                        example: '1.200000'
                        description: 因 STP 导致订单失效的数量。
                      stopPrice:
                        type: string
                        example: '0.00000000'
                        description: 出现在 STOP_LOSS, TAKE_PROFIT, STOP_LOSS_LIMIT 和 TAKE_PROFIT_LIMIT 订单中。
                      strategyId:
                        type: integer
                        format: int64
                        example: 1
                        description: 仅在下单时提供了 strategyId 参数时出现。
                      strategyType:
                        type: integer
                        format: int64
                        example: 1000000
                        description: 仅在下单时提供了 strategyType 参数时出现。
                      trailingDelta:
                        type: integer
                        format: int64
                        example: 10
                        description: 订单激活前所需的价格变动。
                      trailingTime:
                        type: integer
                        format: int64
                        example: -1
                        description: 追踪单被激活和跟踪价格变化的时间。
                      usedSor:
                        type: boolean
                        example: true
                        description: 用于确定订单是否使用SOR的字段。
                      workingFloor:
                        type: string
                        example: SOR
                        description: 用以定义订单是通过 SOR 还是由订单簿成交的。
                      pegPriceType:
                        type: string
                        example: PRIMARY_PEG
                        description: 挂钩价格类型。仅用于挂钩订单。
                      pegOffsetType:
                        type: string
                        example: PRICE_LEVEL
                        description: 挂钩价格偏移类型。如若需要，仅用于挂钩订单。
                      pegOffsetValue:
                        type: integer
                        format: int64
                        example: 5
                        description: 挂钩价格偏移值。如若需要，仅用于挂钩订单。
                      peggedPrice:
                        type: string
                        example: '87523.83710000'
                        description: 订单对应的当前挂钩价格。一旦确定，仅用于挂钩订单。
                      expiryReason:
                        type: string
                        example: INSUFFICIENT_LIQUIDITY
                        description: 订单过期的原因。当订单过期时出现。
                  newOrderResponse:
                    type: object
                    properties:
                      symbol:
                        type: string
                        example: BTCUSDT
                      orderId:
                        type: integer
                        format: int64
                        example: 10
                      orderListId:
                        type: integer
                        format: int64
                        example: -1
                        description: 除非此单是订单列表的一部分, 否则此值为 -1
                      clientOrderId:
                        type: string
                        example: wOceeeOzNORyLiQfw7jd8S
                      transactTime:
                        type: integer
                        format: int64
                        example: 1652928801803
                      price:
                        type: string
                        example: '0.02000000'
                      origQty:
                        type: string
                        example: '0.040000'
                      executedQty:
                        type: string
                        example: '0.00000000'
                      origQuoteOrderQty:
                        type: string
                        example: '0.000000'
                      cummulativeQuoteQty:
                        type: string
                        example: '0.00000000'
                      status:
                        type: string
                        example: NEW
                      timeInForce:
                        type: string
                        example: GTC
                      type:
                        type: string
                        example: LIMIT
                      side:
                        type: string
                        example: BUY
                      workingTime:
                        type: integer
                        format: int64
                        example: 1669277163808
                      fills:
                        type: array
                        items:
                          type: object
                          properties:
                            price:
                              type: string
                              example: '4000.00000000'
                            qty:
                              type: string
                              example: '1.00000000'
                            commission:
                              type: string
                              example: '4.00000000'
                            commissionAsset:
                              type: string
                              example: USDT
                            tradeId:
                              type: integer
                              example: 12345
                              format: int64
                      selfTradePreventionMode:
                        type: string
                        example: NONE
                      icebergQty:
                        type: string
                        example: '0.00000000'
                        description: 仅在请求中发送了 icebergQty 参数时出现。
                      preventedMatchId:
                        type: integer
                        format: int64
                        example: 0
                        description: 仅在因 STP 导致订单失效时出现。
                      preventedQuantity:
                        type: string
                        example: '1.200000'
                        description: 因 STP 导致订单失效的数量。
                      stopPrice:
                        type: string
                        example: '0.00000000'
                        description: 出现在 STOP_LOSS, TAKE_PROFIT, STOP_LOSS_LIMIT 和 TAKE_PROFIT_LIMIT 订单中。
                      strategyId:
                        type: integer
                        format: int64
                        example: 1
                        description: 仅在下单时提供了 strategyId 参数时出现。
                      strategyType:
                        type: integer
                        format: int64
                        example: 1000000
                        description: 仅在下单时提供了 strategyType 参数时出现。
                      trailingDelta:
                        type: integer
                        format: int64
                        example: 10
                        description: 订单激活前所需的价格变动。
                      trailingTime:
                        type: integer
                        format: int64
                        example: -1
                        description: 追踪单被激活和跟踪价格变化的时间。
                      usedSor:
                        type: boolean
                        example: true
                        description: 用于确定订单是否使用SOR的字段。
                      workingFloor:
                        type: string
                        example: SOR
                        description: 用以定义订单是通过 SOR 还是由订单簿成交的。
                      pegPriceType:
                        type: string
                        example: PRIMARY_PEG
                        description: 挂钩价格类型。仅用于挂钩订单。
                      pegOffsetType:
                        type: string
                        example: PRICE_LEVEL
                        description: 挂钩价格偏移类型。如若需要，仅用于挂钩订单。
                      pegOffsetValue:
                        type: integer
                        format: int64
                        example: 5
                        description: 挂钩价格偏移值。如若需要，仅用于挂钩订单。
                      peggedPrice:
                        type: string
                        example: '87523.83710000'
                        description: 订单对应的当前挂钩价格。一旦确定，仅用于挂钩订单。
                      expiryReason:
                        type: string
                        example: INSUFFICIENT_LIQUIDITY
                        description: 订单过期的原因。当订单过期时出现。
  /api/v3/orderList/oco:
    post:
      summary: New 订单 列表 - OCO (TRADE)
      description: |-
        发送新 one-cancels-the-other (OCO) 订单，激活其中一个订单会立即取消另一个订单。

        - OCO 包含了两个订单，分别被称为 **上方订单** 和 **下方订单**。
        - 其中一个订单必须是 `LIMIT_MAKER/TAKE_PROFIT/TAKE_PROFIT_LIMIT` 订单，另一个订单必须是 `STOP_LOSS` 或 `STOP_LOSS_LIMIT` 订单。
        - 针对价格限制：
          - 如果 OCO 订单方向是 `SELL`：
            - `LIMIT_MAKER/TAKE_PROFIT_LIMIT` `price` > 最后交易价格 >  `STOP_LOSS/STOP_LOSS_LIMIT` `stopPrice`
            - `TAKE_PROFIT` `stopPrice` > 最后交易价格 > `STOP_LOSS/STOP_LOSS_LIMIT` `stopPrice`
          - 如果 OCO 订单方向是 `BUY`：
            - `LIMIT_MAKER/TAKE_PROFIT_LIMIT` `price` < 最后交易价格 < `stopPrice`
            - `TAKE_PROFIT` `stopPrice` < 最后交易价格 < `STOP_LOSS/STOP_LOSS_LIMIT` `stopPrice`
        - OCO 会添加 **2个订单** 到 `EXCHANGE_MAX_ORDERS` 过滤器和 `MAX_NUM_ORDERS` 过滤器中。
      tags:
        - trade
      operationId: orderListOco
      externalDocs:
        url: https://developers.binance.com/en/docs/catalog/core-trading-spot-trading/api/rest-api/trade#order-list-oco
      x-connectors-examples:
        ts: https://raw.githubusercontent.com/binance/binance-connector-js/master/clients/spot/examples/rest-api/TradeApi/orderListOco.ts
        rust: https://raw.githubusercontent.com/binance/binance-connector-rust/main/examples/spot/rest_api/trade_api/order_list_oco.rs
        python: https://raw.githubusercontent.com/binance/binance-connector-python/master/clients/spot/examples/rest_api/Trade/order_list_oco.py
        java: https://raw.githubusercontent.com/binance/binance-connector-java/master/examples/spot/src/main/java/com/binance/connector/client/spot/rest/trade/OrderListOcoExample.java
        go: https://raw.githubusercontent.com/binance/binance-connector-go/main/clients/spot/examples/restapi/TradeAPI/OrderListOco/OrderListOco.go
        php: https://raw.githubusercontent.com/binance/binance-connector-php/master/examples/spot/trade/OrderListOcoExample.php
      x-ip-weight: 1
      x-order-weight: 2
      x-security-type: TRADE
      x-signed: true
      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
      x-parameters-notes: '**数据源:** 撮合引擎'
      requestBody:
        required: true
        content:
          application/x-www-form-urlencoded:
            schema:
              type: object
              required:
                - symbol
                - side
                - quantity
                - aboveType
                - belowType
                - timestamp
              properties:
                symbol:
                  type: string
                  example: BNBUSDT
                listClientOrderId:
                  type: string
                  example: lH1YDkuQKWiXVXHPSKYEIp
                  description: 整个 OCO order list 的唯一ID。 如果未发送则自动生成。 仅当前一个订单已填满或完全过期时，才会接受具有相同的`listClientOrderId`。 `listClientOrderId` 与 `aboveClientOrderId` 和 `belowClientOrderId` 不同。
                side:
                  type: string
                  enum:
                    - BUY
                    - SELL
                  example: BUY
                quantity:
                  type: number
                  format: float
                  example: 1
                  description: 两个订单的数量。
                aboveType:
                  type: string
                  enum:
                    - STOP_LOSS_LIMIT
                    - STOP_LOSS
                    - LIMIT_MAKER
                    - TAKE_PROFIT
                    - TAKE_PROFIT_LIMIT
                  example: STOP_LOSS_LIMIT
                aboveClientOrderId:
                  type: string
                  example: aboveOrder1
                  description: 上方订单的唯一ID。 如果未发送则自动生成。
                aboveIcebergQty:
                  type: integer
                  format: int64
                  example: 1
                  description: 请注意，只有当 `aboveTimeInForce` 为 `GTC` 时才能使用。
                abovePrice:
                  type: number
                  format: float
                  example: 1
                  description: 当 `aboveType` 是 `STOP_LOSS_LIMIT`, `LIMIT_MAKER` 或 `TAKE_PROFIT_LIMIT` 时，可用以指定限价。
                aboveStopPrice:
                  type: number
                  format: float
                  example: 1
                  description: 如果 `aboveType` 是 `STOP_LOSS`, `STOP_LOSS_LIMIT`, `TAKE_PROFIT` 或 `TAKE_PROFIT_LIMIT` 才能使用。 必须指定 `aboveStopPrice` 或 `aboveTrailingDelta` 或两者。
                aboveTrailingDelta:
                  type: integer
                  format: int64
                  example: 1
                  description: 请看 [追踪止盈止损(Trailing Stop)订单常见问题](/products/spot/faqs/trailing-stop-faq)
                aboveTimeInForce:
                  type: string
                  enum:
                    - GTC
                    - IOC
                    - FOK
                  example: GTC
                  description: 如果 `aboveType` 是 `STOP_LOSS_LIMIT` 或 `TAKE_PROFIT_LIMIT`，则为必填项。
                aboveStrategyId:
                  type: integer
                  format: int64
                  example: 1
                  description: 订单策略中上方订单的 ID。
                aboveStrategyType:
                  type: integer
                  example: 1
                  description: 上方订单策略的任意数值。小于 `1000000` 的值被保留，无法使用。
                abovePegPriceType:
                  type: string
                  enum:
                    - PRIMARY_PEG
                    - MARKET_PEG
                  example: PRIMARY_PEG
                  description: '`PRIMARY_PEG` 或 `MARKET_PEG`。 参阅 [关于挂钩订单参数的注意事项](/products/spot/faqs/pegged_orders)'
                abovePegOffsetType:
                  type: string
                  enum:
                    - PRICE_LEVEL
                  example: PRICE_LEVEL
                abovePegOffsetValue:
                  type: integer
                  example: 1
                belowType:
                  type: string
                  enum:
                    - STOP_LOSS
                    - STOP_LOSS_LIMIT
                    - TAKE_PROFIT
                    - TAKE_PROFIT_LIMIT
                  example: STOP_LOSS
                  description: 支持值：`STOP_LOSS`, `STOP_LOSS_LIMIT`, `TAKE_PROFIT`, `TAKE_PROFIT_LIMIT`。
                belowClientOrderId:
                  type: string
                  example: belowOrder1
                  description: 下方订单的唯一ID。 如果未发送则自动生成。
                belowIcebergQty:
                  type: integer
                  format: int64
                  example: 1
                  description: 请注意，只有当 `belowTimeInForce` 为 `GTC` 时才能使用。
                belowPrice:
                  type: number
                  format: float
                  example: 1
                  description: 当 `belowType` 是 `STOP_LOSS_LIMIT`, `LIMIT_MAKER` 或 `TAKE_PROFIT_LIMIT` 时，可用以指定限价。
                belowStopPrice:
                  type: number
                  format: float
                  example: 1
                  description: 如果 `belowType` 是 `STOP_LOSS`, `STOP_LOSS_LIMIT`, `TAKE_PROFIT` 或 `TAKE_PROFIT_LIMIT` 才能使用。 必须指定 `belowStopPrice` 或 `belowTrailingDelta` 或两者。
                belowTrailingDelta:
                  type: integer
                  format: int64
                  example: 1
                  description: 请看 [追踪止盈止损(Trailing Stop)订单常见问题](/products/spot/faqs/trailing-stop-faq)
                belowTimeInForce:
                  type: string
                  enum:
                    - GTC
                    - IOC
                    - FOK
                  example: GTC
                  description: 如果 `belowType` 是 `STOP_LOSS_LIMIT` 或 `TAKE_PROFIT_LIMIT`，则为必须配合提交的值。
                belowStrategyId:
                  type: integer
                  format: int64
                  example: 1
                  description: 订单策略中下方订单的 ID。
                belowStrategyType:
                  type: integer
                  example: 1
                  description: 下方订单策略的任意数值。小于 `1000000` 的值被保留，无法使用。
                belowPegPriceType:
                  type: string
                  enum:
                    - PRIMARY_PEG
                    - MARKET_PEG
                  example: PRIMARY_PEG
                  description: 参阅 [关于挂钩订单参数的注意事项](/products/spot/faqs/pegged_orders)
                belowPegOffsetType:
                  type: string
                  enum:
                    - PRICE_LEVEL
                  example: PRICE_LEVEL
                belowPegOffsetValue:
                  type: integer
                  example: 1
                newOrderRespType:
                  type: string
                  enum:
                    - ACK
                    - RESULT
                    - FULL
                  example: ACK
                  description: '响应格式可选值: `ACK`, `RESULT`, `FULL`。'
                selfTradePreventionMode:
                  type: string
                  enum:
                    - NONE
                    - EXPIRE_TAKER
                    - EXPIRE_MAKER
                    - EXPIRE_BOTH
                    - DECREMENT
                    - TRANSFER
                  example: NONE
                  description: 允许的 ENUM 取决于交易对上的配置。 支持值：[STP 模式](/products/spot/enums#stpmodes)
                recvWindow:
                  type: number
                  format: float
                  example: 5000
                  description: 最大值为 `60000` 毫秒。 支持最多三位小数的精度（例如 6000.346），以便可以指定微秒。
                timestamp:
                  type: integer
                  example: 1770736694138
                  format: int64
                  description: 用于请求签名的 Unix 时间戳，单位为毫秒. 该值必须反映客户端当前时间，并会在签名接口中由服务器进行校验.
      responses:
        '200':
          description: New 订单 列表 - OCO
          content:
            application/json:
              schema:
                type: object
                properties:
                  orderListId:
                    type: integer
                    format: int64
                    example: 1
                  contingencyType:
                    type: string
                    example: OCO
                  listStatusType:
                    type: string
                    example: EXEC_STARTED
                  listOrderStatus:
                    type: string
                    example: EXECUTING
                  listClientOrderId:
                    type: string
                    example: lH1YDkuQKWiXVXHPSKYEIp
                  transactionTime:
                    type: integer
                    format: int64
                    example: 1710485608839
                  symbol:
                    type: string
                    example: LTCBTC
                  orders:
                    type: array
                    items:
                      type: object
                      properties:
                        symbol:
                          type: string
                          example: LTCBTC
                        orderId:
                          type: integer
                          format: int64
                          example: 10
                        clientOrderId:
                          type: string
                          example: 44nZvqpemY7sVYgPYbvPih
                  orderReports:
                    type: array
                    items:
                      type: object
                      properties:
                        symbol:
                          type: string
                          example: LTCBTC
                        orderId:
                          type: integer
                          format: int64
                          example: 10
                        orderListId:
                          type: integer
                          format: int64
                          example: 1
                        clientOrderId:
                          type: string
                          example: 44nZvqpemY7sVYgPYbvPih
                        transactTime:
                          type: integer
                          format: int64
                          example: 1710485608839
                        price:
                          type: string
                          example: '1.00000000'
                        origQty:
                          type: string
                          example: '5.00000000'
                        executedQty:
                          type: string
                          example: '0.00000000'
                        origQuoteOrderQty:
                          type: string
                          example: '0.000000'
                        cummulativeQuoteQty:
                          type: string
                          example: '0.00000000'
                        status:
                          type: string
                          example: NEW
                        timeInForce:
                          type: string
                          example: GTC
                        type:
                          type: string
                          example: STOP_LOSS_LIMIT
                        side:
                          type: string
                          example: SELL
                        workingTime:
                          type: integer
                          format: int64
                          example: -1
                        selfTradePreventionMode:
                          type: string
                          example: NONE
                        stopPrice:
                          type: string
                          example: '1.00000000'
                        icebergQty:
                          type: string
                          example: '1.00000000'
  /api/v3/orderList/opo:
    post:
      summary: New 订单 列表- OPO (TRADE)
      description: |-
        发送一个新的 [OPO](/products/spot/faqs/opo) 订单。

        - OPO 会向 `EXCHANGE_MAX_NUM_ORDERS` 过滤器和 `MAX_NUM_ORDERS` 过滤器中添加 2 个订单。
      tags:
        - trade
      operationId: orderListOpo
      externalDocs:
        url: https://developers.binance.com/en/docs/catalog/core-trading-spot-trading/api/rest-api/trade#order-list-opo
      x-connectors-examples:
        ts: https://raw.githubusercontent.com/binance/binance-connector-js/master/clients/spot/examples/rest-api/TradeApi/orderListOpo.ts
        rust: https://raw.githubusercontent.com/binance/binance-connector-rust/main/examples/spot/rest_api/trade_api/order_list_opo.rs
        python: https://raw.githubusercontent.com/binance/binance-connector-python/master/clients/spot/examples/rest_api/Trade/order_list_opo.py
        java: https://raw.githubusercontent.com/binance/binance-connector-java/master/examples/spot/src/main/java/com/binance/connector/client/spot/rest/trade/OrderListOpoExample.java
        go: https://raw.githubusercontent.com/binance/binance-connector-go/main/clients/spot/examples/restapi/TradeAPI/OrderListOpo/OrderListOpo.go
        php: https://raw.githubusercontent.com/binance/binance-connector-php/master/examples/spot/trade/OrderListOpoExample.php
      x-ip-weight: 1
      x-order-weight: 2
      x-security-type: TRADE
      x-signed: true
      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
      x-parameters-notes: '**数据源:** 撮合引擎'
      requestBody:
        required: true
        content:
          application/x-www-form-urlencoded:
            schema:
              type: object
              required:
                - symbol
                - workingType
                - workingSide
                - workingPrice
                - workingQuantity
                - pendingType
                - pendingSide
                - timestamp
              properties:
                symbol:
                  type: string
                  example: BNBUSDT
                listClientOrderId:
                  type: string
                  example: H94qCqO27P74OEiO4X8HOG
                  description: 订单列表中的唯一 ID。如果未发送，则自动生成。只有当之前的同一 `listClientOrderId` 的订单列表已成交或完全过期后，才接受新的同一 `listClientOrderId` 的订单列表。`listClientOrderId` 与 `workingClientOrderId` 和 `pendingClientOrderId` 不同。
                newOrderRespType:
                  type: string
                  enum:
                    - ACK
                    - RESULT
                    - FULL
                  example: ACK
                  description: JSON 响应格式。支持的数值：[订单返回类型](/products/spot/enums#orderresponsetype)
                selfTradePreventionMode:
                  type: string
                  enum:
                    - NONE
                    - EXPIRE_TAKER
                    - EXPIRE_MAKER
                    - EXPIRE_BOTH
                    - DECREMENT
                    - TRANSFER
                  example: NONE
                  description: 允许的数值取决于交易对的配置。支持的数值：[STP模式](/products/spot/enums#stpmodes)
                workingType:
                  type: string
                  enum:
                    - LIMIT
                    - LIMIT_MAKER
                  example: LIMIT
                  description: 支持的数值：`LIMIT`，`LIMIT_MAKER`
                workingSide:
                  type: string
                  enum:
                    - BUY
                    - SELL
                  example: BUY
                  description: 支持的数值：[订单方向](/products/spot/enums#side)
                workingClientOrderId:
                  type: string
                  example: workingOrder1
                  description: 生效订单中挂单的任意唯一 ID。如果未发送，则自动生成。
                workingPrice:
                  type: number
                  format: float
                  example: 1
                  description: 生效订单价格
                workingQuantity:
                  type: number
                  format: float
                  example: 1
                  description: 设置生效订单的数量
                workingIcebergQty:
                  type: number
                  format: float
                  example: 1
                  description: 仅当 `workingTimeInForce` 为 `GTC` 或 `workingType` 为 `LIMIT_MAKER` 时可用
                workingTimeInForce:
                  type: string
                  enum:
                    - GTC
                    - IOC
                    - FOK
                  example: GTC
                  description: 支持的数值：[生效时间](/products/spot/enums#timeinforce)
                workingStrategyId:
                  type: integer
                  format: int64
                  example: 1
                  description: 用于标识订单策略中生效订单的任意数字值
                workingStrategyType:
                  type: integer
                  example: 1
                  description: 用于标识生效订单策略的任意数字值。小于 `1000000` 的值为保留值，不能使用。
                workingPegPriceType:
                  type: string
                  enum:
                    - PRIMARY_PEG
                    - MARKET_PEG
                  example: PRIMARY_PEG
                  description: 参阅 [关于挂钩订单参数的注意事项](/products/spot/faqs/pegged_orders)
                workingPegOffsetType:
                  type: string
                  enum:
                    - PRICE_LEVEL
                  example: PRICE_LEVEL
                workingPegOffsetValue:
                  type: integer
                  example: 1
                pendingType:
                  type: string
                  enum:
                    - LIMIT
                    - MARKET
                    - STOP_LOSS
                    - STOP_LOSS_LIMIT
                    - TAKE_PROFIT
                    - TAKE_PROFIT_LIMIT
                    - LIMIT_MAKER
                  example: LIMIT
                  description: 支持的数值：[订单类型](/products/spot/enums#ordertypes)。注意，不支持使用 `quoteOrderQty` 的 `MARKET` 订单。
                pendingSide:
                  type: string
                  enum:
                    - BUY
                    - SELL
                  example: BUY
                  description: 支持的数值：[订单方向](/products/spot/enums#side)
                pendingClientOrderId:
                  type: string
                  example: pendingOrder1
                  description: 待处理订单中挂单的任意唯一 ID。如果未发送，则自动生成。
                pendingPrice:
                  type: number
                  format: float
                  example: 1
                  description: 待处理订单价格
                pendingStopPrice:
                  type: number
                  format: float
                  example: 1
                  description: 待处理订单止损价格
                pendingTrailingDelta:
                  type: number
                  format: float
                  example: 1
                  description: 待处理订单跟踪止损差值
                pendingIcebergQty:
                  type: number
                  format: float
                  example: 1
                  description: 仅当 `pendingTimeInForce` 为 `GTC` 或 `pendingType` 为 `LIMIT_MAKER` 时可用
                pendingTimeInForce:
                  type: string
                  enum:
                    - GTC
                    - IOC
                    - FOK
                  example: GTC
                  description: 支持的数值：[生效时间](/products/spot/enums#timeinforce)
                pendingStrategyId:
                  type: integer
                  format: int64
                  example: 1
                  description: 用于标识订单策略中待处理订单的任意数字值
                pendingStrategyType:
                  type: integer
                  example: 1
                  description: 用于标识待处理订单策略的任意数字值。小于 `1000000` 的值为保留值，不能使用。
                pendingPegPriceType:
                  type: string
                  enum:
                    - PRIMARY_PEG
                    - MARKET_PEG
                  example: PRIMARY_PEG
                  description: 参阅 [关于挂钩订单参数的注意事项](/products/spot/faqs/pegged_orders)
                pendingPegOffsetType:
                  type: string
                  enum:
                    - PRICE_LEVEL
                  example: PRICE_LEVEL
                pendingPegOffsetValue:
                  type: integer
                  example: 1
                recvWindow:
                  type: number
                  format: float
                  example: 5000
                  maximum: 60000
                  description: 该值不能大于 `60000`。支持最多三位小数精度（例如 6000.346），以便指定微秒。
                timestamp:
                  type: integer
                  example: 1770736694138
                  format: int64
                  description: 用于请求签名的 Unix 时间戳，单位为毫秒. 该值必须反映客户端当前时间，并会在签名接口中由服务器进行校验.
      responses:
        '200':
          description: New 订单 列表- OPO
          content:
            application/json:
              schema:
                type: object
                properties:
                  orderListId:
                    type: integer
                    format: int64
                    example: 0
                  contingencyType:
                    type: string
                    example: OTO
                  listStatusType:
                    type: string
                    example: EXEC_STARTED
                  listOrderStatus:
                    type: string
                    example: EXECUTING
                  listClientOrderId:
                    type: string
                    example: H94qCqO27P74OEiO4X8HOG
                  transactionTime:
                    type: integer
                    format: int64
                    example: 1762998011671
                  symbol:
                    type: string
                    example: BTCUSDT
                  orders:
                    type: array
                    items:
                      type: object
                      properties:
                        symbol:
                          type: string
                          example: BTCUSDT
                        orderId:
                          type: integer
                          format: int64
                          example: 2
                        clientOrderId:
                          type: string
                          example: JX6xfdjo0wysiGumfHNmPu
                  orderReports:
                    type: array
                    items:
                      type: object
                      properties:
                        symbol:
                          type: string
                          example: BTCUSDT
                        orderId:
                          type: integer
                          format: int64
                          example: 2
                        orderListId:
                          type: integer
                          format: int64
                          example: 0
                        clientOrderId:
                          type: string
                          example: JX6xfdjo0wysiGumfHNmPu
                        transactTime:
                          type: integer
                          format: int64
                          example: 1762998011671
                        price:
                          type: string
                          example: '102264.00000000'
                        executedQty:
                          type: string
                          example: '0.00000000'
                        origQuoteOrderQty:
                          type: string
                          example: '0.00000000'
                        cummulativeQuoteQty:
                          type: string
                          example: '0.00000000'
                        status:
                          type: string
                          example: NEW
                        timeInForce:
                          type: string
                          example: GTC
                        type:
                          type: string
                          example: LIMIT
                        side:
                          type: string
                          example: BUY
                        workingTime:
                          type: integer
                          format: int64
                          example: 1762998011671
                        selfTradePreventionMode:
                          type: string
                          example: NONE
                        origQty:
                          type: string
                          example: '0.00060000'
                        icebergQty:
                          type: string
                          example: '0.00000000'
                          description: 仅在请求中发送了 icebergQty 参数时出现。
                        preventedMatchId:
                          type: integer
                          format: int64
                          example: 0
                          description: 仅在因 STP 导致订单失效时出现。
                        preventedQuantity:
                          type: string
                          example: '1.200000'
                          description: 因 STP 导致订单失效的数量。
                        stopPrice:
                          type: string
                          example: '0.00000000'
                          description: 出现在 STOP_LOSS, TAKE_PROFIT, STOP_LOSS_LIMIT 和 TAKE_PROFIT_LIMIT 订单中。
                        strategyId:
                          type: integer
                          format: int64
                          example: 1
                          description: 仅在下单时提供了 strategyId 参数时出现。
                        strategyType:
                          type: integer
                          format: int64
                          example: 1000000
                          description: 仅在下单时提供了 strategyType 参数时出现。
                        trailingDelta:
                          type: integer
                          format: int64
                          example: 10
                          description: 订单激活前所需的价格变动。
                        trailingTime:
                          type: integer
                          format: int64
                          example: -1
                          description: 追踪单被激活和跟踪价格变化的时间。
                        usedSor:
                          type: boolean
                          example: true
                          description: 用于确定订单是否使用SOR的字段。
                        workingFloor:
                          type: string
                          example: SOR
                          description: 用以定义订单是通过 SOR 还是由订单簿成交的。
                        pegPriceType:
                          type: string
                          example: PRIMARY_PEG
                          description: 挂钩价格类型。仅用于挂钩订单。
                        pegOffsetType:
                          type: string
                          example: PRICE_LEVEL
                          description: 挂钩价格偏移类型。如若需要，仅用于挂钩订单。
                        pegOffsetValue:
                          type: integer
                          format: int64
                          example: 5
                          description: 挂钩价格偏移值。如若需要，仅用于挂钩订单。
                        peggedPrice:
                          type: string
                          example: '87523.83710000'
                          description: 订单对应的当前挂钩价格。一旦确定，仅用于挂钩订单。
                        expiryReason:
                          type: string
                          example: INSUFFICIENT_LIQUIDITY
                          description: 订单过期的原因。当订单过期时出现。
  /api/v3/orderList/opoco:
    post:
      summary: New 订单 列表- OPOCO (TRADE)
      description: 发送一个 [OPOCO](/products/spot/faqs/opo) 订单。
      tags:
        - trade
      operationId: orderListOpoco
      externalDocs:
        url: https://developers.binance.com/en/docs/catalog/core-trading-spot-trading/api/rest-api/trade#order-list-opoco
      x-connectors-examples:
        ts: https://raw.githubusercontent.com/binance/binance-connector-js/master/clients/spot/examples/rest-api/TradeApi/orderListOpoco.ts
        rust: https://raw.githubusercontent.com/binance/binance-connector-rust/main/examples/spot/rest_api/trade_api/order_list_opoco.rs
        python: https://raw.githubusercontent.com/binance/binance-connector-python/master/clients/spot/examples/rest_api/Trade/order_list_opoco.py
        java: https://raw.githubusercontent.com/binance/binance-connector-java/master/examples/spot/src/main/java/com/binance/connector/client/spot/rest/trade/OrderListOpocoExample.java
        go: https://raw.githubusercontent.com/binance/binance-connector-go/main/clients/spot/examples/restapi/TradeAPI/OrderListOpoco/OrderListOpoco.go
        php: https://raw.githubusercontent.com/binance/binance-connector-php/master/examples/spot/trade/OrderListOpocoExample.php
      x-ip-weight: 1
      x-order-weight: 3
      x-security-type: TRADE
      x-signed: true
      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
      x-parameters-notes: '**数据源:** 撮合引擎'
      requestBody:
        required: true
        content:
          application/x-www-form-urlencoded:
            schema:
              type: object
              required:
                - symbol
                - workingType
                - workingSide
                - workingPrice
                - workingQuantity
                - pendingSide
                - pendingAboveType
                - timestamp
              properties:
                symbol:
                  type: string
                  example: BNBUSDT
                listClientOrderId:
                  type: string
                  example: bcedxMpQG6nFrZUPQyshoL
                  description: 订单列表中的唯一 ID。如果未发送，则自动生成。只有当之前的同一 `listClientOrderId` 的订单列表已成交或完全过期后，才接受新的同一 `listClientOrderId` 的订单列表。`listClientOrderId` 与 `workingClientOrderId` 和 `pendingClientOrderId` 不同。
                newOrderRespType:
                  type: string
                  enum:
                    - ACK
                    - RESULT
                    - FULL
                  example: ACK
                  description: JSON 响应格式。支持的数值：[订单返回类型](/products/spot/enums#orderresponsetype)
                selfTradePreventionMode:
                  type: string
                  enum:
                    - NONE
                    - EXPIRE_TAKER
                    - EXPIRE_MAKER
                    - EXPIRE_BOTH
                    - DECREMENT
                    - TRANSFER
                  example: NONE
                  description: 允许的数值取决于交易对的配置。支持的数值：[STP模式](/products/spot/enums#stpmodes)
                workingType:
                  type: string
                  enum:
                    - LIMIT
                    - LIMIT_MAKER
                  example: LIMIT
                workingSide:
                  type: string
                  enum:
                    - BUY
                    - SELL
                  example: BUY
                  description: 支持的数值：[订单方向](/products/spot/enums#side)
                workingClientOrderId:
                  type: string
                  example: workingOrder1
                  description: 生效订单中挂单的任意唯一 ID。如果未发送，则自动生成。
                workingPrice:
                  type: number
                  format: float
                  example: 1
                  description: 生效订单价格
                workingQuantity:
                  type: number
                  format: float
                  example: 1
                  description: 设置生效订单的数量
                workingIcebergQty:
                  type: number
                  format: float
                  example: 1
                  description: 仅当 `workingTimeInForce` 为 `GTC` 或 `workingType` 为 `LIMIT_MAKER` 时可用
                workingTimeInForce:
                  type: string
                  enum:
                    - GTC
                    - IOC
                    - FOK
                  example: GTC
                  description: 支持的数值：[生效时间](/products/spot/enums#timeinforce)
                workingStrategyId:
                  type: integer
                  format: int64
                  example: 1
                  description: 用于标识订单策略中生效订单的任意数字值
                workingStrategyType:
                  type: integer
                  example: 1
                  description: 用于标识生效订单策略的任意数字值。小于 `1000000` 的值为保留值，不能使用。
                workingPegPriceType:
                  type: string
                  enum:
                    - PRIMARY_PEG
                    - MARKET_PEG
                  example: PRIMARY_PEG
                  description: 参阅 [关于挂钩订单参数的注意事项](/products/spot/faqs/pegged_orders)
                workingPegOffsetType:
                  type: string
                  enum:
                    - PRICE_LEVEL
                  example: PRICE_LEVEL
                  description: 参阅 [关于挂钩订单参数的注意事项](/products/spot/faqs/pegged_orders)
                workingPegOffsetValue:
                  type: integer
                  example: 1
                  description: 用于挂钩的价格水平（最大值：100）。 参阅 [关于挂钩订单参数的注意事项](/products/spot/faqs/pegged_orders)
                pendingSide:
                  type: string
                  enum:
                    - BUY
                    - SELL
                  example: BUY
                  description: 支持的数值：[订单方向](/products/spot/enums#side)
                pendingAboveType:
                  type: string
                  enum:
                    - STOP_LOSS_LIMIT
                    - STOP_LOSS
                    - LIMIT_MAKER
                    - TAKE_PROFIT
                    - TAKE_PROFIT_LIMIT
                  example: STOP_LOSS_LIMIT
                  description: 支持的数值：`STOP_LOSS_LIMIT`，`STOP_LOSS`，`LIMIT_MAKER`，`TAKE_PROFIT`，`TAKE_PROFIT_LIMIT`
                pendingAboveClientOrderId:
                  type: string
                  example: pendingAboveOrder1
                  description: 待处理"上方"订单中开放订单的任意唯一 ID。如果未发送，则自动生成。
                pendingAbovePrice:
                  type: number
                  format: float
                  example: 1
                  description: 当 `pendingAboveType` 为 `STOP_LOSS_LIMIT`、`LIMIT_MAKER` 或 `TAKE_PROFIT_LIMIT` 时，可用于指定限价。
                pendingAboveStopPrice:
                  type: number
                  format: float
                  example: 1
                  description: 当 `pendingAboveType` 为 `STOP_LOSS`、`STOP_LOSS_LIMIT`、`TAKE_PROFIT`、`TAKE_PROFIT_LIMIT` 时可用。
                pendingAboveTrailingDelta:
                  type: number
                  format: float
                  example: 1
                  description: 详见 [追踪止盈止损常见问题](/products/spot/faqs/trailing-stop-faq)
                pendingAboveIcebergQty:
                  type: number
                  format: float
                  example: 1
                  description: 仅当 `pendingAboveTimeInForce` 为 `GTC` 或 `pendingAboveType` 为 `LIMIT_MAKER` 时可用。
                pendingAboveTimeInForce:
                  type: string
                  enum:
                    - GTC
                    - IOC
                    - FOK
                  example: GTC
                  description: 如果 `pendingAboveType` 是 `STOP_LOSS_LIMIT` 或 `TAKE_PROFIT_LIMIT`，则为必填项。
                pendingAboveStrategyId:
                  type: integer
                  format: int64
                  example: 1
                  description: 用于标识订单策略中待处理上方订单的任意数字值。
                pendingAboveStrategyType:
                  type: integer
                  example: 1
                  description: 用于标识待处理上方订单策略的任意数字值。小于 `1000000` 的值为保留值，不能使用。
                pendingAbovePegPriceType:
                  type: string
                  enum:
                    - PRIMARY_PEG
                    - MARKET_PEG
                  example: PRIMARY_PEG
                  description: 参阅 [关于挂钩订单参数的注意事项](/products/spot/faqs/pegged_orders)
                pendingAbovePegOffsetType:
                  type: string
                  enum:
                    - PRICE_LEVEL
                  example: PRICE_LEVEL
                  description: 参阅 [关于挂钩订单参数的注意事项](/products/spot/faqs/pegged_orders)
                pendingAbovePegOffsetValue:
                  type: integer
                  example: 1
                  description: 用于挂钩的价格水平（最大值：100）。 参阅 [关于挂钩订单参数的注意事项](/products/spot/faqs/pegged_orders)
                pendingBelowType:
                  type: string
                  enum:
                    - STOP_LOSS
                    - STOP_LOSS_LIMIT
                    - TAKE_PROFIT
                    - TAKE_PROFIT_LIMIT
                  example: STOP_LOSS
                  description: 支持的数值：`STOP_LOSS`，`STOP_LOSS_LIMIT`，`TAKE_PROFIT`，`TAKE_PROFIT_LIMIT`
                pendingBelowClientOrderId:
                  type: string
                  example: pendingBelowOrder1
                  description: 待处理"下方"订单中开放订单的任意唯一 ID。如果未发送，则自动生成。
                pendingBelowPrice:
                  type: number
                  format: float
                  example: 1
                  description: 当 `pendingBelowType` 为 `STOP_LOSS_LIMIT` 或 `TAKE_PROFIT_LIMIT` 时，可用于指定限价。
                pendingBelowStopPrice:
                  type: number
                  format: float
                  example: 1
                  description: 当 `pendingBelowType` 为 `STOP_LOSS`、`STOP_LOSS_LIMIT`、`TAKE_PROFIT` 或 `TAKE_PROFIT_LIMIT` 时可用。`pendingBelowStopPrice`、`pendingBelowTrailingDelta` 或两者之一必须被指定。
                pendingBelowTrailingDelta:
                  type: number
                  format: float
                  example: 1
                  description: 详见 [追踪止盈止损常见问题](/products/spot/faqs/trailing-stop-faq)
                pendingBelowIcebergQty:
                  type: number
                  format: float
                  example: 1
                  description: 仅当 `pendingBelowTimeInForce` 为 `GTC` 或 `pendingBelowType` 为 `LIMIT_MAKER` 时可用。
                pendingBelowTimeInForce:
                  type: string
                  enum:
                    - GTC
                    - IOC
                    - FOK
                  example: GTC
                  description: 支持的数值：[生效时间](/products/spot/enums#timeinforce)
                pendingBelowStrategyId:
                  type: integer
                  format: int64
                  example: 1
                  description: 用于标识订单策略中待处理下方订单的任意数字值。
                pendingBelowStrategyType:
                  type: integer
                  example: 1
                  description: 用于标识待处理下方订单策略的任意数字值。小于 `1000000` 为保留值，不能使用。
                pendingBelowPegPriceType:
                  type: string
                  enum:
                    - PRIMARY_PEG
                    - MARKET_PEG
                  example: PRIMARY_PEG
                  description: 参阅 [关于挂钩订单参数的注意事项](/products/spot/faqs/pegged_orders)
                pendingBelowPegOffsetType:
                  type: string
                  enum:
                    - PRICE_LEVEL
                  example: PRICE_LEVEL
                pendingBelowPegOffsetValue:
                  type: integer
                  example: 1
                recvWindow:
                  type: number
                  format: float
                  example: 5000
                  description: 该值不能大于 `60000`。支持最多三位小数精度（例如 6000.346），以便指定微秒。
                timestamp:
                  type: integer
                  example: 1770736694138
                  format: int64
                  description: 用于请求签名的 Unix 时间戳，单位为毫秒. 该值必须反映客户端当前时间，并会在签名接口中由服务器进行校验.
      responses:
        '200':
          description: New 订单 列表- OPOCO
          content:
            application/json:
              schema:
                type: object
                properties:
                  orderListId:
                    type: integer
                    format: int64
                    example: 2
                  contingencyType:
                    type: string
                    example: OTO
                  listStatusType:
                    type: string
                    example: EXEC_STARTED
                  listOrderStatus:
                    type: string
                    example: EXECUTING
                  listClientOrderId:
                    type: string
                    example: bcedxMpQG6nFrZUPQyshoL
                  transactionTime:
                    type: integer
                    format: int64
                    example: 1763000506354
                  symbol:
                    type: string
                    example: BTCUSDT
                  orders:
                    type: array
                    items:
                      type: object
                      properties:
                        symbol:
                          type: string
                          example: BTCUSDT
                        orderId:
                          type: integer
                          format: int64
                          example: 9
                        clientOrderId:
                          type: string
                          example: OLSBhMWaIlLSzZ9Zm7fnKB
                  orderReports:
                    type: array
                    items:
                      type: object
                      properties:
                        symbol:
                          type: string
                          example: BTCUSDT
                        orderId:
                          type: integer
                          format: int64
                          example: 9
                        orderListId:
                          type: integer
                          format: int64
                          example: 2
                        clientOrderId:
                          type: string
                          example: OLSBhMWaIlLSzZ9Zm7fnKB
                        transactTime:
                          type: integer
                          format: int64
                          example: 1763000506354
                        price:
                          type: string
                          example: '102496.00000000'
                        executedQty:
                          type: string
                          example: '0.00000000'
                        origQuoteOrderQty:
                          type: string
                          example: '0.00000000'
                        cummulativeQuoteQty:
                          type: string
                          example: '0.00000000'
                        status:
                          type: string
                          example: NEW
                        timeInForce:
                          type: string
                          example: GTC
                        type:
                          type: string
                          example: LIMIT
                        side:
                          type: string
                          example: BUY
                        workingTime:
                          type: integer
                          format: int64
                          example: 1763000506354
                        selfTradePreventionMode:
                          type: string
                          example: NONE
                        origQty:
                          type: string
                          example: '0.00170000'
                        icebergQty:
                          type: string
                          example: '0.00000000'
                          description: 仅在请求中发送了 icebergQty 参数时出现。
                        preventedMatchId:
                          type: integer
                          format: int64
                          example: 0
                          description: 仅在因 STP 导致订单失效时出现。
                        preventedQuantity:
                          type: string
                          example: '1.200000'
                          description: 因 STP 导致订单失效的数量。
                        stopPrice:
                          type: string
                          example: '0.00000000'
                          description: 出现在 STOP_LOSS, TAKE_PROFIT, STOP_LOSS_LIMIT 和 TAKE_PROFIT_LIMIT 订单中。
                        strategyId:
                          type: integer
                          format: int64
                          example: 1
                          description: 仅在下单时提供了 strategyId 参数时出现。
                        strategyType:
                          type: integer
                          format: int64
                          example: 1000000
                          description: 仅在下单时提供了 strategyType 参数时出现。
                        trailingDelta:
                          type: integer
                          format: int64
                          example: 10
                          description: 订单激活前所需的价格变动。
                        trailingTime:
                          type: integer
                          format: int64
                          example: -1
                          description: 追踪单被激活和跟踪价格变化的时间。
                        usedSor:
                          type: boolean
                          example: true
                          description: 用于确定订单是否使用SOR的字段。
                        workingFloor:
                          type: string
                          example: SOR
                          description: 用以定义订单是通过 SOR 还是由订单簿成交的。
                        pegPriceType:
                          type: string
                          example: PRIMARY_PEG
                          description: 挂钩价格类型。仅用于挂钩订单。
                        pegOffsetType:
                          type: string
                          example: PRICE_LEVEL
                          description: 挂钩价格偏移类型。如若需要，仅用于挂钩订单。
                        pegOffsetValue:
                          type: integer
                          format: int64
                          example: 5
                          description: 挂钩价格偏移值。如若需要，仅用于挂钩订单。
                        peggedPrice:
                          type: string
                          example: '87523.83710000'
                          description: 订单对应的当前挂钩价格。一旦确定，仅用于挂钩订单。
                        expiryReason:
                          type: string
                          example: INSUFFICIENT_LIQUIDITY
                          description: 订单过期的原因。当订单过期时出现。
  /api/v3/orderList/oto:
    post:
      summary: New 订单 列表- OTO (TRADE)
      description: |-
        发送一个新的 OTO 订单。

        - 一个 OTO 订单（One-Triggers-the-Other）是一个包含了两个订单的订单列表.
        - 第一个订单被称为**生效订单**，必须为 `LIMIT` 或 `LIMIT_MAKER` 类型的订单。最初，订单簿上只有生效订单。
        - 第二个订单被称为**待处理订单**。它可以是任何订单类型，但不包括使用参数 `quoteOrderQty` 的 `MARKET` 订单。只有当生效订单**完全成交**时，待处理订单才会被自动下单。
        - 如果生效订单或者待处理订单中的任意一个被单独取消，订单列表中剩余的那个订单也会被随之取消或过期。
        - 如果生效订单在下订单列表后**立即完全成交**，则可能会得到订单响应。其中，生效订单的状态为 `FILLED` ，但待处理订单的状态为 `PENDING_NEW`。针对这类情况，如果需要检查当前状态，您可以查询相关的待处理订单。
        - `OTO` 订单将**2 个订单**添加到 `EXCHANGE_MAX_NUM_ORDERS` 过滤器和 `MAX_NUM_ORDERS` 过滤器中。
      tags:
        - trade
      operationId: orderListOto
      externalDocs:
        url: https://developers.binance.com/en/docs/catalog/core-trading-spot-trading/api/rest-api/trade#order-list-oto
      x-connectors-examples:
        ts: https://raw.githubusercontent.com/binance/binance-connector-js/master/clients/spot/examples/rest-api/TradeApi/orderListOto.ts
        rust: https://raw.githubusercontent.com/binance/binance-connector-rust/main/examples/spot/rest_api/trade_api/order_list_oto.rs
        python: https://raw.githubusercontent.com/binance/binance-connector-python/master/clients/spot/examples/rest_api/Trade/order_list_oto.py
        java: https://raw.githubusercontent.com/binance/binance-connector-java/master/examples/spot/src/main/java/com/binance/connector/client/spot/rest/trade/OrderListOtoExample.java
        go: https://raw.githubusercontent.com/binance/binance-connector-go/main/clients/spot/examples/restapi/TradeAPI/OrderListOto/OrderListOto.go
        php: https://raw.githubusercontent.com/binance/binance-connector-php/master/examples/spot/trade/OrderListOtoExample.php
      x-ip-weight: 1
      x-order-weight: 2
      x-security-type: TRADE
      x-signed: true
      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
      x-parameters-notes: |-
        **数据源:** 撮合引擎

        **根据 `pendingType` 或者 `workingType` 的不同值，对于某些参数的强制要求**

        根据 `pendingType` 或者`workingType`的不同值，对于某些可选参数有强制要求，具体如下：

        |类型                                                   | 强制要求的参数                  | 其他信息|
        |----                                                  |----                           |------
        |`workingType` = `LIMIT`                               |`workingTimeInForce`           |
        |`pendingType` = `LIMIT`                                |`pendingPrice`， `pendingTimeInForce`          |
        |`pendingType` = `STOP_LOSS` 或 `TAKE_PROFIT`           |`pendingStopPrice` 与/或 `pendingTrailingDelta`|
        |`pendingType` = `STOP_LOSS_LIMIT` 或 `TAKE_PROFIT_LIMIT`|`pendingPrice`， `pendingStopPrice` 与/或 `pendingTrailingDelta`， `pendingTimeInForce`|
      requestBody:
        required: true
        content:
          application/x-www-form-urlencoded:
            schema:
              type: object
              required:
                - symbol
                - workingType
                - workingSide
                - workingPrice
                - workingQuantity
                - pendingType
                - pendingSide
                - pendingQuantity
                - timestamp
              properties:
                symbol:
                  type: string
                  example: BNBUSDT
                listClientOrderId:
                  type: string
                  example: yl2ERtcar1o25zcWtqVBTC
                  description: 整个订单列表的唯一ID。 如果未发送则自动生成。 仅当前一个订单列表已填满或完全过期时，才会接受含有相同 `listClientOrderId` 值的新订单列表。 `listClientOrderId` 与 `workingClientOrderId` 和 `pendingClientOrderId` 不同。
                newOrderRespType:
                  type: string
                  enum:
                    - ACK
                    - RESULT
                    - FULL
                  example: ACK
                  description: 用于设置JSON响应的格式。 支持的数值： [订单返回类型](/products/spot/enums#orderresponsetype)
                selfTradePreventionMode:
                  type: string
                  enum:
                    - NONE
                    - EXPIRE_TAKER
                    - EXPIRE_MAKER
                    - EXPIRE_BOTH
                    - DECREMENT
                    - TRANSFER
                  example: NONE
                  description: 允许的数值取决于交易对上的配置。参考 [STP 模式](/products/spot/enums#stpmodes)
                workingType:
                  type: string
                  enum:
                    - LIMIT
                    - LIMIT_MAKER
                  example: LIMIT
                  description: 支持的数值： `LIMIT`， `LIMIT_MAKER`
                workingSide:
                  type: string
                  enum:
                    - BUY
                    - SELL
                  example: BUY
                  description: 支持的数值： [订单方向](/products/spot/enums#side)
                workingClientOrderId:
                  type: string
                  example: workingOrder1
                  description: 用于标识生效订单的唯一ID。 如果未发送则自动生成。
                workingPrice:
                  type: number
                  format: float
                  example: 1
                workingQuantity:
                  type: number
                  format: float
                  example: 1
                  description: 用于设置生效订单的数量。
                workingIcebergQty:
                  type: number
                  format: float
                  example: 1
                  description: 仅当 `workingTimeInForce` 为 `GTC` 或 `workingType` 为 `LIMIT_MAKER` 时，才能使用此功能。
                workingTimeInForce:
                  type: string
                  enum:
                    - GTC
                    - IOC
                    - FOK
                  example: GTC
                  description: 支持的数值： [生效时间](/products/spot/enums#timeinforce)
                workingStrategyId:
                  type: integer
                  format: int64
                  example: 1
                  description: 订单策略中用于标识生效订单的 ID。
                workingStrategyType:
                  type: integer
                  example: 1
                  description: 用于标识生效订单策略的任意数值。 小于 `1000000` 的值被保留，无法使用。
                pendingType:
                  type: string
                  enum:
                    - LIMIT
                    - MARKET
                    - STOP_LOSS
                    - STOP_LOSS_LIMIT
                    - TAKE_PROFIT
                    - TAKE_PROFIT_LIMIT
                    - LIMIT_MAKER
                  example: LIMIT
                  description: 支持的数值： [订单类型](/products/spot/enums#ordertypes) 请注意，系统不支持使用 `quoteOrderQty` 的 `MARKET` 订单。
                workingPegPriceType:
                  type: string
                  enum:
                    - PRIMARY_PEG
                    - MARKET_PEG
                  example: PRIMARY_PEG
                  description: 参阅 [关于挂钩订单参数的注意事项](/products/spot/faqs/pegged_orders)
                workingPegOffsetType:
                  type: string
                  enum:
                    - PRICE_LEVEL
                  example: PRICE_LEVEL
                workingPegOffsetValue:
                  type: integer
                  example: 1
                pendingSide:
                  type: string
                  enum:
                    - BUY
                    - SELL
                  example: BUY
                  description: 支持的数值： [订单方向](/products/spot/enums#side)
                pendingClientOrderId:
                  type: string
                  example: pendingOrder1
                  description: 用于标识待处理订单的唯一ID。 如果未发送则自动生成。
                pendingPrice:
                  type: number
                  format: float
                  example: 1
                pendingStopPrice:
                  type: number
                  format: float
                  example: 1
                pendingTrailingDelta:
                  type: number
                  format: float
                  example: 1
                pendingQuantity:
                  type: number
                  format: float
                  example: 1
                  description: 用于设置待处理订单的数量。
                pendingIcebergQty:
                  type: number
                  format: float
                  example: 1
                  description: 只有当 `pendingTimeInForce` 为 `GTC` 或者当 `pendingType` 为 `LIMIT_MAKER` 时才能使用。
                pendingTimeInForce:
                  type: string
                  enum:
                    - GTC
                    - IOC
                    - FOK
                  example: GTC
                  description: 支持的数值： [生效时间](/products/spot/enums#timeinforce)
                pendingStrategyId:
                  type: integer
                  format: int64
                  example: 1
                  description: 订单策略中用于标识待处理订单的 ID。
                pendingStrategyType:
                  type: integer
                  example: 1
                  description: 用于标识待处理订单策略的任意数值。 小于 `1000000` 的值被保留，无法使用。
                pendingPegPriceType:
                  type: string
                  enum:
                    - PRIMARY_PEG
                    - MARKET_PEG
                  example: PRIMARY_PEG
                  description: 参阅 [关于挂钩订单参数的注意事项](/products/spot/faqs/pegged_orders)
                pendingPegOffsetType:
                  type: string
                  enum:
                    - PRICE_LEVEL
                  example: PRICE_LEVEL
                pendingPegOffsetValue:
                  type: integer
                  example: 1
                recvWindow:
                  type: number
                  format: float
                  example: 5000
                  description: 最大值为 `60000` 毫秒。 支持最多三位小数的精度（例如 6000.346），以便可以指定微秒。
                timestamp:
                  type: integer
                  example: 1770736694138
                  format: int64
                  description: 用于请求签名的 Unix 时间戳，单位为毫秒. 该值必须反映客户端当前时间，并会在签名接口中由服务器进行校验.
      responses:
        '200':
          description: New 订单 列表- OTO
          content:
            application/json:
              schema:
                type: object
                properties:
                  orderListId:
                    type: integer
                    format: int64
                    example: 0
                  contingencyType:
                    type: string
                    example: OTO
                  listStatusType:
                    type: string
                    example: EXEC_STARTED
                  listOrderStatus:
                    type: string
                    example: EXECUTING
                  listClientOrderId:
                    type: string
                    example: yl2ERtcar1o25zcWtqVBTC
                  transactionTime:
                    type: integer
                    format: int64
                    example: 1712289389158
                  symbol:
                    type: string
                    example: LTCBTC
                  orders:
                    type: array
                    items:
                      type: object
                      properties:
                        symbol:
                          type: string
                          example: LTCBTC
                        orderId:
                          type: integer
                          format: int64
                          example: 4
                        clientOrderId:
                          type: string
                          example: Bq17mn9fP6vyCn75Jw1xya
                  orderReports:
                    type: array
                    items:
                      type: object
                      properties:
                        symbol:
                          type: string
                          example: LTCBTC
                        orderId:
                          type: integer
                          format: int64
                          example: 4
                        orderListId:
                          type: integer
                          format: int64
                          example: 0
                        clientOrderId:
                          type: string
                          example: Bq17mn9fP6vyCn75Jw1xya
                        transactTime:
                          type: integer
                          format: int64
                          example: 1712289389158
                        price:
                          type: string
                          example: '1.00000000'
                        origQty:
                          type: string
                          example: '1.00000000'
                        executedQty:
                          type: string
                          example: '0.00000000'
                        origQuoteOrderQty:
                          type: string
                          example: '0.000000'
                        cummulativeQuoteQty:
                          type: string
                          example: '0.00000000'
                        status:
                          type: string
                          example: NEW
                        timeInForce:
                          type: string
                          example: GTC
                        type:
                          type: string
                          example: LIMIT
                        side:
                          type: string
                          example: SELL
                        workingTime:
                          type: integer
                          format: int64
                          example: 1712289389158
                        selfTradePreventionMode:
                          type: string
                          example: NONE
                        icebergQty:
                          type: string
                          example: '0.00000000'
                          description: 仅在请求中发送了 icebergQty 参数时出现。
                        preventedMatchId:
                          type: integer
                          format: int64
                          example: 0
                          description: 仅在因 STP 导致订单失效时出现。
                        preventedQuantity:
                          type: string
                          example: '1.200000'
                          description: 因 STP 导致订单失效的数量。
                        stopPrice:
                          type: string
                          example: '0.00000000'
                          description: 出现在 STOP_LOSS, TAKE_PROFIT, STOP_LOSS_LIMIT 和 TAKE_PROFIT_LIMIT 订单中。
                        strategyId:
                          type: integer
                          format: int64
                          example: 1
                          description: 仅在下单时提供了 strategyId 参数时出现。
                        strategyType:
                          type: integer
                          format: int64
                          example: 1000000
                          description: 仅在下单时提供了 strategyType 参数时出现。
                        trailingDelta:
                          type: integer
                          format: int64
                          example: 10
                          description: 订单激活前所需的价格变动。
                        trailingTime:
                          type: integer
                          format: int64
                          example: -1
                          description: 追踪单被激活和跟踪价格变化的时间。
                        usedSor:
                          type: boolean
                          example: true
                          description: 用于确定订单是否使用SOR的字段。
                        workingFloor:
                          type: string
                          example: SOR
                          description: 用以定义订单是通过 SOR 还是由订单簿成交的。
                        pegPriceType:
                          type: string
                          example: PRIMARY_PEG
                          description: 挂钩价格类型。仅用于挂钩订单。
                        pegOffsetType:
                          type: string
                          example: PRICE_LEVEL
                          description: 挂钩价格偏移类型。如若需要，仅用于挂钩订单。
                        pegOffsetValue:
                          type: integer
                          format: int64
                          example: 5
                          description: 挂钩价格偏移值。如若需要，仅用于挂钩订单。
                        peggedPrice:
                          type: string
                          example: '87523.83710000'
                          description: 订单对应的当前挂钩价格。一旦确定，仅用于挂钩订单。
                        expiryReason:
                          type: string
                          example: INSUFFICIENT_LIQUIDITY
                          description: 订单过期的原因。当订单过期时出现。
  /api/v3/orderList/otoco:
    post:
      summary: New 订单 列表- OTOCO (TRADE)
      description: |-
        发送一个新的 OTOCO 订单。

        - 一个 OTOCO 订单（One-Triggers-One-Cancels-the-Other）是一个包含了三个订单的订单列表。
        - 第一个订单被称为**生效订单**，必须为 `LIMIT` 或 `LIMIT_MAKER` 类型的订单。最初，订单簿上只有生效订单。
          - 生效订单的行为与此一致 [OTO](#order-list-oto)
        - 一个OTOCO订单有两个待处理订单（pending above 和 pending below），它们构成了一个 OCO 订单列表。只有当生效订单**完全成交**时，待处理订单们才会被自动下单。
          - 待处理上方(pending above)订单和待处理下方(pending below)订单都遵循与 OCO 订单列表相同的规则 [OrderList OCO](#order-list-oco)。
        - `OTOCO` 在 `EXCHANGE_MAX_NUM_ORDERS` 过滤器和 `MAX_NUM_ORDERS` 过滤器的基础上添加**3个订单**。
      tags:
        - trade
      operationId: orderListOtoco
      externalDocs:
        url: https://developers.binance.com/en/docs/catalog/core-trading-spot-trading/api/rest-api/trade#order-list-otoco
      x-connectors-examples:
        ts: https://raw.githubusercontent.com/binance/binance-connector-js/master/clients/spot/examples/rest-api/TradeApi/orderListOtoco.ts
        rust: https://raw.githubusercontent.com/binance/binance-connector-rust/main/examples/spot/rest_api/trade_api/order_list_otoco.rs
        python: https://raw.githubusercontent.com/binance/binance-connector-python/master/clients/spot/examples/rest_api/Trade/order_list_otoco.py
        java: https://raw.githubusercontent.com/binance/binance-connector-java/master/examples/spot/src/main/java/com/binance/connector/client/spot/rest/trade/OrderListOtocoExample.java
        go: https://raw.githubusercontent.com/binance/binance-connector-go/main/clients/spot/examples/restapi/TradeAPI/OrderListOtoco/OrderListOtoco.go
        php: https://raw.githubusercontent.com/binance/binance-connector-php/master/examples/spot/trade/OrderListOtocoExample.php
      x-ip-weight: 1
      x-order-weight: 3
      x-security-type: TRADE
      x-signed: true
      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
      x-parameters-notes: |-
        **数据源:** 撮合引擎

        **根据 `pendingAboveType`， `pendingBelowType` 或者`workingType`的不同值，对于某些参数的强制要求**

        根据 `pendingAboveType`， `pendingBelowType` 或者`workingType`的不同值，对于某些可选参数有强制要求，具体如下：

        |类型                                                        | 强制要求的参数                  | 其他信息|
        |----                                                       |----                           |------
        |`workingType` = `LIMIT`                                    |`workingTimeInForce`           |
        |`pendingAboveType` = `LIMIT_MAKER`                                |`pendingAbovePrice`     |
        |`pendingAboveType` = `STOP_LOSS/TAKE_PROFIT` | `pendingAboveStopPrice` 与/或  `pendingAboveTrailingDelta` |
        |`pendingAboveType` = `STOP_LOSS_LIMIT/TAKE_PROFIT_LIMIT` | `pendingAbovePrice`， `pendingAboveStopPrice` 与/或 `pendingAboveTrailingDelta`， `pendingAboveTimeInForce` |
        |`pendingBelowType` = `LIMIT_MAKER`                                |`pendingBelowPrice`          |
        |`pendingBelowType` = `STOP_LOSS/TAKE_PROFIT` | `pendingBelowStopPrice` 与/或 `pendingBelowTrailingDelta` |
        |`pendingBelowType` = `STOP_LOSS_LIMIT/TAKE_PROFIT_LIMIT` | `pendingBelowPrice`， `pendingBelowStopPrice` 与/或 `pendingBelowTrailingDelta`， `pendingBelowTimeInForce` |
      requestBody:
        required: true
        content:
          application/x-www-form-urlencoded:
            schema:
              type: object
              required:
                - symbol
                - workingType
                - workingSide
                - workingPrice
                - workingQuantity
                - pendingSide
                - pendingQuantity
                - pendingAboveType
                - timestamp
              properties:
                symbol:
                  type: string
                  example: BNBUSDT
                listClientOrderId:
                  type: string
                  example: RumwQpBaDctlUu5jyG5rs0
                  description: 整个订单列表的唯一ID。 如果未发送则自动生成。 仅当前一个订单列表已填满或完全过期时，才会接受含有相同 `listClientOrderId` 值的新订单列表。 `listClientOrderId` 与 `workingClientOrderId` 和 `pendingClientOrderId` 不同。
                newOrderRespType:
                  type: string
                  enum:
                    - ACK
                    - RESULT
                    - FULL
                  example: ACK
                  description: 用于设置JSON响应的格式。 支持的数值： [订单返回类型](/products/spot/enums#orderresponsetype)
                selfTradePreventionMode:
                  type: string
                  enum:
                    - NONE
                    - EXPIRE_TAKER
                    - EXPIRE_MAKER
                    - EXPIRE_BOTH
                    - DECREMENT
                    - TRANSFER
                  example: NONE
                  description: 允许的数值取决于交易对上的配置。参考 [STP 模式](/products/spot/enums#stpmodes)
                workingType:
                  type: string
                  enum:
                    - LIMIT
                    - LIMIT_MAKER
                  example: LIMIT
                  description: 支持的数值： `LIMIT`， `LIMIT_MAKER`
                workingSide:
                  type: string
                  enum:
                    - BUY
                    - SELL
                  example: BUY
                  description: 支持的数值： [订单方向](/products/spot/enums#side)
                workingClientOrderId:
                  type: string
                  example: workingOrder1
                  description: 用于标识生效订单的唯一ID。 如果未发送则自动生成。
                workingPrice:
                  type: number
                  format: float
                  example: 1
                workingQuantity:
                  type: number
                  format: float
                  example: 1
                  description: 用于设置生效订单的数量。
                workingIcebergQty:
                  type: number
                  format: float
                  example: 1
                  description: 仅当 `workingTimeInForce` 为 `GTC` 或 `workingType` 为 `LIMIT_MAKER` 时，才能使用此功能。
                workingTimeInForce:
                  type: string
                  enum:
                    - GTC
                    - IOC
                    - FOK
                  example: GTC
                  description: 支持的数值： [生效时间](/products/spot/enums#timeinforce)
                workingStrategyId:
                  type: integer
                  format: int64
                  example: 1
                  description: 订单策略中用于标识生效订单的 ID。
                workingStrategyType:
                  type: integer
                  example: 1
                  description: 用于标识生效订单策略的任意数值。 小于 `1000000` 的值被保留，无法使用。
                workingPegPriceType:
                  type: string
                  enum:
                    - PRIMARY_PEG
                    - MARKET_PEG
                  example: PRIMARY_PEG
                  description: 参阅 [关于挂钩订单参数的注意事项](/products/spot/faqs/pegged_orders)
                workingPegOffsetType:
                  type: string
                  enum:
                    - PRICE_LEVEL
                  example: PRICE_LEVEL
                workingPegOffsetValue:
                  type: integer
                  example: 1
                pendingSide:
                  type: string
                  enum:
                    - BUY
                    - SELL
                  example: BUY
                  description: 支持的数值： [订单方向](/products/spot/enums#side)
                pendingQuantity:
                  type: number
                  format: float
                  example: 1
                  description: 用于设置待处理订单的数量。
                pendingAboveType:
                  type: string
                  enum:
                    - STOP_LOSS_LIMIT
                    - STOP_LOSS
                    - LIMIT_MAKER
                    - TAKE_PROFIT
                    - TAKE_PROFIT_LIMIT
                  example: STOP_LOSS_LIMIT
                  description: 支持的数值： `STOP_LOSS_LIMIT`, `STOP_LOSS`, `LIMIT_MAKER`, `TAKE_PROFIT`, `TAKE_PROFIT_LIMIT`
                pendingAboveClientOrderId:
                  type: string
                  example: pendingAboveOrder1
                  description: 用于标识待处理上方订单的唯一ID。 如果未发送则自动生成。
                pendingAbovePrice:
                  type: number
                  format: float
                  example: 1
                  description: 当 `pendingAboveType` 是 `STOP_LOSS_LIMIT`, `LIMIT_MAKER` 或 `TAKE_PROFIT_LIMIT` 时，可用以指定限价。
                pendingAboveStopPrice:
                  type: number
                  format: float
                  example: 1
                  description: 如果 `pendingAboveType` 是 `STOP_LOSS`, `STOP_LOSS_LIMIT`, `TAKE_PROFIT`, `TAKE_PROFIT_LIMIT` 才能使用。
                pendingAboveTrailingDelta:
                  type: number
                  format: float
                  example: 1
                  description: 参见 [追踪止盈止损(Trailing Stop)订单常见问题](/products/spot/faqs/trailing-stop-faq)
                pendingAboveIcebergQty:
                  type: number
                  format: float
                  example: 1
                  description: 只有当 `pendingAboveTimeInForce` 为 `GTC` 或 `pendingAboveType` 为 `LIMIT_MAKER` 时才能使用。
                pendingAboveTimeInForce:
                  type: string
                  enum:
                    - GTC
                    - IOC
                    - FOK
                  example: GTC
                  description: 如果 `pendingAboveType` 是 `STOP_LOSS_LIMIT` 或 `TAKE_PROFIT_LIMIT`，则为必填项。
                pendingAboveStrategyId:
                  type: integer
                  format: int64
                  example: 1
                  description: 订单策略中用于标识待处理上方订单的 ID。
                pendingAboveStrategyType:
                  type: integer
                  example: 1
                  description: 用于标识待处理上方订单策略的任意数值。 小于 `1000000` 的值被保留，无法使用。
                pendingAbovePegPriceType:
                  type: string
                  enum:
                    - PRIMARY_PEG
                    - MARKET_PEG
                  example: PRIMARY_PEG
                  description: 参阅 [关于挂钩订单参数的注意事项](/products/spot/faqs/pegged_orders)
                pendingAbovePegOffsetType:
                  type: string
                  enum:
                    - PRICE_LEVEL
                  example: PRICE_LEVEL
                pendingAbovePegOffsetValue:
                  type: integer
                  example: 1
                pendingBelowType:
                  type: string
                  enum:
                    - STOP_LOSS
                    - STOP_LOSS_LIMIT
                    - TAKE_PROFIT
                    - TAKE_PROFIT_LIMIT
                  example: STOP_LOSS
                  description: 支持的数值： `STOP_LOSS`, `STOP_LOSS_LIMIT`, `TAKE_PROFIT`, `TAKE_PROFIT_LIMIT`
                pendingBelowClientOrderId:
                  type: string
                  example: pendingBelowOrder1
                  description: 用于标识待处理下方订单的唯一ID。 如果未发送则自动生成。
                pendingBelowPrice:
                  type: number
                  format: float
                  example: 1
                  description: 当 `pendingBelowType` 是 `STOP_LOSS_LIMIT` 或 `TAKE_PROFIT_LIMIT` 时，可用以指定限价。
                pendingBelowStopPrice:
                  type: number
                  format: float
                  example: 1
                  description: 如果 `pendingBelowType` 是 `STOP_LOSS`, `STOP_LOSS_LIMIT`, `TAKE_PROFIT`, `TAKE_PROFIT_LIMIT` 才能使用。 必须指定 `pendingBelowStopPrice` 或 `pendingBelowTrailingDelta` 或两者。
                pendingBelowTrailingDelta:
                  type: number
                  format: float
                  example: 1
                  description: 参见 [追踪止盈止损(Trailing Stop)订单常见问题](/products/spot/faqs/trailing-stop-faq)
                pendingBelowIcebergQty:
                  type: number
                  format: float
                  example: 1
                  description: 只有当 `pendingBelowTimeInForce` 为 `GTC` 或 `pendingBelowType` 为 `LIMIT_MAKER` 时才能使用。
                pendingBelowTimeInForce:
                  type: string
                  enum:
                    - GTC
                    - IOC
                    - FOK
                  example: GTC
                  description: 如果 `pendingBelowType` 是 `STOP_LOSS_LIMIT` 或 `TAKE_PROFIT_LIMIT`，则为必须配合提交的值。
                pendingBelowStrategyId:
                  type: integer
                  format: int64
                  example: 1
                  description: 订单策略中用于标识待处理下方订单的 ID。
                pendingBelowStrategyType:
                  type: integer
                  example: 1
                  description: 用于标识待处理下方订单策略的任意数值。 小于 `1000000` 的值被保留，无法使用。
                pendingBelowPegPriceType:
                  type: string
                  enum:
                    - PRIMARY_PEG
                    - MARKET_PEG
                  example: PRIMARY_PEG
                  description: 参阅 [关于挂钩订单参数的注意事项](/products/spot/faqs/pegged_orders)
                pendingBelowPegOffsetType:
                  type: string
                  enum:
                    - PRICE_LEVEL
                  example: PRICE_LEVEL
                pendingBelowPegOffsetValue:
                  type: integer
                  example: 1
                recvWindow:
                  type: number
                  format: float
                  example: 5000
                  description: 最大值为 `60000` 毫秒。 支持最多三位小数的精度（例如 6000.346），以便可以指定微秒。
                timestamp:
                  type: integer
                  example: 1770736694138
                  format: int64
                  description: 用于请求签名的 Unix 时间戳，单位为毫秒. 该值必须反映客户端当前时间，并会在签名接口中由服务器进行校验.
      responses:
        '200':
          description: New 订单 列表- OTOCO
          content:
            application/json:
              schema:
                type: object
                properties:
                  orderListId:
                    type: integer
                    format: int64
                    example: 1
                  contingencyType:
                    type: string
                    example: OTO
                  listStatusType:
                    type: string
                    example: EXEC_STARTED
                  listOrderStatus:
                    type: string
                    example: EXECUTING
                  listClientOrderId:
                    type: string
                    example: RumwQpBaDctlUu5jyG5rs0
                  transactionTime:
                    type: integer
                    format: int64
                    example: 1712291372842
                  symbol:
                    type: string
                    example: LTCBTC
                  orders:
                    type: array
                    items:
                      type: object
                      properties:
                        symbol:
                          type: string
                          example: LTCBTC
                        orderId:
                          type: integer
                          format: int64
                          example: 6
                        clientOrderId:
                          type: string
                          example: fM9Y4m23IFJVCQmIrlUmMK
                  orderReports:
                    type: array
                    items:
                      type: object
                      properties:
                        symbol:
                          type: string
                          example: LTCBTC
                        orderId:
                          type: integer
                          format: int64
                          example: 6
                        orderListId:
                          type: integer
                          format: int64
                          example: 1
                        clientOrderId:
                          type: string
                          example: fM9Y4m23IFJVCQmIrlUmMK
                        transactTime:
                          type: integer
                          format: int64
                          example: 1712291372842
                        price:
                          type: string
                          example: '1.00000000'
                        origQty:
                          type: string
                          example: '1.00000000'
                        executedQty:
                          type: string
                          example: '0.00000000'
                        origQuoteOrderQty:
                          type: string
                          example: '0.000000'
                        cummulativeQuoteQty:
                          type: string
                          example: '0.00000000'
                        status:
                          type: string
                          example: NEW
                        timeInForce:
                          type: string
                          example: GTC
                        type:
                          type: string
                          example: LIMIT
                        side:
                          type: string
                          example: SELL
                        workingTime:
                          type: integer
                          format: int64
                          example: 1712291372842
                        selfTradePreventionMode:
                          type: string
                          example: NONE
                        icebergQty:
                          type: string
                          example: '0.00000000'
                          description: 仅在请求中发送了 icebergQty 参数时出现。
                        preventedMatchId:
                          type: integer
                          format: int64
                          example: 0
                          description: 仅在因 STP 导致订单失效时出现。
                        preventedQuantity:
                          type: string
                          example: '1.200000'
                          description: 因 STP 导致订单失效的数量。
                        stopPrice:
                          type: string
                          example: '0.00000000'
                          description: 出现在 STOP_LOSS, TAKE_PROFIT, STOP_LOSS_LIMIT 和 TAKE_PROFIT_LIMIT 订单中。
                        strategyId:
                          type: integer
                          format: int64
                          example: 1
                          description: 仅在下单时提供了 strategyId 参数时出现。
                        strategyType:
                          type: integer
                          format: int64
                          example: 1000000
                          description: 仅在下单时提供了 strategyType 参数时出现。
                        trailingDelta:
                          type: integer
                          format: int64
                          example: 10
                          description: 订单激活前所需的价格变动。
                        trailingTime:
                          type: integer
                          format: int64
                          example: -1
                          description: 追踪单被激活和跟踪价格变化的时间。
                        usedSor:
                          type: boolean
                          example: true
                          description: 用于确定订单是否使用SOR的字段。
                        workingFloor:
                          type: string
                          example: SOR
                          description: 用以定义订单是通过 SOR 还是由订单簿成交的。
                        pegPriceType:
                          type: string
                          example: PRIMARY_PEG
                          description: 挂钩价格类型。仅用于挂钩订单。
                        pegOffsetType:
                          type: string
                          example: PRICE_LEVEL
                          description: 挂钩价格偏移类型。如若需要，仅用于挂钩订单。
                        pegOffsetValue:
                          type: integer
                          format: int64
                          example: 5
                          description: 挂钩价格偏移值。如若需要，仅用于挂钩订单。
                        peggedPrice:
                          type: string
                          example: '87523.83710000'
                          description: 订单对应的当前挂钩价格。一旦确定，仅用于挂钩订单。
                        expiryReason:
                          type: string
                          example: INSUFFICIENT_LIQUIDITY
                          description: 订单过期的原因。当订单过期时出现。
  /api/v3/order/oco:
    post:
      summary: 发送新 OCO 订单 - 已弃用 (TRADE)
      description: |-
        发送新的 OCO。

        - 价格限制：
          - `SELL`： Limit price > 最后交易价格 > stop Price
          - `BUY`： Limit price < 最后交易价格 < stop Price
        - 数量限制：
          - 两条腿的数量必须相同。
          - 不过， `冰山` 交易的数量不一定相同
        - `OCO` 将**2个订单**添加到 `EXCHANGE_MAX_ORDERS` 过滤器和 `MAX_NUM_ORDERS` 过滤器中。
      deprecated: true
      tags:
        - trade
      operationId: orderOco
      externalDocs:
        url: https://developers.binance.com/en/docs/catalog/core-trading-spot-trading/api/rest-api/trade#order-oco
      x-connectors-examples:
        ts: https://raw.githubusercontent.com/binance/binance-connector-js/master/clients/spot/examples/rest-api/TradeApi/orderOco.ts
        rust: https://raw.githubusercontent.com/binance/binance-connector-rust/main/examples/spot/rest_api/trade_api/order_oco.rs
        python: https://raw.githubusercontent.com/binance/binance-connector-python/master/clients/spot/examples/rest_api/Trade/order_oco.py
        java: https://raw.githubusercontent.com/binance/binance-connector-java/master/examples/spot/src/main/java/com/binance/connector/client/spot/rest/trade/OrderOcoExample.java
        go: https://raw.githubusercontent.com/binance/binance-connector-go/main/clients/spot/examples/restapi/TradeAPI/OrderOco/OrderOco.go
        php: https://raw.githubusercontent.com/binance/binance-connector-php/master/examples/spot/trade/OrderOcoExample.php
      x-ip-weight: 1
      x-order-weight: 2
      x-security-type: TRADE
      x-signed: true
      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
      x-parameters-notes: '**数据源:** 撮合引擎'
      requestBody:
        required: true
        content:
          application/x-www-form-urlencoded:
            schema:
              type: object
              required:
                - symbol
                - side
                - quantity
                - price
                - stopPrice
                - timestamp
              properties:
                symbol:
                  type: string
                  example: BNBUSDT
                listClientOrderId:
                  type: string
                  example: JYVpp3F0f5CAG15DhtrqLp
                  description: 整个orderList的唯一ID
                side:
                  type: string
                  enum:
                    - BUY
                    - SELL
                  example: BUY
                quantity:
                  type: number
                  format: float
                  example: 1
                limitClientOrderId:
                  type: string
                  example: limitOrder1
                  description: 限价单的唯一ID
                price:
                  type: number
                  format: float
                  example: 1
                limitStrategyId:
                  type: integer
                  format: int64
                  example: 1
                limitStrategyType:
                  type: integer
                  example: 1
                  description: 不能低于 `1000000`
                limitIcebergQty:
                  type: number
                  format: float
                  example: 1
                  description: 用于使 `LIMIT_MAKER` 腿单成为冰山订单。
                trailingDelta:
                  type: integer
                  format: int64
                  example: 1
                stopClientOrderId:
                  type: string
                  example: stopOrder1
                  description: 止损/止损限价单的唯一ID
                stopPrice:
                  type: number
                  format: float
                  example: 1
                stopStrategyId:
                  type: integer
                  format: int64
                  example: 1
                stopStrategyType:
                  type: integer
                  example: 1
                  description: 不能低于 `1000000`
                stopLimitPrice:
                  type: number
                  format: float
                  example: 1
                  description: 如果提供，须配合提交`stopLimitTimeInForce`
                stopIcebergQty:
                  type: number
                  format: float
                  example: 1
                  description: 与 `STOP_LOSS_LIMIT` 腿单一起使用，使其成为冰山订单。
                stopLimitTimeInForce:
                  type: string
                  enum:
                    - GTC
                    - IOC
                    - FOK
                  example: GTC
                  description: 有效值 `GTC`/`FOK`/`IOC`
                newOrderRespType:
                  type: string
                  enum:
                    - ACK
                    - RESULT
                    - FULL
                  example: ACK
                  description: JSON 响应格式。支持的数值：[订单返回类型](/products/spot/enums#orderresponsetype)
                selfTradePreventionMode:
                  type: string
                  enum:
                    - NONE
                    - EXPIRE_TAKER
                    - EXPIRE_MAKER
                    - EXPIRE_BOTH
                    - DECREMENT
                    - TRANSFER
                  example: NONE
                  description: 允许的值取决于交易对的配置。支持的数值：[STP模式](/products/spot/enums#stpmodes)
                recvWindow:
                  type: number
                  format: float
                  example: 5000
                  description: 最大值为 `60000` 毫秒。 <br> 支持最多三位小数的精度（例如 6000.346），以便可以指定微秒。
                timestamp:
                  type: integer
                  example: 1770736694138
                  format: int64
                  description: 用于请求签名的 Unix 时间戳，单位为毫秒. 该值必须反映客户端当前时间，并会在签名接口中由服务器进行校验.
      responses:
        '200':
          description: 发送新 OCO 订单 - 已弃用
          content:
            application/json:
              schema:
                type: object
                properties:
                  orderListId:
                    type: integer
                    format: int64
                    example: 0
                  contingencyType:
                    type: string
                    example: OCO
                  listStatusType:
                    type: string
                    example: EXEC_STARTED
                  listOrderStatus:
                    type: string
                    example: EXECUTING
                  listClientOrderId:
                    type: string
                    example: JYVpp3F0f5CAG15DhtrqLp
                  transactionTime:
                    type: integer
                    format: int64
                    example: 1563417480525
                  symbol:
                    type: string
                    example: LTCBTC
                  orders:
                    type: array
                    items:
                      type: object
                      properties:
                        symbol:
                          type: string
                          example: LTCBTC
                        orderId:
                          type: integer
                          format: int64
                          example: 2
                        clientOrderId:
                          type: string
                          example: Kk7sqHb9J6mJWTMDVW7Vos
                  orderReports:
                    type: array
                    items:
                      type: object
                      properties:
                        symbol:
                          type: string
                          example: LTCBTC
                        orderId:
                          type: integer
                          format: int64
                          example: 2
                        orderListId:
                          type: integer
                          format: int64
                          example: 0
                        clientOrderId:
                          type: string
                          example: Kk7sqHb9J6mJWTMDVW7Vos
                        transactTime:
                          type: integer
                          format: int64
                          example: 1563417480525
                        price:
                          type: string
                          example: '0.000000'
                        origQty:
                          type: string
                          example: '0.624363'
                        executedQty:
                          type: string
                          example: '0.000000'
                        origQuoteOrderQty:
                          type: string
                          example: '0.000000'
                        cummulativeQuoteQty:
                          type: string
                          example: '0.000000'
                        status:
                          type: string
                          example: NEW
                        timeInForce:
                          type: string
                          example: GTC
                        type:
                          type: string
                          example: STOP_LOSS
                        side:
                          type: string
                          example: BUY
                        workingTime:
                          type: integer
                          format: int64
                          example: -1
                        selfTradePreventionMode:
                          type: string
                          example: NONE
                        stopPrice:
                          type: string
                          example: '0.960664'
  /api/v3/order/test:
    post:
      summary: 测试下单接口 (TRADE)
      description: 用于测试订单请求，但不会提交到撮合引擎
      tags:
        - trade
      operationId: orderTest
      externalDocs:
        url: https://developers.binance.com/en/docs/catalog/core-trading-spot-trading/api/rest-api/trade#order-test
      x-connectors-examples:
        ts: https://raw.githubusercontent.com/binance/binance-connector-js/master/clients/spot/examples/rest-api/TradeApi/orderTest.ts
        rust: https://raw.githubusercontent.com/binance/binance-connector-rust/main/examples/spot/rest_api/trade_api/order_test.rs
        python: https://raw.githubusercontent.com/binance/binance-connector-python/master/clients/spot/examples/rest_api/Trade/order_test.py
        java: https://raw.githubusercontent.com/binance/binance-connector-java/master/examples/spot/src/main/java/com/binance/connector/client/spot/rest/trade/OrderTestExample.java
        go: https://raw.githubusercontent.com/binance/binance-connector-go/main/clients/spot/examples/restapi/TradeAPI/OrderTest/OrderTest.go
        php: https://raw.githubusercontent.com/binance/binance-connector-php/master/examples/spot/trade/OrderTestExample.php
      x-security-type: TRADE
      x-signed: true
      x-weight: |-
        |Condition|Weight|
        |---|---|
        |Without `computeCommissionRates`|1|
        |With `computeCommissionRates`|20|
      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
      x-parameters-notes: '**数据源:** 缓存'
      requestBody:
        required: true
        content:
          application/x-www-form-urlencoded:
            schema:
              type: object
              required:
                - symbol
                - side
                - type
                - timestamp
              properties:
                computeCommissionRates:
                  type: boolean
                  example: false
                  description: '默认值: `false` <br> 请参阅[佣金常见问题解答](/products/spot/faqs/commission_faq#test-order-diferences) 了解更多信息。'
                symbol:
                  type: string
                  example: BNBUSDT
                side:
                  type: string
                  enum:
                    - BUY
                    - SELL
                  example: BUY
                  description: 详见枚举定义：[订单方向](/products/spot/enums#side)
                type:
                  type: string
                  enum:
                    - MARKET
                    - LIMIT
                    - STOP_LOSS
                    - STOP_LOSS_LIMIT
                    - TAKE_PROFIT
                    - TAKE_PROFIT_LIMIT
                    - LIMIT_MAKER
                  example: MARKET
                  description: 详见枚举定义：[订单类型](/products/spot/enums#ordertypes)
                timeInForce:
                  type: string
                  enum:
                    - GTC
                    - IOC
                    - FOK
                  example: GTC
                  description: 详见枚举定义：[生效时间](/products/spot/enums#timeinforce)
                quantity:
                  type: number
                  format: float
                  example: 1
                quoteOrderQty:
                  type: number
                  format: float
                  example: 1
                price:
                  type: number
                  format: float
                  example: 400
                newClientOrderId:
                  type: string
                  example: myOrder1
                  description: 用户自定义的orderid，如空缺系统会自动赋值。
                strategyId:
                  type: integer
                  format: int64
                  example: 1
                strategyType:
                  type: integer
                  example: 1
                  description: 不能低于 `1000000`。
                stopPrice:
                  type: number
                  format: float
                  example: 1
                  description: 仅 `STOP_LOSS`, `STOP_LOSS_LIMIT`, `TAKE_PROFIT`, `TAKE_PROFIT_LIMIT` 需要此参数。
                trailingDelta:
                  type: integer
                  format: int64
                  example: 1
                  description: 参见 [追踪止盈止损(Trailing Stop)订单常见问题](/products/spot/faqs/trailing-stop-faq)
                icebergQty:
                  type: number
                  format: float
                  example: 1
                  description: 仅有限价单(包括条件限价单与限价做事单)可以使用该参数，含义为创建冰山订单并指定冰山订单的数量。
                newOrderRespType:
                  type: string
                  enum:
                    - ACK
                    - RESULT
                    - FULL
                  example: ACK
                  description: 指定响应类型 `ACK`, `RESULT`, or `FULL`; `MARKET` 与 `LIMIT` 订单默认为`FULL`, 其他默认为`ACK`。
                selfTradePreventionMode:
                  type: string
                  enum:
                    - NONE
                    - EXPIRE_TAKER
                    - EXPIRE_MAKER
                    - EXPIRE_BOTH
                    - DECREMENT
                    - TRANSFER
                  example: NONE
                  description: 允许的 ENUM 取决于交易对的配置。支持的值有：[STP 模式](/products/spot/enums#stpmodes)。
                pegPriceType:
                  type: string
                  enum:
                    - PRIMARY_PEG
                    - MARKET_PEG
                  example: PRIMARY_PEG
                  description: '`PRIMARY_PEG` 或 `MARKET_PEG`。 参阅 [关于挂钩订单参数的注意事项](/products/spot/faqs/pegged_orders)'
                pegOffsetValue:
                  type: integer
                  example: 1
                  description: 用于挂钩的价格水平（最大值：100）。 参阅 [关于挂钩订单参数的注意事项](/products/spot/faqs/pegged_orders)
                pegOffsetType:
                  type: string
                  enum:
                    - PRICE_LEVEL
                  example: PRICE_LEVEL
                  description: 仅支持 `PRICE_LEVEL`。 参阅 [关于挂钩订单参数的注意事项](/products/spot/faqs/pegged_orders)
                recvWindow:
                  type: number
                  format: float
                  example: 5000
                  description: 最大值为 `60000` 毫秒。 支持最多三位小数的精度（例如 6000.346），以便可以指定微秒。
                timestamp:
                  type: integer
                  example: 1770736694138
                  format: int64
                  description: 用于请求签名的 Unix 时间戳，单位为毫秒. 该值必须反映客户端当前时间，并会在签名接口中由服务器进行校验.
      responses:
        '200':
          description: 测试下单接口
          content:
            application/json:
              schema:
                type: object
                properties:
                  standardCommissionForOrder:
                    type: object
                    properties:
                      maker:
                        type: string
                        example: 0.00000112
                      taker:
                        type: string
                        example: 0.00000114
                    description: 订单交易的标准佣金率
                  specialCommissionForOrder:
                    type: object
                    properties:
                      maker:
                        type: string
                        example: 0.05
                      taker:
                        type: string
                        example: 0.06
                    description: 订单交易的特殊佣金率
                  taxCommissionForOrder:
                    type: object
                    properties:
                      maker:
                        type: string
                        example: 0.00000112
                      taker:
                        type: string
                        example: 0.00000114
                    description: 订单交易的税率
                  discount:
                    type: object
                    properties:
                      enabledForAccount:
                        type: boolean
                        example: true
                      enabledForSymbol:
                        type: boolean
                        example: true
                      discountAsset:
                        type: string
                        example: BNB
                      discount:
                        type: string
                        example: 0.25
                    description: 以BNB支付时的标准佣金折扣。
  /api/v3/sor/order:
    post:
      summary: 下 SOR 订单 (TRADE)
      description: |-
        发送使用智能订单路由 (SOR) 的新订单。

        这个请求会把1个订单添加到 `EXCHANGE_MAX_ORDERS` 过滤器和 `MAX_NUM_ORDERS` 过滤器中。

        参阅 [智能订单路由 (SOR)](/products/spot/faqs/sor_faq) 了解更多详情。
      tags:
        - trade
      operationId: sorOrder
      externalDocs:
        url: https://developers.binance.com/en/docs/catalog/core-trading-spot-trading/api/rest-api/trade#sor-order
      x-connectors-examples:
        ts: https://raw.githubusercontent.com/binance/binance-connector-js/master/clients/spot/examples/rest-api/TradeApi/sorOrder.ts
        rust: https://raw.githubusercontent.com/binance/binance-connector-rust/main/examples/spot/rest_api/trade_api/sor_order.rs
        python: https://raw.githubusercontent.com/binance/binance-connector-python/master/clients/spot/examples/rest_api/Trade/sor_order.py
        java: https://raw.githubusercontent.com/binance/binance-connector-java/master/examples/spot/src/main/java/com/binance/connector/client/spot/rest/trade/SorOrderExample.java
        go: https://raw.githubusercontent.com/binance/binance-connector-go/main/clients/spot/examples/restapi/TradeAPI/SorOrder/SorOrder.go
        php: https://raw.githubusercontent.com/binance/binance-connector-php/master/examples/spot/trade/SorOrderExample.php
      x-ip-weight: 1
      x-order-weight: 1
      x-security-type: TRADE
      x-signed: true
      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
      x-parameters-notes: |-
        **数据源:** 撮合引擎

        **请注意:** `POST /api/v3/sor/order` 只支持 `限价` 和 `市场` 单， 并不支持 `quoteOrderQty`。
      requestBody:
        required: true
        content:
          application/x-www-form-urlencoded:
            schema:
              type: object
              required:
                - symbol
                - side
                - type
                - quantity
                - timestamp
              properties:
                symbol:
                  type: string
                  example: BNBUSDT
                side:
                  type: string
                  enum:
                    - BUY
                    - SELL
                  example: BUY
                type:
                  type: string
                  enum:
                    - MARKET
                    - LIMIT
                  example: MARKET
                timeInForce:
                  type: string
                  enum:
                    - GTC
                    - IOC
                    - FOK
                  example: GTC
                quantity:
                  type: number
                  format: float
                  example: 1
                price:
                  type: number
                  format: float
                  example: 400
                newClientOrderId:
                  type: string
                  example: myOrder1
                  description: 用户自定义的orderid，如空缺系统会自动赋值。如果几个订单具有相同的 `newClientOrderID` 赋值，<br/>那么只有在前一个订单成交后才可以接受下一个订单，否则该订单将被拒绝。
                strategyId:
                  type: integer
                  format: int64
                  example: 1
                strategyType:
                  type: integer
                  example: 1
                  description: 赋值不能小于 `1000000`.
                icebergQty:
                  type: number
                  format: float
                  example: 1
                  description: 仅有限价单可以使用该参数，含义为创建冰山订单并指定冰山订单的数量。
                newOrderRespType:
                  type: string
                  enum:
                    - ACK
                    - RESULT
                    - FULL
                  example: ACK
                  description: '指定响应类型:'
                selfTradePreventionMode:
                  type: string
                  enum:
                    - NONE
                    - EXPIRE_TAKER
                    - EXPIRE_MAKER
                    - EXPIRE_BOTH
                    - DECREMENT
                    - TRANSFER
                  example: NONE
                  description: 允许的 ENUM 取决于交易对的配置。支持的值有：[STP 模式](/products/spot/enums#stpmodes)。
                recvWindow:
                  type: number
                  format: float
                  example: 5000
                  description: 最大值为 `60000` 毫秒。 <br> 支持最多三位小数的精度（例如 6000.346），以便可以指定微秒。
                timestamp:
                  type: integer
                  example: 1770736694138
                  format: int64
                  description: 用于请求签名的 Unix 时间戳，单位为毫秒. 该值必须反映客户端当前时间，并会在签名接口中由服务器进行校验.
      responses:
        '200':
          description: 下 SOR 订单
          content:
            application/json:
              schema:
                type: object
                properties:
                  symbol:
                    type: string
                    example: BTCUSDT
                  orderId:
                    type: integer
                    format: int64
                    example: 2
                  orderListId:
                    type: integer
                    format: int64
                    example: -1
                  clientOrderId:
                    type: string
                    example: sBI1KM6nNtOfj5tccZSKly
                  transactTime:
                    type: integer
                    format: int64
                    example: 1689149087774
                  price:
                    type: string
                    example: '31000.00000000'
                  origQty:
                    type: string
                    example: '0.50000000'
                  executedQty:
                    type: string
                    example: '0.50000000'
                  origQuoteOrderQty:
                    type: string
                    example: '0.000000'
                  cummulativeQuoteQty:
                    type: string
                    example: '14000.00000000'
                  status:
                    type: string
                    example: FILLED
                  timeInForce:
                    type: string
                    example: GTC
                  type:
                    type: string
                    example: LIMIT
                  side:
                    type: string
                    example: BUY
                  workingTime:
                    type: integer
                    format: int64
                    example: 1689149087774
                  fills:
                    type: array
                    items:
                      type: object
                      properties:
                        matchType:
                          type: string
                          example: ONE_PARTY_TRADE_REPORT
                        price:
                          type: string
                          example: '28000.00000000'
                        qty:
                          type: string
                          example: '0.50000000'
                        commission:
                          type: string
                          example: '0.00000000'
                        commissionAsset:
                          type: string
                          example: BTC
                        tradeId:
                          type: integer
                          format: int64
                          example: -1
                        allocId:
                          type: integer
                          format: int64
                          example: 0
                  workingFloor:
                    type: string
                    example: SOR
                  selfTradePreventionMode:
                    type: string
                    example: NONE
                  usedSor:
                    type: boolean
                    example: true
  /api/v3/sor/order/test:
    post:
      summary: 测试 SOR 下单接口 (TRADE)
      description: 用于测试使用智能订单路由 (SOR) 的订单请求，但不会提交到撮合引擎
      tags:
        - trade
      operationId: sorOrderTest
      externalDocs:
        url: https://developers.binance.com/en/docs/catalog/core-trading-spot-trading/api/rest-api/trade#sor-order-test
      x-connectors-examples:
        ts: https://raw.githubusercontent.com/binance/binance-connector-js/master/clients/spot/examples/rest-api/TradeApi/sorOrderTest.ts
        rust: https://raw.githubusercontent.com/binance/binance-connector-rust/main/examples/spot/rest_api/trade_api/sor_order_test.rs
        python: https://raw.githubusercontent.com/binance/binance-connector-python/master/clients/spot/examples/rest_api/Trade/sor_order_test.py
        java: https://raw.githubusercontent.com/binance/binance-connector-java/master/examples/spot/src/main/java/com/binance/connector/client/spot/rest/trade/SorOrderTestExample.java
        go: https://raw.githubusercontent.com/binance/binance-connector-go/main/clients/spot/examples/restapi/TradeAPI/SorOrderTest/SorOrderTest.go
        php: https://raw.githubusercontent.com/binance/binance-connector-php/master/examples/spot/trade/SorOrderTestExample.php
      x-security-type: TRADE
      x-signed: true
      x-weight: |-
        |Condition|Weight|
        |---|---|
        |Without `computeCommissionRates`|1|
        |With `computeCommissionRates`|20|
      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
      x-parameters-notes: '**数据源:** 缓存'
      requestBody:
        required: true
        content:
          application/x-www-form-urlencoded:
            schema:
              type: object
              required:
                - symbol
                - side
                - type
                - quantity
                - timestamp
              properties:
                computeCommissionRates:
                  type: boolean
                  example: false
                  default: false
                symbol:
                  type: string
                  example: BNBUSDT
                side:
                  type: string
                  enum:
                    - BUY
                    - SELL
                  example: BUY
                  description: 详见枚举定义：[订单方向](/products/spot/enums#side)
                type:
                  type: string
                  enum:
                    - MARKET
                    - LIMIT
                  example: MARKET
                  description: 详见枚举定义：[订单类型](/products/spot/enums#ordertypes)
                timeInForce:
                  type: string
                  enum:
                    - GTC
                    - IOC
                    - FOK
                  example: GTC
                  description: 详见枚举定义：[生效时间](/products/spot/enums#timeinforce)
                quantity:
                  type: number
                  format: float
                  example: 1
                price:
                  type: number
                  format: float
                  example: 400
                newClientOrderId:
                  type: string
                  example: myOrder1
                  description: 用户自定义的orderid，如空缺系统会自动赋值。如果几个订单具有相同的 `newClientOrderID` 赋值，那么只有在前一个订单成交后才可以接受下一个订单，否则该订单将被拒绝。
                strategyId:
                  type: integer
                  format: int64
                  example: 1
                strategyType:
                  type: integer
                  example: 1
                  description: 赋值不能小于 `1000000`。
                icebergQty:
                  type: number
                  format: float
                  example: 1
                  description: 仅有限价单可以使用该参数，含义为创建冰山订单并指定冰山订单的数量。
                newOrderRespType:
                  type: string
                  enum:
                    - ACK
                    - RESULT
                    - FULL
                  example: ACK
                  description: '指定响应类型: `ACK`, `RESULT` 或 `FULL`; 默认为 `FULL`。'
                selfTradePreventionMode:
                  type: string
                  enum:
                    - NONE
                    - EXPIRE_TAKER
                    - EXPIRE_MAKER
                    - EXPIRE_BOTH
                    - DECREMENT
                    - TRANSFER
                  example: NONE
                  description: 允许的 ENUM 取决于交易对的配置。支持的值有：[STP 模式](/products/spot/enums#stpmodes)。
                recvWindow:
                  type: number
                  format: float
                  example: 5000
                  description: 最大值为 `60000` 毫秒。 支持最多三位小数的精度（例如 6000.346），以便可以指定微秒。
                timestamp:
                  type: integer
                  example: 1770736694138
                  format: int64
                  description: 用于请求签名的 Unix 时间戳，单位为毫秒. 该值必须反映客户端当前时间，并会在签名接口中由服务器进行校验.
      responses:
        '200':
          description: 测试 SOR 下单接口
          content:
            application/json:
              schema:
                type: object
                properties:
                  standardCommissionForOrder:
                    type: object
                    properties:
                      maker:
                        type: string
                        example: 0.00000112
                      taker:
                        type: string
                        example: 0.00000114
                    description: 订单交易的标准佣金率。
                  taxCommissionForOrder:
                    type: object
                    properties:
                      maker:
                        type: string
                        example: 0.00000112
                      taker:
                        type: string
                        example: 0.00000114
                    description: 订单交易的税率。
                  discount:
                    type: object
                    properties:
                      enabledForAccount:
                        type: boolean
                        example: true
                      enabledForSymbol:
                        type: boolean
                        example: true
                      discountAsset:
                        type: string
                        example: BNB
                      discount:
                        type: string
                        example: 0.25
                    description: 以BNB支付时的标准佣金折扣。
components:
  schemas:
    myFiltersResponse:
      type: object
      properties:
        exchangeFilters:
          type: array
          items:
            oneOf:
              - type: object
                properties:
                  filterType:
                    type: string
                    example: EXCHANGE_MAX_NUM_ORDERS
                  maxNumOrders:
                    type: integer
                    format: int64
                    example: 1000
              - type: object
                properties:
                  filterType:
                    type: string
                    example: EXCHANGE_MAX_NUM_ALGO_ORDERS
                  maxNumAlgoOrders:
                    type: integer
                    format: int64
                    example: 200
              - type: object
                properties:
                  filterType:
                    type: string
                    example: EXCHANGE_MAX_NUM_ICEBERG_ORDERS
                  maxNumIcebergOrders:
                    type: integer
                    format: int64
                    example: 10
              - type: object
                properties:
                  filterType:
                    type: string
                    example: EXCHANGE_MAX_NUM_ORDER_LISTS
                  maxNumOrderLists:
                    type: integer
                    format: int64
                    example: 20
            discriminator:
              propertyName: filterType
              mapping:
                EXCHANGE_MAX_NUM_ORDERS: '#/components/schemas/ExchangeMaxNumOrdersFilter'
                EXCHANGE_MAX_NUM_ALGO_ORDERS: '#/components/schemas/ExchangeMaxNumAlgoOrdersFilter'
                EXCHANGE_MAX_NUM_ICEBERG_ORDERS: '#/components/schemas/ExchangeMaxNumIcebergOrdersFilter'
                EXCHANGE_MAX_NUM_ORDER_LISTS: '#/components/schemas/ExchangeMaxNumOrderListsFilter'
        symbolFilters:
          type: array
          items:
            oneOf:
              - type: object
                properties:
                  filterType:
                    type: string
                    example: PRICE_FILTER
                  priceExponent:
                    type: integer
                    example: 8
                  minPrice:
                    type: string
                    example: '0.00000100'
                  maxPrice:
                    type: string
                    example: '100000.00000000'
                  tickSize:
                    type: string
                    example: '0.00000100'
              - type: object
                properties:
                  filterType:
                    type: string
                    example: PERCENT_PRICE
                  multiplierExponent:
                    type: integer
                    example: 4
                  multiplierUp:
                    type: string
                    example: '1.3000'
                  multiplierDown:
                    type: string
                    example: '0.7000'
                  avgPriceMins:
                    type: integer
                    example: 5
              - type: object
                properties:
                  filterType:
                    type: string
                    example: PERCENT_PRICE_BY_SIDE
                  multiplierExponent:
                    type: integer
                    example: 4
                  bidMultiplierUp:
                    type: string
                    example: '1.2000'
                  bidMultiplierDown:
                    type: string
                    example: '0.8000'
                  askMultiplierUp:
                    type: string
                    example: '1.2000'
                  askMultiplierDown:
                    type: string
                    example: '0.8000'
                  avgPriceMins:
                    type: integer
                    example: 5
              - type: object
                properties:
                  filterType:
                    type: string
                    example: LOT_SIZE
                  qtyExponent:
                    type: integer
                    example: 8
                  minQty:
                    type: string
                    example: '0.00010000'
                  maxQty:
                    type: string
                    example: '100000.00000000'
                  stepSize:
                    type: string
                    example: '0.00010000'
              - type: object
                properties:
                  filterType:
                    type: string
                    example: MIN_NOTIONAL
                  priceExponent:
                    type: integer
                    example: 8
                  minNotional:
                    type: string
                    example: '10.00000000'
                  applyToMarket:
                    type: boolean
                    example: true
                  avgPriceMins:
                    type: integer
                    example: 5
              - type: object
                properties:
                  filterType:
                    type: string
                    example: NOTIONAL
                  priceExponent:
                    type: integer
                    example: 8
                  minNotional:
                    type: string
                    example: '10.00000000'
                  applyMinToMarket:
                    type: boolean
                    example: true
                  maxNotional:
                    type: string
                    example: '100000.00000000'
                  applyMaxToMarket:
                    type: boolean
                    example: false
                  avgPriceMins:
                    type: integer
                    example: 5
              - type: object
                properties:
                  filterType:
                    type: string
                    example: ICEBERG_PARTS
                  limit:
                    type: integer
                    format: int64
                    example: 10
              - type: object
                properties:
                  filterType:
                    type: string
                    example: MARKET_LOT_SIZE
                  qtyExponent:
                    type: integer
                    example: 8
                  minQty:
                    type: string
                    example: '0.00000000'
                  maxQty:
                    type: string
                    example: '1000.00000000'
                  stepSize:
                    type: string
                    example: '0.00000000'
              - type: object
                properties:
                  filterType:
                    type: string
                    example: MAX_NUM_ORDERS
                  maxNumOrders:
                    type: integer
                    format: int64
                    example: 200
              - type: object
                properties:
                  filterType:
                    type: string
                    example: MAX_NUM_ALGO_ORDERS
                  maxNumAlgoOrders:
                    type: integer
                    format: int64
                    example: 10
              - type: object
                properties:
                  filterType:
                    type: string
                    example: MAX_NUM_ICEBERG_ORDERS
                  maxNumIcebergOrders:
                    type: integer
                    format: int64
                    example: 5
              - type: object
                properties:
                  filterType:
                    type: string
                    example: MAX_POSITION
                  qtyExponent:
                    type: integer
                    example: 8
                  maxPosition:
                    type: string
                    example: '100.00000000'
              - type: object
                properties:
                  filterType:
                    type: string
                    example: TRAILING_DELTA
                  minTrailingAboveDelta:
                    type: integer
                    format: int64
                    example: 10
                  maxTrailingAboveDelta:
                    type: integer
                    format: int64
                    example: 2000
                  minTrailingBelowDelta:
                    type: integer
                    format: int64
                    example: 10
                  maxTrailingBelowDelta:
                    type: integer
                    format: int64
                    example: 2000
              - type: object
                properties:
                  filterType:
                    type: string
                    example: T_PLUS_SELL
                  endTime:
                    type: integer
                    format: int64
                    example: 1741672924895
              - type: object
                properties:
                  filterType:
                    type: string
                    example: MAX_NUM_ORDER_LISTS
                  maxNumOrderLists:
                    type: integer
                    format: int64
                    example: 20
              - type: object
                properties:
                  filterType:
                    type: string
                    example: MAX_NUM_ORDER_AMENDS
                  maxNumOrderAmends:
                    type: integer
                    format: int64
                    example: 10
            discriminator:
              propertyName: filterType
              mapping:
                PRICE_FILTER: '#/components/schemas/PriceFilter'
                PERCENT_PRICE: '#/components/schemas/PercentPriceFilter'
                PERCENT_PRICE_BY_SIDE: '#/components/schemas/PercentPriceBySideFilter'
                LOT_SIZE: '#/components/schemas/LotSizeFilter'
                MIN_NOTIONAL: '#/components/schemas/MinNotionalFilter'
                NOTIONAL: '#/components/schemas/NotionalFilter'
                ICEBERG_PARTS: '#/components/schemas/IcebergPartsFilter'
                MARKET_LOT_SIZE: '#/components/schemas/MarketLotSizeFilter'
                MAX_NUM_ORDERS: '#/components/schemas/MaxNumOrdersFilter'
                MAX_NUM_ALGO_ORDERS: '#/components/schemas/MaxNumAlgoOrdersFilter'
                MAX_NUM_ICEBERG_ORDERS: '#/components/schemas/MaxNumIcebergOrdersFilter'
                MAX_POSITION: '#/components/schemas/MaxPositionFilter'
                TRAILING_DELTA: '#/components/schemas/TrailingDeltaFilter'
                T_PLUS_SELL: '#/components/schemas/TPlusSellFilter'
                MAX_NUM_ORDER_LISTS: '#/components/schemas/MaxNumOrderListsFilter'
                MAX_NUM_ORDER_AMENDS: '#/components/schemas/MaxNumOrderAmendsFilter'
        assetFilters:
          type: array
          items:
            oneOf:
              - type: object
                properties:
                  filterType:
                    type: string
                    example: MAX_ASSET
                  qtyExponent:
                    type: integer
                    example: 8
                  limit:
                    type: string
                    example: '100.00000000'
                  asset:
                    type: string
                    example: BNB
            discriminator:
              propertyName: filterType
              mapping:
                MAX_ASSET: '#/components/schemas/MaxAssetFilter'
        rateLimits:
          type: array
          items:
            type: object
            properties:
              rateLimitType:
                type: string
                example: REQUEST_WEIGHT
              interval:
                type: string
                example: MINUTE
              intervalNum:
                type: integer
                format: int64
                example: 1
              limit:
                type: integer
                format: int64
                example: 6000
              count:
                type: integer
                format: int64
                example: 321
    exchangeFilters:
      oneOf:
        - type: object
          properties:
            filterType:
              type: string
              example: EXCHANGE_MAX_NUM_ORDERS
            maxNumOrders:
              type: integer
              format: int64
              example: 1000
        - type: object
          properties:
            filterType:
              type: string
              example: EXCHANGE_MAX_NUM_ALGO_ORDERS
            maxNumAlgoOrders:
              type: integer
              format: int64
              example: 200
        - type: object
          properties:
            filterType:
              type: string
              example: EXCHANGE_MAX_NUM_ICEBERG_ORDERS
            maxNumIcebergOrders:
              type: integer
              format: int64
              example: 10
        - type: object
          properties:
            filterType:
              type: string
              example: EXCHANGE_MAX_NUM_ORDER_LISTS
            maxNumOrderLists:
              type: integer
              format: int64
              example: 20
      discriminator:
        propertyName: filterType
        mapping:
          EXCHANGE_MAX_NUM_ORDERS: '#/components/schemas/ExchangeMaxNumOrdersFilter'
          EXCHANGE_MAX_NUM_ALGO_ORDERS: '#/components/schemas/ExchangeMaxNumAlgoOrdersFilter'
          EXCHANGE_MAX_NUM_ICEBERG_ORDERS: '#/components/schemas/ExchangeMaxNumIcebergOrdersFilter'
          EXCHANGE_MAX_NUM_ORDER_LISTS: '#/components/schemas/ExchangeMaxNumOrderListsFilter'
    symbolFilters:
      oneOf:
        - type: object
          properties:
            filterType:
              type: string
              example: PRICE_FILTER
            priceExponent:
              type: integer
              example: 8
            minPrice:
              type: string
              example: '0.00000100'
            maxPrice:
              type: string
              example: '100000.00000000'
            tickSize:
              type: string
              example: '0.00000100'
        - type: object
          properties:
            filterType:
              type: string
              example: PERCENT_PRICE
            multiplierExponent:
              type: integer
              example: 4
            multiplierUp:
              type: string
              example: '1.3000'
            multiplierDown:
              type: string
              example: '0.7000'
            avgPriceMins:
              type: integer
              example: 5
        - type: object
          properties:
            filterType:
              type: string
              example: PERCENT_PRICE_BY_SIDE
            multiplierExponent:
              type: integer
              example: 4
            bidMultiplierUp:
              type: string
              example: '1.2000'
            bidMultiplierDown:
              type: string
              example: '0.8000'
            askMultiplierUp:
              type: string
              example: '1.2000'
            askMultiplierDown:
              type: string
              example: '0.8000'
            avgPriceMins:
              type: integer
              example: 5
        - type: object
          properties:
            filterType:
              type: string
              example: LOT_SIZE
            qtyExponent:
              type: integer
              example: 8
            minQty:
              type: string
              example: '0.00010000'
            maxQty:
              type: string
              example: '100000.00000000'
            stepSize:
              type: string
              example: '0.00010000'
        - type: object
          properties:
            filterType:
              type: string
              example: MIN_NOTIONAL
            priceExponent:
              type: integer
              example: 8
            minNotional:
              type: string
              example: '10.00000000'
            applyToMarket:
              type: boolean
              example: true
            avgPriceMins:
              type: integer
              example: 5
        - type: object
          properties:
            filterType:
              type: string
              example: NOTIONAL
            priceExponent:
              type: integer
              example: 8
            minNotional:
              type: string
              example: '10.00000000'
            applyMinToMarket:
              type: boolean
              example: true
            maxNotional:
              type: string
              example: '100000.00000000'
            applyMaxToMarket:
              type: boolean
              example: false
            avgPriceMins:
              type: integer
              example: 5
        - type: object
          properties:
            filterType:
              type: string
              example: ICEBERG_PARTS
            limit:
              type: integer
              format: int64
              example: 10
        - type: object
          properties:
            filterType:
              type: string
              example: MARKET_LOT_SIZE
            qtyExponent:
              type: integer
              example: 8
            minQty:
              type: string
              example: '0.00000000'
            maxQty:
              type: string
              example: '1000.00000000'
            stepSize:
              type: string
              example: '0.00000000'
        - type: object
          properties:
            filterType:
              type: string
              example: MAX_NUM_ORDERS
            maxNumOrders:
              type: integer
              format: int64
              example: 200
        - type: object
          properties:
            filterType:
              type: string
              example: MAX_NUM_ALGO_ORDERS
            maxNumAlgoOrders:
              type: integer
              format: int64
              example: 10
        - type: object
          properties:
            filterType:
              type: string
              example: MAX_NUM_ICEBERG_ORDERS
            maxNumIcebergOrders:
              type: integer
              format: int64
              example: 5
        - type: object
          properties:
            filterType:
              type: string
              example: MAX_POSITION
            qtyExponent:
              type: integer
              example: 8
            maxPosition:
              type: string
              example: '100.00000000'
        - type: object
          properties:
            filterType:
              type: string
              example: TRAILING_DELTA
            minTrailingAboveDelta:
              type: integer
              format: int64
              example: 10
            maxTrailingAboveDelta:
              type: integer
              format: int64
              example: 2000
            minTrailingBelowDelta:
              type: integer
              format: int64
              example: 10
            maxTrailingBelowDelta:
              type: integer
              format: int64
              example: 2000
        - type: object
          properties:
            filterType:
              type: string
              example: T_PLUS_SELL
            endTime:
              type: integer
              format: int64
              example: 1741672924895
        - type: object
          properties:
            filterType:
              type: string
              example: MAX_NUM_ORDER_LISTS
            maxNumOrderLists:
              type: integer
              format: int64
              example: 20
        - type: object
          properties:
            filterType:
              type: string
              example: MAX_NUM_ORDER_AMENDS
            maxNumOrderAmends:
              type: integer
              format: int64
              example: 10
      discriminator:
        propertyName: filterType
        mapping:
          PRICE_FILTER: '#/components/schemas/PriceFilter'
          PERCENT_PRICE: '#/components/schemas/PercentPriceFilter'
          PERCENT_PRICE_BY_SIDE: '#/components/schemas/PercentPriceBySideFilter'
          LOT_SIZE: '#/components/schemas/LotSizeFilter'
          MIN_NOTIONAL: '#/components/schemas/MinNotionalFilter'
          NOTIONAL: '#/components/schemas/NotionalFilter'
          ICEBERG_PARTS: '#/components/schemas/IcebergPartsFilter'
          MARKET_LOT_SIZE: '#/components/schemas/MarketLotSizeFilter'
          MAX_NUM_ORDERS: '#/components/schemas/MaxNumOrdersFilter'
          MAX_NUM_ALGO_ORDERS: '#/components/schemas/MaxNumAlgoOrdersFilter'
          MAX_NUM_ICEBERG_ORDERS: '#/components/schemas/MaxNumIcebergOrdersFilter'
          MAX_POSITION: '#/components/schemas/MaxPositionFilter'
          TRAILING_DELTA: '#/components/schemas/TrailingDeltaFilter'
          T_PLUS_SELL: '#/components/schemas/TPlusSellFilter'
          MAX_NUM_ORDER_LISTS: '#/components/schemas/MaxNumOrderListsFilter'
          MAX_NUM_ORDER_AMENDS: '#/components/schemas/MaxNumOrderAmendsFilter'
    assetFilters:
      oneOf:
        - type: object
          properties:
            filterType:
              type: string
              example: MAX_ASSET
            qtyExponent:
              type: integer
              example: 8
            limit:
              type: string
              example: '100.00000000'
            asset:
              type: string
              example: BNB
      discriminator:
        propertyName: filterType
        mapping:
          MAX_ASSET: '#/components/schemas/MaxAssetFilter'
    ExchangeMaxNumOrdersFilter:
      type: object
      properties:
        filterType:
          type: string
          example: EXCHANGE_MAX_NUM_ORDERS
        maxNumOrders:
          type: integer
          format: int64
          example: 1000
    ExchangeMaxNumAlgoOrdersFilter:
      type: object
      properties:
        filterType:
          type: string
          example: EXCHANGE_MAX_NUM_ALGO_ORDERS
        maxNumAlgoOrders:
          type: integer
          format: int64
          example: 200
    ExchangeMaxNumIcebergOrdersFilter:
      type: object
      properties:
        filterType:
          type: string
          example: EXCHANGE_MAX_NUM_ICEBERG_ORDERS
        maxNumIcebergOrders:
          type: integer
          format: int64
          example: 10
    ExchangeMaxNumOrderListsFilter:
      type: object
      properties:
        filterType:
          type: string
          example: EXCHANGE_MAX_NUM_ORDER_LISTS
        maxNumOrderLists:
          type: integer
          format: int64
          example: 20
    PriceFilter:
      type: object
      properties:
        filterType:
          type: string
          example: PRICE_FILTER
        priceExponent:
          type: integer
          example: 8
        minPrice:
          type: string
          example: '0.00000100'
        maxPrice:
          type: string
          example: '100000.00000000'
        tickSize:
          type: string
          example: '0.00000100'
    PercentPriceFilter:
      type: object
      properties:
        filterType:
          type: string
          example: PERCENT_PRICE
        multiplierExponent:
          type: integer
          example: 4
        multiplierUp:
          type: string
          example: '1.3000'
        multiplierDown:
          type: string
          example: '0.7000'
        avgPriceMins:
          type: integer
          example: 5
    PercentPriceBySideFilter:
      type: object
      properties:
        filterType:
          type: string
          example: PERCENT_PRICE_BY_SIDE
        multiplierExponent:
          type: integer
          example: 4
        bidMultiplierUp:
          type: string
          example: '1.2000'
        bidMultiplierDown:
          type: string
          example: '0.8000'
        askMultiplierUp:
          type: string
          example: '1.2000'
        askMultiplierDown:
          type: string
          example: '0.8000'
        avgPriceMins:
          type: integer
          example: 5
    LotSizeFilter:
      type: object
      properties:
        filterType:
          type: string
          example: LOT_SIZE
        qtyExponent:
          type: integer
          example: 8
        minQty:
          type: string
          example: '0.00010000'
        maxQty:
          type: string
          example: '100000.00000000'
        stepSize:
          type: string
          example: '0.00010000'
    MinNotionalFilter:
      type: object
      properties:
        filterType:
          type: string
          example: MIN_NOTIONAL
        priceExponent:
          type: integer
          example: 8
        minNotional:
          type: string
          example: '10.00000000'
        applyToMarket:
          type: boolean
          example: true
        avgPriceMins:
          type: integer
          example: 5
    NotionalFilter:
      type: object
      properties:
        filterType:
          type: string
          example: NOTIONAL
        priceExponent:
          type: integer
          example: 8
        minNotional:
          type: string
          example: '10.00000000'
        applyMinToMarket:
          type: boolean
          example: true
        maxNotional:
          type: string
          example: '100000.00000000'
        applyMaxToMarket:
          type: boolean
          example: false
        avgPriceMins:
          type: integer
          example: 5
    IcebergPartsFilter:
      type: object
      properties:
        filterType:
          type: string
          example: ICEBERG_PARTS
        limit:
          type: integer
          format: int64
          example: 10
    MarketLotSizeFilter:
      type: object
      properties:
        filterType:
          type: string
          example: MARKET_LOT_SIZE
        qtyExponent:
          type: integer
          example: 8
        minQty:
          type: string
          example: '0.00000000'
        maxQty:
          type: string
          example: '1000.00000000'
        stepSize:
          type: string
          example: '0.00000000'
    MaxNumOrdersFilter:
      type: object
      properties:
        filterType:
          type: string
          example: MAX_NUM_ORDERS
        maxNumOrders:
          type: integer
          format: int64
          example: 200
    MaxNumAlgoOrdersFilter:
      type: object
      properties:
        filterType:
          type: string
          example: MAX_NUM_ALGO_ORDERS
        maxNumAlgoOrders:
          type: integer
          format: int64
          example: 10
    MaxNumIcebergOrdersFilter:
      type: object
      properties:
        filterType:
          type: string
          example: MAX_NUM_ICEBERG_ORDERS
        maxNumIcebergOrders:
          type: integer
          format: int64
          example: 5
    MaxPositionFilter:
      type: object
      properties:
        filterType:
          type: string
          example: MAX_POSITION
        qtyExponent:
          type: integer
          example: 8
        maxPosition:
          type: string
          example: '100.00000000'
    TrailingDeltaFilter:
      type: object
      properties:
        filterType:
          type: string
          example: TRAILING_DELTA
        minTrailingAboveDelta:
          type: integer
          format: int64
          example: 10
        maxTrailingAboveDelta:
          type: integer
          format: int64
          example: 2000
        minTrailingBelowDelta:
          type: integer
          format: int64
          example: 10
        maxTrailingBelowDelta:
          type: integer
          format: int64
          example: 2000
    TPlusSellFilter:
      type: object
      properties:
        filterType:
          type: string
          example: T_PLUS_SELL
        endTime:
          type: integer
          format: int64
          example: 1741672924895
    MaxNumOrderListsFilter:
      type: object
      properties:
        filterType:
          type: string
          example: MAX_NUM_ORDER_LISTS
        maxNumOrderLists:
          type: integer
          format: int64
          example: 20
    MaxNumOrderAmendsFilter:
      type: object
      properties:
        filterType:
          type: string
          example: MAX_NUM_ORDER_AMENDS
        maxNumOrderAmends:
          type: integer
          format: int64
          example: 10
    MaxAssetFilter:
      type: object
      properties:
        filterType:
          type: string
          example: MAX_ASSET
        qtyExponent:
          type: integer
          example: 8
        limit:
          type: string
          example: '100.00000000'
        asset:
          type: string
          example: BNB
    rateLimits:
      type: object
      properties:
        rateLimitType:
          type: string
          example: REQUEST_WEIGHT
        interval:
          type: string
          example: MINUTE
        intervalNum:
          type: integer
          format: int64
          example: 1
        limit:
          type: integer
          format: int64
          example: 6000
        count:
          type: integer
          format: int64
          example: 321
    exchangeInfoResponse:
      type: object
      properties:
        timezone:
          type: string
          example: UTC
        serverTime:
          type: integer
          format: int64
          example: 1565246363776
        rateLimits:
          type: array
          items:
            type: object
            properties:
              rateLimitType:
                type: string
                example: REQUEST_WEIGHT
              interval:
                type: string
                example: MINUTE
              intervalNum:
                type: integer
                format: int64
                example: 1
              limit:
                type: integer
                format: int64
                example: 6000
              count:
                type: integer
                format: int64
                example: 321
        exchangeFilters:
          type: array
          items:
            oneOf:
              - type: object
                properties:
                  filterType:
                    type: string
                    example: EXCHANGE_MAX_NUM_ORDERS
                  maxNumOrders:
                    type: integer
                    format: int64
                    example: 1000
              - type: object
                properties:
                  filterType:
                    type: string
                    example: EXCHANGE_MAX_NUM_ALGO_ORDERS
                  maxNumAlgoOrders:
                    type: integer
                    format: int64
                    example: 200
              - type: object
                properties:
                  filterType:
                    type: string
                    example: EXCHANGE_MAX_NUM_ICEBERG_ORDERS
                  maxNumIcebergOrders:
                    type: integer
                    format: int64
                    example: 10
              - type: object
                properties:
                  filterType:
                    type: string
                    example: EXCHANGE_MAX_NUM_ORDER_LISTS
                  maxNumOrderLists:
                    type: integer
                    format: int64
                    example: 20
            discriminator:
              propertyName: filterType
              mapping:
                EXCHANGE_MAX_NUM_ORDERS: '#/components/schemas/ExchangeMaxNumOrdersFilter'
                EXCHANGE_MAX_NUM_ALGO_ORDERS: '#/components/schemas/ExchangeMaxNumAlgoOrdersFilter'
                EXCHANGE_MAX_NUM_ICEBERG_ORDERS: '#/components/schemas/ExchangeMaxNumIcebergOrdersFilter'
                EXCHANGE_MAX_NUM_ORDER_LISTS: '#/components/schemas/ExchangeMaxNumOrderListsFilter'
        symbols:
          type: array
          items:
            type: object
            properties:
              symbol:
                type: string
                example: ETHBTC
              status:
                type: string
                example: TRADING
              baseAsset:
                type: string
                example: ETH
              baseAssetPrecision:
                type: integer
                format: int64
                example: 8
              quoteAsset:
                type: string
                example: BTC
              quotePrecision:
                type: integer
                format: int64
                example: 8
              quoteAssetPrecision:
                type: integer
                format: int64
                example: 8
              baseCommissionPrecision:
                type: integer
                format: int64
                example: 8
              quoteCommissionPrecision:
                type: integer
                format: int64
                example: 8
              orderTypes:
                type: array
                items:
                  type: string
                  example: LIMIT
              icebergAllowed:
                type: boolean
                example: true
              ocoAllowed:
                type: boolean
                example: true
              otoAllowed:
                type: boolean
                example: true
              opoAllowed:
                type: boolean
                example: true
              quoteOrderQtyMarketAllowed:
                type: boolean
                example: true
              allowTrailingStop:
                type: boolean
                example: false
              cancelReplaceAllowed:
                type: boolean
                example: false
              amendAllowed:
                type: boolean
                example: false
              pegInstructionsAllowed:
                type: boolean
                example: true
              isSpotTradingAllowed:
                type: boolean
                example: true
              isMarginTradingAllowed:
                type: boolean
                example: true
              filters:
                type: array
                items:
                  oneOf:
                    - type: object
                      properties:
                        filterType:
                          type: string
                          example: PRICE_FILTER
                        priceExponent:
                          type: integer
                          example: 8
                        minPrice:
                          type: string
                          example: '0.00000100'
                        maxPrice:
                          type: string
                          example: '100000.00000000'
                        tickSize:
                          type: string
                          example: '0.00000100'
                    - type: object
                      properties:
                        filterType:
                          type: string
                          example: PERCENT_PRICE
                        multiplierExponent:
                          type: integer
                          example: 4
                        multiplierUp:
                          type: string
                          example: '1.3000'
                        multiplierDown:
                          type: string
                          example: '0.7000'
                        avgPriceMins:
                          type: integer
                          example: 5
                    - type: object
                      properties:
                        filterType:
                          type: string
                          example: PERCENT_PRICE_BY_SIDE
                        multiplierExponent:
                          type: integer
                          example: 4
                        bidMultiplierUp:
                          type: string
                          example: '1.2000'
                        bidMultiplierDown:
                          type: string
                          example: '0.8000'
                        askMultiplierUp:
                          type: string
                          example: '1.2000'
                        askMultiplierDown:
                          type: string
                          example: '0.8000'
                        avgPriceMins:
                          type: integer
                          example: 5
                    - type: object
                      properties:
                        filterType:
                          type: string
                          example: LOT_SIZE
                        qtyExponent:
                          type: integer
                          example: 8
                        minQty:
                          type: string
                          example: '0.00010000'
                        maxQty:
                          type: string
                          example: '100000.00000000'
                        stepSize:
                          type: string
                          example: '0.00010000'
                    - type: object
                      properties:
                        filterType:
                          type: string
                          example: MIN_NOTIONAL
                        priceExponent:
                          type: integer
                          example: 8
                        minNotional:
                          type: string
                          example: '10.00000000'
                        applyToMarket:
                          type: boolean
                          example: true
                        avgPriceMins:
                          type: integer
                          example: 5
                    - type: object
                      properties:
                        filterType:
                          type: string
                          example: NOTIONAL
                        priceExponent:
                          type: integer
                          example: 8
                        minNotional:
                          type: string
                          example: '10.00000000'
                        applyMinToMarket:
                          type: boolean
                          example: true
                        maxNotional:
                          type: string
                          example: '100000.00000000'
                        applyMaxToMarket:
                          type: boolean
                          example: false
                        avgPriceMins:
                          type: integer
                          example: 5
                    - type: object
                      properties:
                        filterType:
                          type: string
                          example: ICEBERG_PARTS
                        limit:
                          type: integer
                          format: int64
                          example: 10
                    - type: object
                      properties:
                        filterType:
                          type: string
                          example: MARKET_LOT_SIZE
                        qtyExponent:
                          type: integer
                          example: 8
                        minQty:
                          type: string
                          example: '0.00000000'
                        maxQty:
                          type: string
                          example: '1000.00000000'
                        stepSize:
                          type: string
                          example: '0.00000000'
                    - type: object
                      properties:
                        filterType:
                          type: string
                          example: MAX_NUM_ORDERS
                        maxNumOrders:
                          type: integer
                          format: int64
                          example: 200
                    - type: object
                      properties:
                        filterType:
                          type: string
                          example: MAX_NUM_ALGO_ORDERS
                        maxNumAlgoOrders:
                          type: integer
                          format: int64
                          example: 10
                    - type: object
                      properties:
                        filterType:
                          type: string
                          example: MAX_NUM_ICEBERG_ORDERS
                        maxNumIcebergOrders:
                          type: integer
                          format: int64
                          example: 5
                    - type: object
                      properties:
                        filterType:
                          type: string
                          example: MAX_POSITION
                        qtyExponent:
                          type: integer
                          example: 8
                        maxPosition:
                          type: string
                          example: '100.00000000'
                    - type: object
                      properties:
                        filterType:
                          type: string
                          example: TRAILING_DELTA
                        minTrailingAboveDelta:
                          type: integer
                          format: int64
                          example: 10
                        maxTrailingAboveDelta:
                          type: integer
                          format: int64
                          example: 2000
                        minTrailingBelowDelta:
                          type: integer
                          format: int64
                          example: 10
                        maxTrailingBelowDelta:
                          type: integer
                          format: int64
                          example: 2000
                    - type: object
                      properties:
                        filterType:
                          type: string
                          example: T_PLUS_SELL
                        endTime:
                          type: integer
                          format: int64
                          example: 1741672924895
                    - type: object
                      properties:
                        filterType:
                          type: string
                          example: MAX_NUM_ORDER_LISTS
                        maxNumOrderLists:
                          type: integer
                          format: int64
                          example: 20
                    - type: object
                      properties:
                        filterType:
                          type: string
                          example: MAX_NUM_ORDER_AMENDS
                        maxNumOrderAmends:
                          type: integer
                          format: int64
                          example: 10
                  discriminator:
                    propertyName: filterType
                    mapping:
                      PRICE_FILTER: '#/components/schemas/PriceFilter'
                      PERCENT_PRICE: '#/components/schemas/PercentPriceFilter'
                      PERCENT_PRICE_BY_SIDE: '#/components/schemas/PercentPriceBySideFilter'
                      LOT_SIZE: '#/components/schemas/LotSizeFilter'
                      MIN_NOTIONAL: '#/components/schemas/MinNotionalFilter'
                      NOTIONAL: '#/components/schemas/NotionalFilter'
                      ICEBERG_PARTS: '#/components/schemas/IcebergPartsFilter'
                      MARKET_LOT_SIZE: '#/components/schemas/MarketLotSizeFilter'
                      MAX_NUM_ORDERS: '#/components/schemas/MaxNumOrdersFilter'
                      MAX_NUM_ALGO_ORDERS: '#/components/schemas/MaxNumAlgoOrdersFilter'
                      MAX_NUM_ICEBERG_ORDERS: '#/components/schemas/MaxNumIcebergOrdersFilter'
                      MAX_POSITION: '#/components/schemas/MaxPositionFilter'
                      TRAILING_DELTA: '#/components/schemas/TrailingDeltaFilter'
                      T_PLUS_SELL: '#/components/schemas/TPlusSellFilter'
                      MAX_NUM_ORDER_LISTS: '#/components/schemas/MaxNumOrderListsFilter'
                      MAX_NUM_ORDER_AMENDS: '#/components/schemas/MaxNumOrderAmendsFilter'
              permissions:
                type: array
                items:
                  type: string
                  example: undefined
              permissionSets:
                type: array
                items:
                  type: array
                  items:
                    type: string
                    example: SPOT
              defaultSelfTradePreventionMode:
                type: string
                example: NONE
              allowedSelfTradePreventionModes:
                type: array
                items:
                  type: string
                  example: NONE
        sors:
          type: array
          description: 可选。仅当 SOR 可用时出现。
          items:
            type: object
            properties:
              baseAsset:
                type: string
                example: BTC
              symbols:
                type: array
                items:
                  type: string
                  example: BTCUSDT
