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

# Get Quote

> GET /api/v1/quote — Get the best swap route and estimated output for a token pair.



## OpenAPI

````yaml GET /api/v1/quote
openapi: 3.1.0
info:
  title: Argyros API
  description: >-
    Swap aggregator API on Fogo. Get quotes, build swap transactions, and
    retrieve raw instructions for multi-hop token swaps across Vortex, Fluxbeam,
    Fogo.fun, and Moonit. Solana support coming soon.
  version: 1.0.0
  contact:
    name: Argyros
    url: https://argyros.finance
servers:
  - url: https://api.argyros.xyz
    description: Production
security: []
paths:
  /api/v1/quote:
    get:
      tags:
        - Quote
      summary: Get swap quote
      description: >-
        Calculate the best swap route and estimated output for a token pair.
        Supports ExactIn (specify input, estimate output) and ExactOut (specify
        output, estimate input) modes. Returns routing details including
        multi-hop paths, price impact, and fee breakdown.
      operationId: getQuote
      parameters:
        - name: inputMint
          in: query
          required: true
          description: Input token mint address (Solana base58 public key).
          schema:
            type: string
            example: So11111111111111111111111111111111111111112
        - name: outputMint
          in: query
          required: true
          description: Output token mint address (Solana base58 public key).
          schema:
            type: string
            example: uSd2czE61Evaf76RNbq4KPpXnkiL3irdzgLFUMe3NoG
        - name: amount
          in: query
          required: true
          description: >-
            Amount in smallest token units (lamports for SOL, base units for SPL
            tokens). For SOL with 9 decimals: 1000000000 = 1 SOL.
          schema:
            type: string
            example: '1000000000'
        - name: swapMode
          in: query
          required: true
          description: >-
            How the amount is interpreted. `ExactIn`: amount is exact input,
            output is estimated. `ExactOut`: amount is exact desired output,
            input is estimated.
          schema:
            type: string
            enum:
              - ExactIn
              - ExactOut
            example: ExactIn
        - name: slippageBps
          in: query
          required: false
          description: >-
            Slippage tolerance in basis points (1 bps = 0.01%). Defaults to 50
            (0.5%). Common values: 10 (0.1%), 50 (0.5%), 100 (1%), 300 (3%).
          schema:
            type: integer
            default: 50
            example: 50
      responses:
        '200':
          description: Quote calculated successfully.
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    example: true
                  data:
                    $ref: '#/components/schemas/QuoteResponse'
        '400':
          description: Invalid request parameters.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '404':
          description: No route found for the given token pair and amount.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
components:
  schemas:
    QuoteResponse:
      type: object
      description: Swap quote with routing and price impact details.
      properties:
        inputMint:
          type: string
          example: So11111111111111111111111111111111111111112
        outputMint:
          type: string
          example: uSd2czE61Evaf76RNbq4KPpXnkiL3irdzgLFUMe3NoG
        amountIn:
          type: string
          description: Input amount in smallest token units.
          example: '1000000000'
        amountOut:
          type: string
          description: Output amount in smallest token units.
          example: '145320000'
        priceImpactBps:
          type: integer
          description: Price impact in basis points.
          example: 25
        priceImpactPercent:
          type: string
          description: Human-readable price impact percentage.
          example: 0.25%
        priceImpactSeverity:
          type: string
          enum:
            - none
            - low
            - moderate
            - high
            - extreme
          description: >-
            Price impact severity: none (<0.1%), low (0.1-1%), moderate (1-3%),
            high (3-5%), extreme (>5%).
          example: low
        priceImpactWarning:
          type: string
          description: Warning message about price impact. Empty if negligible.
          example: Price impact is low
        feeBps:
          type: integer
          description: Total fee in basis points across all hops.
          example: 25
        routes:
          type: array
          items:
            $ref: '#/components/schemas/RouteInfo'
          description: Detailed information about each hop in the route.
        routePath:
          type: array
          items:
            type: string
          description: >-
            Token path from input to output. Direct: [inputMint, outputMint].
            Multi-hop: [inputMint, ...intermediates, outputMint].
          example:
            - So11111111111111111111111111111111111111112
            - uSd2czE61Evaf76RNbq4KPpXnkiL3irdzgLFUMe3NoG
        hopCount:
          type: integer
          description: Number of swap hops. 1 = direct, 2+ = multi-hop.
          example: 1
        otherAmountThreshold:
          type: string
          description: >-
            Slippage-adjusted threshold. ExactIn: minimum output. ExactOut:
            maximum input.
          example: '144593400'
      required:
        - inputMint
        - outputMint
        - amountIn
        - amountOut
        - priceImpactBps
        - priceImpactPercent
        - priceImpactSeverity
        - feeBps
        - routes
        - routePath
        - hopCount
        - otherAmountThreshold
    ErrorResponse:
      type: object
      properties:
        success:
          type: boolean
          example: false
        error:
          type: string
          example: no route found
      required:
        - success
        - error
    RouteInfo:
      type: object
      description: A single hop in the swap route.
      properties:
        poolAddress:
          type: string
          description: Pool address used for this hop.
          example: HJPjoWUrhoZzkNfRpHuieeFk9WcZWjwy6PBjZ81ngndJ
        poolType:
          type: string
          description: Liquidity pool type (Raydium, Orca, Meteora, PumpFun, Moonit, etc.).
          example: Raydium
        percent:
          type: integer
          description: >-
            Percentage of swap amount routed through this pool. 100 for single
            route.
          example: 100
        inputMint:
          type: string
          description: Input token mint for this hop.
          example: So11111111111111111111111111111111111111112
        outputMint:
          type: string
          description: Output token mint for this hop.
          example: uSd2czE61Evaf76RNbq4KPpXnkiL3irdzgLFUMe3NoG
      required:
        - poolAddress
        - poolType
        - percent
        - inputMint
        - outputMint

````