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

# Quote

This endpoint returns a live derived quote. Quotes are not persisted as entities.

For quoting semantics, see [Quote](/business/endpoint/quote).


## OpenAPI

````yaml get /v1/quote
openapi: 3.1.0
info:
  title: Fiet Trading API (Core)
  version: 0.1.0
  description: >
    Hosted control-plane API for the Fiet Interface.


    ## Non-custodial posture

    - This service **does not** sign transactions.

    - This service **does not** broadcast transactions.

    - This service has **no access** to customer funds or keys.


    ## Quote semantics

    `GET /v1/quote` returns **derived** values from live chain state and indexed
    markets.

    It does not create or persist a “quote entity”.
servers:
  - url: https://api.fiet.finance
    description: Production (example)
security:
  - basicAuth: []
tags:
  - name: Health
  - name: Markets
  - name: Quote
  - name: Swap
  - name: Payments
paths:
  /v1/quote:
    get:
      tags:
        - Quote
      summary: Get a live derived quote (not persisted)
      parameters:
        - name: chainId
          in: query
          required: true
          schema:
            $ref: '#/components/schemas/ChainId'
        - name: tokenIn
          in: query
          required: true
          schema:
            $ref: '#/components/schemas/EvmAddress'
        - name: tokenOut
          in: query
          required: true
          schema:
            $ref: '#/components/schemas/EvmAddress'
        - name: tradeType
          in: query
          required: true
          schema:
            type: string
            enum:
              - EXACT_IN
              - EXACT_OUT
        - name: amount
          in: query
          required: true
          schema:
            type: string
            description: >-
              Amount (smallest units) as string. Interpretation depends on
              tradeType.
        - name: slippageBps
          in: query
          required: false
          schema:
            type: integer
            minimum: 0
            maximum: 5000
            default: 50
      responses:
        '200':
          description: Quote
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Quote'
        '400':
          description: Bad request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Problem'
components:
  schemas:
    ChainId:
      type: integer
      format: uint64
      examples:
        - 1
    EvmAddress:
      type: string
      pattern: ^0x[a-fA-F0-9]{40}$
      examples:
        - '0x742d35Cc6634C0532925a3b844Bc9e7595f5fE4b'
    Quote:
      type: object
      required:
        - asOf
        - expiresAt
        - chainId
        - tokenIn
        - tokenOut
        - tradeType
        - amountIn
        - amountOut
      properties:
        asOf:
          $ref: '#/components/schemas/AsOf'
        expiresAt:
          type: string
          format: date-time
        chainId:
          $ref: '#/components/schemas/ChainId'
        tokenIn:
          $ref: '#/components/schemas/EvmAddress'
        tokenOut:
          $ref: '#/components/schemas/EvmAddress'
        tradeType:
          type: string
          enum:
            - EXACT_IN
            - EXACT_OUT
        amountIn:
          type: string
          description: Exact input amount (smallest units as a string)
          examples:
            - '1000000'
        amountOut:
          type: string
          description: Exact output amount (smallest units as a string)
          examples:
            - '999000'
        fees:
          type: object
          description: Fee breakdown (protocol, gas estimate, etc.)
          additionalProperties: true
        route:
          type: object
          description: Router/path details (implementation-defined)
          additionalProperties: true
    Problem:
      type: object
      required:
        - type
        - title
        - status
      properties:
        type:
          type: string
        title:
          type: string
        status:
          type: integer
        detail:
          type: string
    AsOf:
      type: object
      required:
        - timestamp
      properties:
        blockNumber:
          type: integer
          format: uint64
          description: Block number used for derivation (when available)
          examples:
            - 19500000
        timestamp:
          type: string
          format: date-time
          description: Timestamp for the derived response
  securitySchemes:
    basicAuth:
      type: http
      scheme: basic
      description: Basic Auth (assumed at gateway for MVP)

````