> ## Documentation Index
> Fetch the complete documentation index at: https://digraphsas-docs-cli.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Market price route

> Get a Market route from the Velora aggregator.

<Note>
  Looking for a single endpoint that returns either a Market route or a Delta
  intent? Call [`GET /v2/quote`](/api-reference/market/quote) with `mode=ALL`; see
  [Trading modes](/integrate/trading-modes).
</Note>


## OpenAPI

````yaml api-reference/specs/market.json GET /prices
openapi: 3.0.3
info:
  title: Velora Market API
  version: 1.0.0
  description: Velora Market API — direct aggregator pricing and Augustus calldata.
servers:
  - url: https://api.velora.xyz
    description: Production
security: []
externalDocs:
  description: Market — how it works (prices → calldata → broadcast).
  url: https://velora.xyz/docs/market/how-it-works
paths:
  /prices:
    get:
      summary: Get a Market route for a token pair
      operationId: marketPrices
      parameters:
        - name: srcToken
          in: query
          required: true
          schema:
            $ref: '#/components/schemas/Address'
          example: '0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE'
          description: >-
            Source token address. A token symbol listed in /tokens can be used
            instead. Example uses ETH.
        - name: srcDecimals
          in: query
          required: false
          schema:
            type: integer
          example: 18
          description: >-
            Source token decimals. Can be omitted if a token symbol is used in
            srcToken.
        - name: destToken
          in: query
          required: true
          schema:
            $ref: '#/components/schemas/Address'
          example: '0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48'
          description: >-
            Destination token address. A token symbol listed in /tokens can be
            used instead. Example uses USDC.
        - name: destDecimals
          in: query
          required: false
          schema:
            type: integer
          example: 6
          description: >-
            Destination token decimals. Can be omitted if a token symbol is used
            in destToken.
        - name: amount
          in: query
          required: true
          schema:
            $ref: '#/components/schemas/TokenAmount'
          example: '1000000000000000000'
          description: srcToken amount (SELL) or destToken amount (BUY), in WEI/raw units.
        - name: side
          in: query
          required: false
          schema:
            type: string
            enum:
              - SELL
              - BUY
            default: SELL
        - name: network
          in: query
          required: false
          schema:
            $ref: '#/components/schemas/ChainId'
          example: 1
          description: >-
            EVM chain ID. Default: 1 (Mainnet). Market uses `network` for this
            parameter; Delta uses `chainId` — both are EVM chain IDs.
        - name: otherExchangePrices
          in: query
          required: false
          schema:
            type: boolean
            default: false
          description: >-
            If true, the response includes price quotes from other exchanges in
            an `others` object.
        - name: includeDEXS
          in: query
          required: false
          schema:
            type: string
          description: Comma-separated list of DEXs to include.
        - name: excludeDEXS
          in: query
          required: false
          schema:
            type: string
          description: Comma-separated list of DEXs to exclude.
        - name: excludeRFQ
          in: query
          required: false
          schema:
            type: boolean
            default: false
          description: Exclude all RFQ liquidity from pricing.
        - name: includeContractMethods
          in: query
          required: false
          schema:
            type: string
          description: Comma-separated list of contract methods to include.
        - name: excludeContractMethods
          in: query
          required: false
          schema:
            type: string
          description: Comma-separated list of contract methods to exclude.
        - name: userAddress
          in: query
          required: false
          schema:
            $ref: '#/components/schemas/Address'
          example: '0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045'
          description: End-user wallet address.
        - name: route
          in: query
          required: false
          schema:
            type: string
          description: Dash-separated list of tokens for the price route. Max 4 tokens.
        - name: partner
          in: query
          required: false
          schema:
            type: string
            default: anon
          example: my-app-name
          description: >-
            Partner string. Defaults to `anon` which charges 1bps fee for all
            swaps.
        - name: maxImpact
          in: query
          required: false
          schema:
            type: number
          description: Bypass API price-impact check (default = 15%). Value in %.
        - name: receiver
          in: query
          required: false
          schema:
            $ref: '#/components/schemas/Address'
          description: >-
            Receiver wallet address. Omit when swapping from/to the same
            account.
        - name: srcTokenTransferFee
          in: query
          required: false
          schema:
            type: string
          description: Tax in basis points charged on srcToken transfers.
        - name: destTokenTransferFee
          in: query
          required: false
          schema:
            type: string
          description: Tax in basis points charged on destToken transfers.
        - name: srcTokenDexTransferFee
          in: query
          required: false
          schema:
            type: string
          description: Tax in BPS charged only on DEX swaps for srcToken.
        - name: destTokenDexTransferFee
          in: query
          required: false
          schema:
            type: string
          description: Tax in BPS charged only on DEX swaps for destToken.
        - name: version
          in: query
          required: false
          schema:
            type: string
            enum:
              - '5'
              - '6.2'
            default: '5'
          example: '6.2'
          description: >-
            Protocol version. Always pass `6.2` (Augustus v6.2, what these docs
            cover); when omitted the API falls back to the legacy v5 router.
        - name: excludeContractMethodsWithoutFeeModel
          in: query
          required: false
          schema:
            type: boolean
            default: false
          description: Exclude contract methods that don't support the fee model.
        - name: ignoreBadUsdPrice
          in: query
          required: false
          schema:
            type: boolean
            default: false
          description: Skip the USD-price availability check.
      responses:
        '200':
          description: >-
            Market route. Calldata-ready against Augustus v6.2 when
            `version=6.2`.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/MarketPricesResponse'
        '400':
          description: >-
            Invalid request. Documented examples: `InvalidInput`,
            `PricingError`.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '422':
          description: Unsupported chain or token.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '500':
          description: Internal server error.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
components:
  schemas:
    Address:
      type: string
      description: >-
        EVM address (20 bytes, hex-encoded with `0x` prefix). Use the mixed-case
        placeholder `0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE` for native ETH.
      pattern: ^0x[a-fA-F0-9]{40}$
      example: '0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045'
    TokenAmount:
      type: string
      description: >-
        Token amount in WEI / raw units (no decimal point). Serialized as a
        string to preserve precision for amounts that exceed JavaScript Number
        range.
      example: '1000000000000000000'
    ChainId:
      type: integer
      description: >-
        EVM chain ID. Supported values today include 1 (Mainnet), 10 (Optimism),
        56 (BSC), 137 (Polygon), 8453 (Base), 42161 (Arbitrum), 43114
        (Avalanche), 100 (Gnosis). The set is open — call GET /chains for the
        live list.
      example: 1
    MarketPricesResponse:
      type: object
      description: GET /prices envelope.
      properties:
        priceRoute:
          $ref: '#/components/schemas/MarketPriceRoute'
    ErrorResponse:
      type: object
      description: Standard Velora error envelope.
      required:
        - errorType
      properties:
        errorType:
          $ref: '#/components/schemas/ErrorCode'
        details:
          type: string
          description: Human-readable description of the failure.
      example:
        errorType: PricingError
        details: Error getting price data
    MarketPriceRoute:
      type: object
      description: >-
        Market route block. Calldata-ready against Augustus v6.2 when
        `version=6.2`.
      properties:
        blockNumber:
          type: integer
        network:
          $ref: '#/components/schemas/ChainId'
        srcToken:
          $ref: '#/components/schemas/Address'
        srcDecimals:
          type: integer
        srcAmount:
          $ref: '#/components/schemas/TokenAmount'
        destToken:
          $ref: '#/components/schemas/Address'
        destDecimals:
          type: integer
        destAmount:
          $ref: '#/components/schemas/TokenAmount'
        bestRoute:
          type: array
          items:
            type: object
        gasCostUSD:
          type: string
        gasCost:
          type: string
        side:
          type: string
          enum:
            - SELL
            - BUY
        version:
          type: string
        contractAddress:
          $ref: '#/components/schemas/Address'
        tokenTransferProxy:
          $ref: '#/components/schemas/Address'
        contractMethod:
          type: string
        partnerFee:
          type: number
        srcUSD:
          type: string
        destUSD:
          type: string
        partner:
          type: string
        maxImpactReached:
          type: boolean
        hmac:
          type: string
    ErrorCode:
      type: string
      description: >-
        Documented Velora error code (e.g. `PricingError`, `InvalidInput`,
        `UnsupportedChain`, `StalePriceRoute`, `InvalidSignature`). The set is
        open — handle codes you recognize and fall back to a generic error path
        for everything else. See /api-reference/troubleshooting for known codes.
      example: PricingError

````