DODO Trade / Route API

openapi: 3.1.0
x-apievangelist-generated: '2026-07-18'
x-apievangelist-method: generated
x-apievangelist-source: https://github.com/DODOEX/docs/blob/master/docs/tradeApi.md
info:
  title: DODO Trade / Route API
  version: 1.0.0
  description: >-
    The DODO Trade API (also called the DODO Route API) provides real-time price
    quotes for swaps between arbitrary tokens across supported EVM chains, plus the
    ABI calldata needed to execute the swap on-chain against the DODORouteProxy /
    DODOV2Proxy contracts. It compares prices across a range of liquidity sources
    (DODO v1, DODO v2, 1inch, 0x, ParaSwap, professional market makers, and DODO's
    own aggregation algorithm). This OpenAPI is generated faithfully from DODO's
    published tradeApi.md documentation; DODO does not publish an OpenAPI of its own.
    Current production access via the DODO Developer Portal requires an API key passed
    as the `apikey` query parameter.
  contact:
    name: DODO Developer Docs
    url: https://docs.dodoex.io/en/developer
  x-supported-chains:
    "1": Ethereum Mainnet
    "56": BNB Smart Chain
    "66": OKExChain (OEC)
    "128": Huobi ECO Chain (HECO)
    "137": Polygon
    "288": Boba
    "1285": MoonRiver
    "1313161554": Aurora
    "42161": Arbitrum One
    "43114": Avalanche
servers:
  - url: https://route-api.dodoex.io
    description: DODO Route API production host
security:
  - apiKeyQuery: []
paths:
  /dodoapi/getdodoroute:
    get:
      operationId: getDodoRoute
      summary: Get a swap route quote
      description: >-
        Returns a real-time price quote and executable ABI calldata for swapping
        `fromAmount` of `fromTokenAddress` into `toTokenAddress` on the given chain,
        routed across DODO's aggregated liquidity sources. Use the native token
        sentinel address 0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE for ETH/BNB/MATIC.
      tags:
        - Trade
      parameters:
        - name: fromTokenAddress
          in: query
          required: true
          description: Contract address of the token to sell (native sentinel for ETH/BNB/MATIC).
          schema:
            type: string
        - name: fromTokenDecimals
          in: query
          required: true
          description: Decimals of the token to sell.
          schema:
            type: integer
        - name: toTokenAddress
          in: query
          required: true
          description: Contract address of the token to buy (native sentinel for ETH/BNB/MATIC).
          schema:
            type: string
        - name: toTokenDecimals
          in: query
          required: true
          description: Decimals of the token to buy.
          schema:
            type: integer
        - name: fromAmount
          in: query
          required: true
          description: 'Amount of the token to sell, expressed with decimals (e.g. 1 ETH = 10**18).'
          schema:
            type: string
        - name: slippage
          in: query
          required: true
          description: Allowed slippage, 0-100 (unit percent).
          schema:
            type: integer
        - name: userAddr
          in: query
          required: true
          description: User wallet address that will execute the swap.
          schema:
            type: string
        - name: chainId
          in: query
          required: true
          description: >-
            Chain id: 1 Ethereum, 56 BSC, 66 OEC, 128 HECO, 137 Polygon,
            42161 Arbitrum One, 1285 MoonRiver, 1313161554 Aurora, 288 Boba, 43114 Avalanche.
          schema:
            type: integer
        - name: rpc
          in: query
          required: true
          description: Your own RPC node URL used for on-chain reads.
          schema:
            type: string
        - name: deadLine
          in: query
          required: false
          description: Unix timestamp (seconds) of the trade deadline block.
          schema:
            type: integer
        - name: source
          in: query
          required: false
          description: >-
            Restrict liquidity sources. If blank, all sources are quoted; set to
            "dodo" to quote DODO v1 and DODO v2 only.
          schema:
            type: string
      responses:
        '200':
          description: A route quote with executable ABI calldata.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/RouteResponse'
              example:
                status: 200
                data:
                  resAmount: 4131.964781
                  resPricePerToToken: 0.24201566131747518
                  resPricePerFromToken: 4.131964
                  priceImpact: 0
                  useSource: '0x'
                  targetDecimals: 6
                  targetApproveAddr: '0xCB859eA579b28e02B87A1FDE08d087ab9dbE5149'
                  to: '0xa356867fDCEa8e71AEaF87805808803806231FdC'
                  data: ''
                  resCostGas: 0
        '4XX':
          description: Client error. The `status` field in the envelope carries a non-200 code.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '5XX':
          description: Server error. The `status` field in the envelope carries a non-200 code.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
components:
  securitySchemes:
    apiKeyQuery:
      type: apiKey
      in: query
      name: apikey
      description: >-
        API key issued by the DODO Developer Portal (https://docs.dodoex.io/en/developer),
        passed as the `apikey` query parameter on production Route API requests.
  schemas:
    RouteResponse:
      type: object
      properties:
        status:
          type: integer
          description: Application status code; 200 indicates success.
        data:
          $ref: '#/components/schemas/RouteData'
    RouteData:
      type: object
      properties:
        resAmount:
          type: number
          description: Receive amount (not including the token's decimals).
        resPricePerToToken:
          type: number
          description: Ratio of sell token amount to buy token amount.
        resPricePerFromToken:
          type: number
          description: Ratio of buy token amount to sell token amount.
        priceImpact:
          type: number
          description: Price deviation; multiply by 100 for a percentage.
        useSource:
          type: string
          description: The liquidity source selected for the quote.
        targetDecimals:
          type: integer
          description: Decimals of the target token.
        targetApproveAddr:
          type: string
          description: DODOApprove contract to grant the sell token allowance to before swapping; empty when selling the native token.
        to:
          type: string
          description: DODOV2Proxy or DODORouteProxy contract address to send the transaction to.
        data:
          type: string
          description: ABI calldata to submit directly on-chain.
        resCostGas:
          type: number
          description: Estimated gas cost.
    ErrorResponse:
      type: object
      properties:
        status:
          type: integer
          description: Non-200 application status code indicating the error class.
        data:
          type: object
          description: Optional error detail payload.