> ## 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 Delta prices

> Recommended route plus alternatives for a same-chain or crosschain Delta V2 swap.



## OpenAPI

````yaml api-reference/specs/delta-v2.json GET /v2/delta/prices
openapi: 3.0.3
info:
  title: Velora Delta API V2
  version: 2.0.0
  description: >-
    Velora Delta API V2 — server-built EIP-712 orders, route-based pricing with
    alternatives, paginated order history, and a unified status model. Ships
    alongside Delta V1; both protocols share the same on-chain contracts.
servers:
  - url: https://api.velora.xyz
    description: Production
security: []
paths:
  /v2/delta/prices:
    get:
      summary: Get a Delta V2 price (same-chain or crosschain)
      description: >-
        Returns a recommended `route` plus `alternatives` (up to a few bridge
        options for crosschain). Pass the returned `route` and `side` verbatim
        to `POST /v2/delta/orders/build`.
      operationId: deltaV2Prices
      parameters:
        - name: chainId
          in: query
          required: true
          schema:
            type: integer
            example: 1
          description: >-
            Source chain ID. Supported: 1, 10, 56, 100, 130, 137, 8453, 42161,
            43114.
        - name: srcToken
          in: query
          required: true
          schema:
            type: string
            example: '0x6B175474E89094C44Da98b954EedeAC495271d0F'
        - name: destToken
          in: query
          required: true
          schema:
            type: string
            example: '0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48'
          description: >-
            Destination token. For crosschain quotes, the destination token on
            `destChainId`.
        - name: amount
          in: query
          required: true
          schema:
            type: string
            example: '1000000000000000000'
          description: >-
            Source amount (SELL) or destination amount (BUY), in raw token
            units.
        - name: srcDecimals
          in: query
          required: true
          schema:
            type: integer
            example: 18
        - name: destDecimals
          in: query
          required: true
          schema:
            type: integer
            example: 6
        - name: side
          in: query
          required: false
          schema:
            type: string
            enum:
              - SELL
              - BUY
            default: SELL
        - name: destChainId
          in: query
          required: false
          schema:
            type: integer
          description: Omit for same-chain. When set, response `route.bridge` is populated.
        - name: userAddress
          in: query
          required: false
          schema:
            type: string
        - name: beneficiary
          in: query
          required: false
          schema:
            type: string
          description: >-
            Address that receives the destination token. Defaults to
            `userAddress`.
        - name: partner
          in: query
          required: false
          schema:
            type: string
            default: anon
            example: my-app-name
          description: Partner key. Defaults to `anon` (1bps fee).
        - name: partnerFeeBps
          in: query
          required: false
          schema:
            type: integer
            minimum: 0
            maximum: 200
          description: Override partner fee in basis points (max 200 = 2%).
        - name: maxImpact
          in: query
          required: false
          schema:
            type: number
          description: Maximum price impact in % (default 15).
        - name: maxUSDImpact
          in: query
          required: false
          schema:
            type: number
          description: Maximum price impact in USD.
        - name: includeAgents
          in: query
          required: false
          schema:
            type: string
          description: Comma-separated list of agent names to include.
        - name: excludeAgents
          in: query
          required: false
          schema:
            type: string
          description: Comma-separated list of agent names to exclude.
        - name: includeBridges
          in: query
          required: false
          schema:
            type: string
          description: Comma-separated bridge protocol names to include (crosschain only).
        - name: excludeBridges
          in: query
          required: false
          schema:
            type: string
          description: Comma-separated bridge protocol names to exclude.
        - name: allowBridgeAndSwap
          in: query
          required: false
          schema:
            type: boolean
            default: true
          description: >-
            Allow combining bridge + on-chain swap. Forced to `false` for BUY
            side.
      responses:
        '200':
          description: Recommended route plus alternatives.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PriceV2'
        '400':
          description: Invalid parameters or no route
        '422':
          description: Unsupported chain or token
components:
  schemas:
    PriceV2:
      type: object
      properties:
        id:
          type: string
          description: Request id (echo for support tickets).
        side:
          type: string
          enum:
            - SELL
            - BUY
        inputToken:
          $ref: '#/components/schemas/Token'
        outputToken:
          $ref: '#/components/schemas/Token'
        route:
          $ref: '#/components/schemas/Route'
        alternatives:
          type: array
          items:
            $ref: '#/components/schemas/Route'
          description: Up to N additional routes (crosschain only).
        partner:
          type: object
          properties:
            name:
              type: string
            feePercent:
              type: number
              description: Resolved partner fee in percent (0.05 = 0.05%).
        spender:
          type: string
          description: Delta contract address; approve this as ERC-20 spender.
    Token:
      type: object
      properties:
        chainId:
          type: integer
        address:
          type: string
    Route:
      type: object
      properties:
        origin:
          $ref: '#/components/schemas/RouteStep'
        destination:
          $ref: '#/components/schemas/RouteStep'
        bridge:
          $ref: '#/components/schemas/RouteBridge'
        fees:
          type: object
          properties:
            gas:
              $ref: '#/components/schemas/TokenAmount'
            bridge:
              type: array
              items:
                $ref: '#/components/schemas/TokenAmount'
    RouteStep:
      type: object
      properties:
        input:
          $ref: '#/components/schemas/TokenAmount'
        output:
          $ref: '#/components/schemas/TokenAmount'
    RouteBridge:
      type: object
      nullable: true
      properties:
        protocol:
          type: string
        estimatedTimeMs:
          type: integer
        tags:
          type: array
          items:
            type: string
            enum:
              - recommended
              - fastest
              - best-return
        contractParams:
          type: object
          properties:
            protocolSelector:
              type: string
            outputToken:
              type: string
            scalingFactor:
              type: integer
            protocolData:
              type: string
    TokenAmount:
      type: object
      properties:
        token:
          $ref: '#/components/schemas/Token'
        amount:
          type: string
        amountUSD:
          type: string

````