Binance Convert API

openapi: 3.1.0
info:
  title: Binance Algo Trading Account Convert API
  description: The Binance Algo Trading API provides access to algorithmic order execution strategies such as TWAP (Time-Weighted Average Price) and volume participation algorithms. Developers can place large orders that are automatically broken into smaller child orders and executed over time to minimize market impact.
  version: '1'
  contact:
    name: Binance Support
    url: https://www.binance.com/en/support
  termsOfService: https://www.binance.com/en/terms
servers:
- url: https://api.binance.com
  description: Production Server
security:
- apiKey: []
tags:
- name: Convert
  description: Cryptocurrency conversion quote and trade endpoints.
paths:
  /sapi/v1/convert/exchangeInfo:
    get:
      operationId: getExchangeInfo
      summary: List all convert pairs
      description: Query for all convertible token pairs and the tokens' respective upper/lower limits.
      tags:
      - Convert
      parameters:
      - name: fromAsset
        in: query
        schema:
          type: string
      - name: toAsset
        in: query
        schema:
          type: string
      - name: recvWindow
        in: query
        schema:
          type: integer
      - name: timestamp
        in: query
        required: true
        schema:
          type: integer
          format: int64
      - name: signature
        in: query
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                type: array
                items:
                  type: object
                  properties:
                    fromAsset:
                      type: string
                      description: Source asset.
                    toAsset:
                      type: string
                      description: Target asset.
                    fromAssetMinAmount:
                      type: string
                      description: Minimum from amount.
                    fromAssetMaxAmount:
                      type: string
                      description: Maximum from amount.
                    toAssetMinAmount:
                      type: string
                      description: Minimum to amount.
                    toAssetMaxAmount:
                      type: string
                      description: Maximum to amount.
      security:
      - apiKey: []
        hmacSignature: []
  /sapi/v1/convert/getQuote:
    post:
      operationId: sendQuoteRequest
      summary: Send quote request
      description: Request a quote for asset conversion. The quote is valid for a limited time.
      tags:
      - Convert
      parameters:
      - name: fromAsset
        in: query
        required: true
        schema:
          type: string
      - name: toAsset
        in: query
        required: true
        schema:
          type: string
      - name: fromAmount
        in: query
        description: Amount to convert from. Either fromAmount or toAmount required.
        schema:
          type: string
      - name: toAmount
        in: query
        description: Amount to convert to. Either fromAmount or toAmount required.
        schema:
          type: string
      - name: walletType
        in: query
        description: SPOT or FUNDING.
        schema:
          type: string
          enum:
          - SPOT
          - FUNDING
      - name: validTime
        in: query
        description: Quote validity period in seconds. 10s, 30s, or 120s.
        schema:
          type: string
          enum:
          - 10s
          - 30s
          - 120s
      - name: recvWindow
        in: query
        schema:
          type: integer
      - name: timestamp
        in: query
        required: true
        schema:
          type: integer
          format: int64
      - name: signature
        in: query
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                type: object
                properties:
                  quoteId:
                    type: string
                    description: Quote ID for accepting.
                  ratio:
                    type: string
                    description: Conversion ratio.
                  inverseRatio:
                    type: string
                    description: Inverse conversion ratio.
                  validTimestamp:
                    type: integer
                    format: int64
                    description: Quote validity timestamp.
                  toAmount:
                    type: string
                    description: Converted amount.
                  fromAmount:
                    type: string
                    description: Source amount.
      security:
      - apiKey: []
        hmacSignature: []
  /sapi/v1/convert/acceptQuote:
    post:
      operationId: acceptQuote
      summary: Accept quote
      description: Accept a previously requested quote to execute the conversion.
      tags:
      - Convert
      parameters:
      - name: quoteId
        in: query
        required: true
        description: Quote ID from the quote request.
        schema:
          type: string
      - name: recvWindow
        in: query
        schema:
          type: integer
      - name: timestamp
        in: query
        required: true
        schema:
          type: integer
          format: int64
      - name: signature
        in: query
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                type: object
                properties:
                  orderId:
                    type: string
                    description: Order ID.
                  createTime:
                    type: integer
                    format: int64
                    description: Order creation time.
                  orderStatus:
                    type: string
                    description: Order status. PROCESS, ACCEPT_SUCCESS, SUCCESS, FAIL.
      security:
      - apiKey: []
        hmacSignature: []
  /sapi/v1/convert/orderStatus:
    get:
      operationId: getOrderStatus
      summary: Order status
      description: Query conversion order status.
      tags:
      - Convert
      parameters:
      - name: orderId
        in: query
        required: true
        schema:
          type: string
      - name: recvWindow
        in: query
        schema:
          type: integer
      - name: timestamp
        in: query
        required: true
        schema:
          type: integer
          format: int64
      - name: signature
        in: query
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                type: object
                properties:
                  orderId:
                    type: integer
                    format: int64
                  orderStatus:
                    type: string
                  fromAsset:
                    type: string
                  fromAmount:
                    type: string
                  toAsset:
                    type: string
                  toAmount:
                    type: string
                  ratio:
                    type: string
                  inverseRatio:
                    type: string
                  createTime:
                    type: integer
                    format: int64
      security:
      - apiKey: []
        hmacSignature: []
  /sapi/v1/convert/tradeFlow:
    get:
      operationId: getTradeFlow
      summary: Get convert trade history
      description: Query conversion trade history.
      tags:
      - Convert
      parameters:
      - name: startTime
        in: query
        required: true
        schema:
          type: integer
          format: int64
      - name: endTime
        in: query
        required: true
        schema:
          type: integer
          format: int64
      - name: limit
        in: query
        schema:
          type: integer
          default: 100
          maximum: 1000
      - name: recvWindow
        in: query
        schema:
          type: integer
      - name: timestamp
        in: query
        required: true
        schema:
          type: integer
          format: int64
      - name: signature
        in: query
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                type: object
                properties:
                  list:
                    type: array
                    items:
                      type: object
                  startTime:
                    type: integer
                    format: int64
                  endTime:
                    type: integer
                    format: int64
                  limit:
                    type: integer
                  moreData:
                    type: boolean
      security:
      - apiKey: []
        hmacSignature: []
components:
  securitySchemes:
    apiKey:
      type: apiKey
      in: header
      name: X-MBX-APIKEY
    hmacSignature:
      type: apiKey
      in: query
      name: signature
externalDocs:
  description: Binance Algo Trading Documentation
  url: https://developers.binance.com/docs/algo/general-info