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

# Build a swap (/swap)

> The same handler as `POST /swap-instructions`: same body, same response. Unlike Jupiter's
`/swap`, the transaction is **not** serialized unless you send `serialize: true`; then the
response carries `swapTransaction` (base64, unsigned v1) and `lastValidBlockHeight` next to
the instructions. Decode it, sign the message with `userPublicKey`, and send it yourself.


The same handler as [`POST /swap-instructions`](https://docs.raze.bot/api-reference/router/swap-instructions), under Jupiter's path name.

> [!WARNING]
>
> Unlike Jupiter's `/swap`, it returns instructions and **no** `swapTransaction` unless the body sets `"serialize": true`.


## OpenAPI

````yaml router.openapi.yaml POST /swap
openapi: 3.1.0
info:
  title: Raze Swap Router API
  version: 1.0.0
  description: >
    Quotes and **unsigned** transactions for swaps on Solana, routed through a
    deploy of the `swap`

    program over the venues `GET /venues` lists as `buildable` and `servable`,
    and, under `/evm`, on

    Ethereum, BNB Chain, Base and Robinhood Chain (see **EVM routes** below).
    The router **never

    signs and never sends**: you get a quote, then the instructions (or a
    serialized, unsigned

    transaction), and you sign and broadcast from your backend.


    **Public router.** `https://router.raze.bot` is Raze's router. It takes the
    same **API key** as

    the market-data API (`x-api-key`, `Authorization: Bearer` or `?apiKey=`;
    only `/health`,

    `/ready`, `/evm/health` and `/evm/ready` are open), shares the account's
    limit a

    minute with it and spends credits for each request it lets in. Its Solana
    routes have no path

    prefix (`/quote`, `/swap-instructions`, …),

    issues no `routeTicket`, and builds for Raze's deploy of the `swap` program,

    `DADMMjfNnY6z8H9h9RfHZ9tfarBySsj4Yb65qLyKJDAD`. A missing or unknown key
    answers `401` and a

    request over the limit `429`, both with the API's body,

    `{"error": {"code": "unauthorized" | "rate_limited", "message"}}`.


    **EVM routes (`/evm`).** The same host quotes and builds swaps on Ethereum
    (`eth`, chain id 1),

    BNB Chain (`bsc`, 56), Base (`base`, 8453) and Robinhood Chain (`robinhood`,
    4663), over Uniswap

    V2 and V3 (eth, base, robinhood) and PancakeSwap V2 and V3 (bsc): `GET` and
    `POST /evm/quote`,

    `POST /evm/swap` (alias `POST /evm/swap-instructions`), `GET /evm/venues`,
    `GET /evm/chains`,

    and the open `GET /evm/health` and `GET /evm/ready`. Same key, same rate a
    second, same

    credits. They speak the Solana routes' API, so Jupiter's: the same parameter
    and field names

    (`inputMint`, `outputMint`, `amount`, `slippageBps`, `routePlan`,
    `otherAmountThreshold`,

    `quoteResponse`, `userPublicKey`, …), the conventions and the error shape
    below, `404 not_found`

    for an unknown path (`/evm/build` and `/evm/deployments` are gone) and `405`
    with `Allow` for a

    wrong method. What differs, because EVM does:

    - `chain` is required: `eth`, `bsc`, `base`, `robinhood` or the chain id
    (alias `chainId`).

    - Mints and wallets are `0x` addresses in any case (answers are lower case);
    the native coin is
      `0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE` (or `native`). Inside a `routePlan` the wrapped
      token stands for it.
    - Amounts are uint256 in base units: decimal strings of any size, or JSON
    integers up to
      2^64 − 1. `contextSlot` is the block number.
    - ExactIn only (`ExactOut` is `400`), `maxHops` at most 3 (default 2), one
    venue per route, no
      split, no platform fee (`platformFeeBps` or `feeBps` above 0 is `400`, not ignored).
    - The build returns unsigned transactions instead of instructions:
    `setupTransactions` (the
      approvals), then `swapTransaction`, simulated together, that you sign and send in order from
      your own RPC. It builds only a quote this router made and still holds (`quoteResponse.quoteId`),
      and a `quoteResponse` that says otherwise about it is `400 quote_mismatch`.
    - Errors carry no `quoteId`. A request is cut at 10 seconds (`503 rpc`,
    `request_timeout`).


    **One router, one `swap` deploy.** A router builds for the program address
    in its

    `ROUTER_SWAP_PROGRAM_ID` (the `programId` of every `swapInstruction` is that
    address) and

    reads that deploy's on-chain config: a venue the config has no live row for
    is never served,

    and while the config is paused every build answers `503`. A client with its
    own deploy runs

    its own router: it has no keys, no accounts and no rate limit and listens on
    loopback by

    default (`ROUTER_LISTEN`), so keep it behind your own gateway.


    **Conventions of the Solana routes:**

    - Amounts are integers in the token's base units (lamports, atoms). In
    quotes and builds the
      u64 amounts are decimal **strings** (`inAmount`, `outAmount`, `otherAmountThreshold`,
      `swapInfo.inAmount` / `outAmount`, `platformFee.amount`, every `costs.*Lamports*` field).
      `slippageBps`, `contextSlot`, `minReturn`, `maxAmountIn`, `computeUnits`,
      `loadedAccountsDataSize`, `lastValidBlockHeight` and every `transactionConfig` field are JSON
      numbers.
    - Mints and wallets are base58 addresses; wrapped SOL is
    `So11111111111111111111111111111111111111112`.

    - Venue labels (`label`, `dexes`, `excludeDexes`) are the `dex` names of
    `GET /venues`; input
      labels match case- and punctuation-insensitively, aliases included.
    - Request bodies are read as JSON whatever the `Content-Type`; at most 256
    KiB (larger is `413`).

    - Unknown fields and query parameters are ignored, not rejected.


    **Solana transactions are v1** (SIMD-0385, prefix `0x81`, up to 4,096 bytes
    and 64 account keys, no

    address lookup tables). The compute-unit limit, loaded-accounts limit and
    priority fee travel in

    the message header (`transactionConfig`), not as ComputeBudget instructions.
    Signing a v1

    transaction needs an SDK that supports it. `txVersion: 0` and
    `asLegacyTransaction: true` are

    refused.


    **Errors** of the Solana routes are `{"error", "reason", "quoteId"}`:
    `error` is a closed code, `reason` a label or a

    sentence, `quoteId` present once the request was parsed. The status says
    whose move it is:

    `400` fix the request, `404` no route exists (or an unknown path:
    `not_found`), `409` re-quote

    or retry later, `413` too large, `422` a named decline that waiting will not
    change, `500` a

    router bug, `503` not ready: retry with backoff. Two bodies differ:
    `not_ready` carries

    `reasons` (a list) instead of `reason`, and a `low_liquidity` decline adds
    `liquidity`. A known

    path with the wrong method (`GET /swap`) is `405` with an empty body and an
    `Allow` header.


    The Solana quote and swap fields mirror Jupiter's Swap API (Metis), so most
    clients change only the

    host; differences are listed on each operation.
servers:
  - url: https://router.raze.bot
    description: Raze's public router (API key)
security:
  - ApiKeyHeader: []
  - Bearer: []
  - ApiKeyQuery: []
tags:
  - name: ops
    description: Liveness and readiness
  - name: venues
    description: The venues this router knows, and the price oracle's verdict on each
  - name: swap
    description: Quote, then build the instructions or the unsigned transaction
  - name: transactions
    description: Serialize your own instructions as an unsigned v1 transaction
  - name: EVM swap
    description: >-
      Quote and build swaps on Ethereum, BNB Chain, Base and Robinhood Chain,
      under /evm
  - name: EVM catalog
    description: The EVM chains, their policy and the venue manifest
  - name: EVM ops
    description: Liveness and readiness of the EVM routes
paths:
  /swap:
    post:
      tags:
        - swap
      summary: Build the swap (alias of /swap-instructions)
      description: >
        The same handler as `POST /swap-instructions`: same body, same response.
        Unlike Jupiter's

        `/swap`, the transaction is **not** serialized unless you send
        `serialize: true`; then the

        response carries `swapTransaction` (base64, unsigned v1) and
        `lastValidBlockHeight` next to

        the instructions. Decode it, sign the message with `userPublicKey`, and
        send it yourself.
      operationId: buildSwap
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/SwapRequest'
            example:
              userPublicKey: 9WzDXwBbmkg8ZTbNMqUxvQRAyrZzDsGYdLVL9zYtAWWM
              quoteResponse:
                inputMint: So11111111111111111111111111111111111111112
                inAmount: '100000000'
                outputMint: EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v
                outAmount: '11769095'
                otherAmountThreshold: '11710249'
                swapMode: ExactIn
                slippageBps: 50
                priceImpactPct: '0'
                routePlan:
                  - swapInfo:
                      ammKey: HTvjzsfX3yU6BUodCjZ5vZkUrAxMDTrBs3CJaq43ashR
                      label: Meteora DLMM
                      inputMint: So11111111111111111111111111111111111111112
                      outputMint: EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v
                      inAmount: '100000000'
                      outAmount: '11769095'
                      walkSteps: 1
                    percent: 100
                    bps: 10000
                contextSlot: 452409471
                timeTaken: 0.000367825
                quoteId: 23e14e01000044c6
              serialize: true
              prioritizationFeeLamports: auto
      responses:
        '200':
          description: The instructions and, with `serialize`, the unsigned transaction
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SwapResponse'
              examples:
                built:
                  $ref: '#/components/examples/SwapBuilt'
        '400':
          $ref: '#/components/responses/SwapBadRequest'
        '404':
          $ref: '#/components/responses/NoRoute'
        '409':
          $ref: '#/components/responses/SwapConflict'
        '413':
          $ref: '#/components/responses/TooLarge'
        '422':
          $ref: '#/components/responses/SwapDeclined'
        '500':
          $ref: '#/components/responses/Internal'
        '503':
          $ref: '#/components/responses/SwapNotReady'
components:
  schemas:
    SwapRequest:
      type: object
      required:
        - userPublicKey
      properties:
        userPublicKey:
          type: string
          description: >-
            The wallet that signs and pays: fee payer, source of the input,
            owner of every intermediate account. Alias `wallet`
        quoteResponse:
          $ref: '#/components/schemas/QuoteResponse'
          description: >-
            A quote to build as it is (no re-quote). Takes precedence over
            `routeTicket` and the pair fields
        routeTicket:
          type: string
          description: >-
            The `routeTicket` of a quote, instead of `quoteResponse`. A router
            without tickets (the public one) answers `400 invalid_route_ticket`
        inputMint:
          type: string
          description: >-
            Pair mode (no quote): the mint you spend. With a quote or ticket, if
            present, must match it
        outputMint:
          type: string
          description: >-
            Pair mode: the mint you receive. With a quote or ticket, if present,
            must match it
        amount:
          type:
            - string
            - integer
          description: >-
            Pair mode: u64 amount, as in `/quote`. With a ticket, if present,
            must match it
        swapMode:
          type: string
          enum:
            - ExactIn
            - ExactOut
            - exactIn
            - exactOut
          default: ExactIn
          description: Pair mode only
        slippageBps:
          type: integer
          description: >-
            Overrides the slippage of the quote or ticket; pair-mode default 50.
            Above 10000 is taken as 10000. Must be a JSON number
        maxHops:
          type: integer
          description: Pair mode only
        onlyDirectRoutes:
          type: boolean
          description: Pair mode only
        dexes:
          oneOf:
            - type: string
            - type: array
              items:
                type: string
          description: Pair mode only. Alias `includeDex`
        excludeDexes:
          oneOf:
            - type: string
            - type: array
              items:
                type: string
          description: Pair mode only. Alias `excludeDex`
        allowSplit:
          type: boolean
          default: false
          description: Pair mode only; a split quote is built as a split anyway
        forJitoBundle:
          type: boolean
          default: false
          description: Pair mode only
        reserveKeys:
          type: integer
          default: 0
          description: Pair mode only
        wrapAndUnwrapSol:
          type: boolean
          default: true
          description: >-
            `true`: SOL input is wrapped from the wallet's lamports and its wSOL
            account closed after the swap; SOL output is unwrapped back to the
            wallet (not when `destinationTokenAccount` is another wallet).
            `false`: the route spends from and pays into the wallet's wSOL
            account. Alias `unwrapSol`
        feeAccount:
          type: string
          description: >-
            The integrator fee **wallet** (not a token account): a token-side
            fee goes to its associated token account, created if missing; a
            SOL-side fee is paid to the wallet itself. Must differ from
            `userPublicKey`. Required when the quote priced a platform fee.
            Alias `feeWallet`
        feeBps:
          type: integer
          description: >-
            The fee in basis points. Pinned quote: must equal
            `platformFee.feeBps` when the quote priced one. On a quote that
            priced no fee it is added at build time and lowers the floor, so up
            to `feeBps` less than the quoted `outAmount` can arrive. Pair mode:
            priced like `platformFeeBps`, only with `feeAccount`
        feeOnInput:
          type: boolean
          description: As in `/quote`; must match a priced quote
        prioritizationFeeLamports:
          $ref: '#/components/schemas/PrioritizationFee'
        computeUnitPriceMicroLamports:
          type: integer
          description: Priority price per compute unit (micro-lamports)
        transactionsFeeLamports:
          type: integer
          description: >-
            Older name of a total priority fee in lamports; wins over every
            other priority field
        tipWallet:
          type: string
          description: >-
            With `tipLamports`: a System transfer of the tip to this wallet, in
            `otherInstructions`. Wins over `jitoTipLamports`
        tipLamports:
          type: integer
          description: With `tipWallet`; `0` or absent is no tip
        destinationTokenAccount:
          type: string
          description: >-
            The **wallet** that receives the output; the route delivers to its
            associated token account, created if missing. A token account here
            is `400 bad_recipient` (an SPL multisig is accepted, as a wallet).
            When the last hop pays native SOL (a venue's native leg) the output
            can only go to `userPublicKey`: another wallet is `422 declined
            wire`. Default `userPublicKey`. Alias `recipient`
        txVersion:
          type: integer
          const: 1
          default: 1
          description: >-
            The integer `1`, or absent. `0` and any other number are `400
            bad_request`; a string such as `"v1"` (the response's spelling) is a
            parse error, `400` without `quoteId`
        asLegacyTransaction:
          type: boolean
          const: false
        serialize:
          type: boolean
          default: false
          description: >-
            Also return the unsigned transaction (`swapTransaction`) and
            `lastValidBlockHeight`
    SwapResponse:
      type: object
      required:
        - computeBudgetInstructions
        - setupInstructions
        - swapInstruction
        - swapInstructions
        - otherInstructions
        - addressLookupTableAddresses
        - quoteId
        - buildId
        - shape
        - inAmount
        - outAmount
        - otherAmountThreshold
        - swapMode
        - minReturn
        - maxAmountIn
        - computeUnits
        - loadedAccountsDataSize
        - txVersion
        - transactionConfig
        - routePlan
        - costs
      properties:
        computeBudgetInstructions:
          type: array
          items:
            $ref: '#/components/schemas/Instruction'
          description: Always empty in v1 (the budget is `transactionConfig`)
        setupInstructions:
          type: array
          items:
            $ref: '#/components/schemas/Instruction'
          description: >-
            Before the swap: create the token accounts (idempotent), wrap SOL,
            initialize venue accounts
        swapInstruction:
          $ref: '#/components/schemas/Instruction'
          description: The first `swap` instruction (program = your deploy)
        swapInstructions:
          type: array
          items:
            $ref: '#/components/schemas/Instruction'
          description: >-
            Every `swap` instruction in order: one, or two for a split. Sign all
            of them
        cleanupInstruction:
          $ref: '#/components/schemas/Instruction'
          description: >-
            The first account close after the swap (usually the wSOL unwrap).
            Absent when nothing is closed
        otherInstructions:
          type: array
          items:
            $ref: '#/components/schemas/Instruction'
          description: 'Everything after: further closes, the tip'
        addressLookupTableAddresses:
          type: array
          items:
            type: string
          maxItems: 0
          description: Always empty
        quoteId:
          type: string
        buildId:
          type: string
          description: 32 hex digits identifying this build
        shape:
          type: string
          enum:
            - token_exact_in
            - native_exact_in
            - exact_out
            - token_exact_in_split
          description: >-
            `exact_out`: one hop with a pinned output and an input cap. Any
            other ExactOut (several hops, or a venue without an exact-output
            instruction) is built as an exact-in shape that spends `maxAmountIn`
            with `minReturn` = the requested output. `native_exact_in`: one hop
            on a venue's native-SOL leg; `token_exact_in_split`: two routes
        inAmount:
          type: string
        outAmount:
          type: string
        otherAmountThreshold:
          type: string
        swapMode:
          type: string
          enum:
            - ExactIn
            - ExactOut
        minReturn:
          type: integer
          description: >-
            The floor the program enforces on the output. ExactOut: the
            requested output
        maxAmountIn:
          type: integer
          description: >-
            What the route deposits. ExactOut: the slippage cap
            (`otherAmountThreshold`)
        computeUnits:
          type: integer
          description: The compute-unit limit declared
        loadedAccountsDataSize:
          type: integer
          description: The loaded-accounts byte limit declared
        txVersion:
          type: string
          const: v1
        transactionConfig:
          $ref: '#/components/schemas/TransactionConfig'
        swapTransaction:
          type: string
          description: >-
            With `serialize: true`: the unsigned v1 transaction, base64. Sign it
            with `userPublicKey`
        lastValidBlockHeight:
          type: integer
          description: 'With `serialize: true`: last block height of its blockhash'
        routePlan:
          type: array
          items:
            $ref: '#/components/schemas/RoutePlanStep'
        costs:
          $ref: '#/components/schemas/Costs'
    QuoteResponse:
      type: object
      required:
        - inputMint
        - inAmount
        - outputMint
        - outAmount
        - otherAmountThreshold
        - swapMode
        - slippageBps
        - priceImpactPct
        - routePlan
      properties:
        inputMint:
          type: string
        inAmount:
          type: string
          description: >-
            What leaves the wallet, platform fee included. ExactIn: the `amount`
            asked
        outputMint:
          type: string
        outAmount:
          type: string
          description: >-
            What arrives, net of venue and platform fees. ExactOut: the `amount`
            asked
        otherAmountThreshold:
          type: string
          description: >-
            ExactIn: the least that arrives, `outAmount × (10000 − slippageBps)
            / 10000`. ExactOut: the most that is spent, `inAmount × (10000 +
            slippageBps) / 10000`
        swapMode:
          type: string
          enum:
            - ExactIn
            - ExactOut
        slippageBps:
          type: integer
        priceImpactPct:
          type: string
          description: >-
            Price impact as a decimal fraction (`0.01` is 1%). `0` when it is
            not known
        routePlan:
          type: array
          items:
            $ref: '#/components/schemas/RoutePlanStep'
          description: >-
            The hops in order. A split is two routes one after the other: a
            route ends at the first step whose `outputMint` is the quote's
        contextSlot:
          type: integer
          description: >-
            The router's head slot (the newest slot its account stream had
            reached) when the quote was priced
        timeTaken:
          type: number
          description: Seconds spent inside the router
        platformFee:
          $ref: '#/components/schemas/PlatformFee'
        quoteId:
          type: string
          description: 16 hex digits; the build of this quote carries the same `quoteId`
        routeTicket:
          type: string
          description: >-
            The route signed with HMAC-SHA256
            (`base64url(JSON).base64url(MAC)`), valid for `ROUTER_TICKET_TTL_S`
            (default 60 s). Only when the router sets `ROUTER_TICKET_SECRET`:
            the public router never returns it
          example: eyJ2IjoyLCJxdW90ZUlkIjoiMjNlMTRlMDEwMDAwNDRjNiIsImlucHV0TWlu…
    PrioritizationFee:
      description: >
        The priority fee, Jupiter style. A number is the **total** in lamports.
        `"auto"` takes the

        75th percentile of recent prioritization fees, within 10,000 and
        1,000,000 micro-lamports

        per compute unit. `priorityLevelWithMaxLamports` is `auto` capped at
        `maxLamports`

        (`priorityLevel` is ignored). `jitoTipLamports` adds a tip transfer to a
        Jito tip account

        instead of a priority fee. Absent means no priority fee. The fee is
        charged on the declared

        compute-unit limit, not on the units used.
      oneOf:
        - type: integer
          description: Total priority fee in lamports
        - type: string
          description: '`auto`, or a total in lamports as a string'
        - type: object
          required:
            - priorityLevelWithMaxLamports
          properties:
            priorityLevelWithMaxLamports:
              type: object
              properties:
                maxLamports:
                  type: integer
                priorityLevel:
                  type: string
                  description: Ignored
        - type: object
          required:
            - jitoTipLamports
          properties:
            jitoTipLamports:
              type: integer
        - type: object
          required:
            - jitoTipLamportsWithPayer
          properties:
            jitoTipLamportsWithPayer:
              type: object
              properties:
                lamports:
                  type: integer
    Instruction:
      type: object
      required:
        - programId
        - accounts
        - data
      properties:
        programId:
          type: string
        accounts:
          type: array
          items:
            $ref: '#/components/schemas/AccountMeta'
        data:
          type: string
          description: Instruction data, standard base64
    TransactionConfig:
      type: object
      description: >-
        The v1 message header. An absent field is absent from the header; at
        runtime an absent limit counts as zero, so carry every field into the
        transaction you assemble
      required:
        - computeUnitLimit
        - loadedAccountsDataSizeLimit
      properties:
        priorityFeeLamports:
          type: integer
          description: Total priority fee in lamports. Absent when there is none
        computeUnitLimit:
          type: integer
          description: 'Always set by a build: the compute units sized from the route'
        loadedAccountsDataSizeLimit:
          type: integer
          description: 'Always set by a build: bytes of accounts the transaction may load'
        heapSize:
          type: integer
          description: Never set by a build today; accepted by `POST /tx/v1`
    RoutePlanStep:
      type: object
      required:
        - swapInfo
      properties:
        swapInfo:
          $ref: '#/components/schemas/SwapInfo'
        percent:
          type: integer
          minimum: 1
          maximum: 100
          description: >-
            On the first step of a route, that route's share of the input,
            rounded; 100 elsewhere
        bps:
          type: integer
          minimum: 1
          maximum: 10000
          description: The exact share in basis points
    Costs:
      type: object
      description: >-
        What the transaction takes from the wallet besides the swap input, in
        lamports as strings
      required:
        - baseFeeLamports
        - priorityFeeLamports
        - priorityFeeSource
        - priorityFeeMicroLamportsPerCu
        - tipLamports
        - rentLamports
        - rentRefundedLamports
        - rentExact
        - totalLamports
      properties:
        baseFeeLamports:
          type: string
          description: 5,000 per required signature
        priorityFeeLamports:
          type: string
          description: The total priority fee the message declares
        priorityFeeSource:
          type: string
          enum:
            - client
            - chain
            - floor
            - ceiling
            - none
          description: >-
            Where the price per compute unit came from: your request, the chain
            (`auto`), its floor or ceiling, or no priority fee
        priorityFeeMicroLamportsPerCu:
          type: string
          description: >-
            The price per compute unit applied; `0` when you gave the fee as a
            lamport total or there is none
        tipLamports:
          type: string
        rentLamports:
          type: string
          description: >-
            Rent the transaction deposits into the accounts it creates, counted
            as if the wallet had none of them: an upper bound the wallet must
            hold
        rentRefundedLamports:
          type: string
          description: >-
            Rent the same transaction gives back when it closes accounts it
            created
        rentExact:
          type: boolean
          description: >-
            `false`: a Token-2022 account's size is not known exactly and
            `rentLamports` is a minimum
        totalLamports:
          type: string
          description: base + priority + tip + rent − rent refunded
    Error:
      type: object
      required:
        - error
        - reason
      properties:
        error:
          type: string
          description: >-
            Closed error code: `bad_request`, `declined`, `not_found`,
            `internal`, `quote_mismatch`, `invalid_route_ticket`,
            `route_ticket_mismatch`, `route_expired`, `bad_recipient`,
            `venue_red`, `rpc`, or on `/tx/v1` `bad_address`, `no_instructions`,
            `bad_data`, `missing_budget`, `invalid_message`, `wire_limit`
        reason:
          type: string
          description: >-
            With `declined`, a stable label (`no_route`, `cold_unresolved`,
            `platform_fee`, …); otherwise a sentence for humans
        quoteId:
          type: string
          description: >-
            16 hex digits, also in the router's logs. Absent when the request
            could not be parsed, on `not_found` and on `/tx/v1`. A failed build
            carries a new id, not the quote's
    LowLiquidityError:
      type: object
      required:
        - error
        - reason
        - liquidity
      properties:
        error:
          type: string
          const: declined
        reason:
          type: string
          const: low_liquidity
        liquidity:
          type: object
          description: The deepest direct pool of the pair, all too shallow to price
          properties:
            venue:
              type: string
              description: '`dex` label of the pool'
            hubMint:
              type: string
              description: The pool's SOL, USDC or USDT side
            hubAmount:
              type: string
              description: Its balance in base units of `hubMint` (u64 as string)
        quoteId:
          type: string
    NotReadyError:
      type: object
      required:
        - error
        - reasons
      properties:
        error:
          type: string
          const: not_ready
        reasons:
          type: array
          items:
            type: string
          description: Every reason the router cannot serve this request now
        quoteId:
          type: string
    PlatformFee:
      type: object
      description: Present when `platformFeeBps` > 0
      properties:
        amount:
          type: string
          description: The fee, in base units of `feeMint`
        feeBps:
          type: integer
        feeMint:
          type: string
          description: >-
            Router extension: the mint the fee is taken in (`inputMint` or
            `outputMint`)
    AccountMeta:
      type: object
      required:
        - pubkey
      properties:
        pubkey:
          type: string
        isSigner:
          type: boolean
          default: false
        isWritable:
          type: boolean
          default: false
    SwapInfo:
      type: object
      required:
        - ammKey
        - label
        - inputMint
        - outputMint
        - inAmount
        - outAmount
      properties:
        ammKey:
          type: string
          description: Pool address
        label:
          type: string
          description: Venue `dex` label
        inputMint:
          type: string
        outputMint:
          type: string
        inAmount:
          type: string
          description: Input of this hop (after the platform fee when it is on the input)
        outAmount:
          type: string
          description: Output of this hop
        walkSteps:
          type: integer
          description: >-
            Router extension: ticks or bins this hop walked. Keep it when you
            send the quote back: without it the build declares the maximum
            compute budget for the hop (and pays priority fee on it)
  examples:
    SwapBuilt:
      summary: '0.1 SOL to USDC, serialize: true, prioritizationFeeLamports: auto'
      value:
        computeBudgetInstructions: []
        setupInstructions:
          - programId: ATokenGPvbdGVxr1b2hvZbsiqW5xWH25efTNsLJA8knL
            accounts:
              - pubkey: 9WzDXwBbmkg8ZTbNMqUxvQRAyrZzDsGYdLVL9zYtAWWM
                isSigner: true
                isWritable: true
              - pubkey: 8LjUgMjzZuHj8VdyxzkmLLQVmW4C3gd56md1nLd76TNW
                isSigner: false
                isWritable: true
              - pubkey: 9WzDXwBbmkg8ZTbNMqUxvQRAyrZzDsGYdLVL9zYtAWWM
                isSigner: false
                isWritable: false
              - pubkey: So11111111111111111111111111111111111111112
                isSigner: false
                isWritable: false
              - pubkey: '11111111111111111111111111111111'
                isSigner: false
                isWritable: false
              - pubkey: TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA
                isSigner: false
                isWritable: false
            data: AQ==
          - programId: ATokenGPvbdGVxr1b2hvZbsiqW5xWH25efTNsLJA8knL
            accounts:
              - pubkey: 9WzDXwBbmkg8ZTbNMqUxvQRAyrZzDsGYdLVL9zYtAWWM
                isSigner: true
                isWritable: true
              - pubkey: FGETo8T8wMcN2wCjav8VK6eh3dLk63evNDPxzLSJra8B
                isSigner: false
                isWritable: true
              - pubkey: 9WzDXwBbmkg8ZTbNMqUxvQRAyrZzDsGYdLVL9zYtAWWM
                isSigner: false
                isWritable: false
              - pubkey: EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v
                isSigner: false
                isWritable: false
              - pubkey: '11111111111111111111111111111111'
                isSigner: false
                isWritable: false
              - pubkey: TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA
                isSigner: false
                isWritable: false
            data: AQ==
          - programId: '11111111111111111111111111111111'
            accounts:
              - pubkey: 9WzDXwBbmkg8ZTbNMqUxvQRAyrZzDsGYdLVL9zYtAWWM
                isSigner: true
                isWritable: true
              - pubkey: 8LjUgMjzZuHj8VdyxzkmLLQVmW4C3gd56md1nLd76TNW
                isSigner: false
                isWritable: true
            data: AgAAAADh9QUAAAAA
          - programId: TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA
            accounts:
              - pubkey: 8LjUgMjzZuHj8VdyxzkmLLQVmW4C3gd56md1nLd76TNW
                isSigner: false
                isWritable: true
            data: EQ==
        swapInstruction:
          programId: DADMMjfNnY6z8H9h9RfHZ9tfarBySsj4Yb65qLyKJDAD
          accounts:
            - pubkey: 9WzDXwBbmkg8ZTbNMqUxvQRAyrZzDsGYdLVL9zYtAWWM
              isSigner: true
              isWritable: true
            - pubkey: 6FnGsVD12kgwbjhdcqwVZZ2s53FXiTmj6hmt9nms4bww
              isSigner: false
              isWritable: false
            - pubkey: LBUZKhRxPF3XUpBCjp4YzTKgLccjZhTSDM9YuVaPwxo
              isSigner: false
              isWritable: false
            - pubkey: HTvjzsfX3yU6BUodCjZ5vZkUrAxMDTrBs3CJaq43ashR
              isSigner: false
              isWritable: true
            - pubkey: 9HcJeBEsq5px2bYZbdo7vzQWVsPK3SHTkchy42hBn7HC
              isSigner: false
              isWritable: true
            - pubkey: H7j5NPopj3tQvDg4N8CxwtYciTn3e8AEV6wSVrxpyDUc
              isSigner: false
              isWritable: true
            - pubkey: HbYjRzx7teCxqW3unpXBEcNHhfVZvW2vW9MQ99TkizWt
              isSigner: false
              isWritable: true
            - pubkey: 8LjUgMjzZuHj8VdyxzkmLLQVmW4C3gd56md1nLd76TNW
              isSigner: false
              isWritable: true
            - pubkey: FGETo8T8wMcN2wCjav8VK6eh3dLk63evNDPxzLSJra8B
              isSigner: false
              isWritable: true
            - pubkey: So11111111111111111111111111111111111111112
              isSigner: false
              isWritable: false
            - pubkey: EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v
              isSigner: false
              isWritable: false
            - pubkey: EgEYXef2FCoEYLHJJW74dMbom1atLXo6KwPuA6mSATYA
              isSigner: false
              isWritable: true
            - pubkey: TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA
              isSigner: false
              isWritable: false
            - pubkey: MemoSq4gqABAXKb96qnH8TysNcWxMyWCqXgDLGmfcHr
              isSigner: false
              isWritable: false
            - pubkey: D1ZN9Wj1fRSUQfCjhvnu1hqDMT7hzjzBBpi12nVniYD6
              isSigner: false
              isWritable: false
            - pubkey: AHWjpDEN41mddq8DgUKmX2iQwK3Srg6MCgi1iMjV55To
              isSigner: false
              isWritable: true
            - pubkey: 6AfKQDv42gJRLEBj4zhHR1uTZd4Mj5g75xaozWqs3CGP
              isSigner: false
              isWritable: true
            - pubkey: 9SW7tJc6qCDLHWFRWKf3pb1rNW3NgcGuqQ9HfhMJnbd5
              isSigner: false
              isWritable: true
            - pubkey: 3FRoVcNFxmznbZTQP5muKU4VvFJbiACmE8H9nbc31tyP
              isSigner: false
              isWritable: true
            - pubkey: 95ZfXjhrsjLtbYggDyyXjviVnzFnc3qyyab5ZQvCUiTH
              isSigner: false
              isWritable: true
            - pubkey: 7mtH8doACVxtgnpuHf28rT6YC6KxgGaHwkk1Abr7KdJF
              isSigner: false
              isWritable: true
            - pubkey: BTbdjpRazxzETE5NHiRyhPSs31bcuS66UVdEqhpS8pgn
              isSigner: false
              isWritable: true
            - pubkey: 3T2k3Jj1Gy5wnzL262XERtkZVuuk3eUnHXVz1SBeydqG
              isSigner: false
              isWritable: true
            - pubkey: 7r1eVXSdLReZaW2nQHT18o4fhrvKexkb9YvUB1tuKtG9
              isSigner: false
              isWritable: true
            - pubkey: GvcoDmDQxxefuNc2Jp6EgY9kmWQFRfLXWxbBeKMY2cAH
              isSigner: false
              isWritable: true
            - pubkey: DxK58yoaYhMChMRYTDu7pLkSenkabRjmjFvrH7WBx2n8
              isSigner: false
              isWritable: true
            - pubkey: EdVxQZg2LWQpJ5sYkP9W9yHdE82Sh72MXzLCkZq7Vep9
              isSigner: false
              isWritable: true
            - pubkey: GDnVaY9DZNnrirV7QXia6X5aPzdqhQ8seSvGDeVXcDE3
              isSigner: false
              isWritable: true
            - pubkey: 97kDUqyxUEh4iCqWxREYUtU9scA4TKMuHBm1TD6D9fRv
              isSigner: false
              isWritable: true
            - pubkey: 84z7SCPSzAtvpsYNq6DFCZtaGgaNvUXzgj1RjJk2xPXy
              isSigner: false
              isWritable: true
            - pubkey: pHnkoj6wRWqeXDM9K5CNioiGie73H6BFxKF4H9mrEqG
              isSigner: false
              isWritable: true
          data: >-
            AQEDAQAAMgD/////AOH1BQAAAAAHNgAfCvr/////Cf8IFimvsgAAAAAACv4AEAAAAAAAAAAACAcIIQIAHAAHlbMAgPD6BgKDhIWGh4gJCosCwAwMDQ4Cj5CRkpOUlZaXmJmam5ydngAIAADh9QUAAAAAARAAKa+yAAAAAABBSz9M61tbiADh9QUAAAAAKa+yAAAAAAAAAAAA
        swapInstructions:
          - programId: DADMMjfNnY6z8H9h9RfHZ9tfarBySsj4Yb65qLyKJDAD
            accounts:
              - pubkey: 9WzDXwBbmkg8ZTbNMqUxvQRAyrZzDsGYdLVL9zYtAWWM
                isSigner: true
                isWritable: true
              - pubkey: 6FnGsVD12kgwbjhdcqwVZZ2s53FXiTmj6hmt9nms4bww
                isSigner: false
                isWritable: false
              - pubkey: LBUZKhRxPF3XUpBCjp4YzTKgLccjZhTSDM9YuVaPwxo
                isSigner: false
                isWritable: false
              - pubkey: HTvjzsfX3yU6BUodCjZ5vZkUrAxMDTrBs3CJaq43ashR
                isSigner: false
                isWritable: true
              - pubkey: 9HcJeBEsq5px2bYZbdo7vzQWVsPK3SHTkchy42hBn7HC
                isSigner: false
                isWritable: true
              - pubkey: H7j5NPopj3tQvDg4N8CxwtYciTn3e8AEV6wSVrxpyDUc
                isSigner: false
                isWritable: true
              - pubkey: HbYjRzx7teCxqW3unpXBEcNHhfVZvW2vW9MQ99TkizWt
                isSigner: false
                isWritable: true
              - pubkey: 8LjUgMjzZuHj8VdyxzkmLLQVmW4C3gd56md1nLd76TNW
                isSigner: false
                isWritable: true
              - pubkey: FGETo8T8wMcN2wCjav8VK6eh3dLk63evNDPxzLSJra8B
                isSigner: false
                isWritable: true
              - pubkey: So11111111111111111111111111111111111111112
                isSigner: false
                isWritable: false
              - pubkey: EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v
                isSigner: false
                isWritable: false
              - pubkey: EgEYXef2FCoEYLHJJW74dMbom1atLXo6KwPuA6mSATYA
                isSigner: false
                isWritable: true
              - pubkey: TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA
                isSigner: false
                isWritable: false
              - pubkey: MemoSq4gqABAXKb96qnH8TysNcWxMyWCqXgDLGmfcHr
                isSigner: false
                isWritable: false
              - pubkey: D1ZN9Wj1fRSUQfCjhvnu1hqDMT7hzjzBBpi12nVniYD6
                isSigner: false
                isWritable: false
              - pubkey: AHWjpDEN41mddq8DgUKmX2iQwK3Srg6MCgi1iMjV55To
                isSigner: false
                isWritable: true
              - pubkey: 6AfKQDv42gJRLEBj4zhHR1uTZd4Mj5g75xaozWqs3CGP
                isSigner: false
                isWritable: true
              - pubkey: 9SW7tJc6qCDLHWFRWKf3pb1rNW3NgcGuqQ9HfhMJnbd5
                isSigner: false
                isWritable: true
              - pubkey: 3FRoVcNFxmznbZTQP5muKU4VvFJbiACmE8H9nbc31tyP
                isSigner: false
                isWritable: true
              - pubkey: 95ZfXjhrsjLtbYggDyyXjviVnzFnc3qyyab5ZQvCUiTH
                isSigner: false
                isWritable: true
              - pubkey: 7mtH8doACVxtgnpuHf28rT6YC6KxgGaHwkk1Abr7KdJF
                isSigner: false
                isWritable: true
              - pubkey: BTbdjpRazxzETE5NHiRyhPSs31bcuS66UVdEqhpS8pgn
                isSigner: false
                isWritable: true
              - pubkey: 3T2k3Jj1Gy5wnzL262XERtkZVuuk3eUnHXVz1SBeydqG
                isSigner: false
                isWritable: true
              - pubkey: 7r1eVXSdLReZaW2nQHT18o4fhrvKexkb9YvUB1tuKtG9
                isSigner: false
                isWritable: true
              - pubkey: GvcoDmDQxxefuNc2Jp6EgY9kmWQFRfLXWxbBeKMY2cAH
                isSigner: false
                isWritable: true
              - pubkey: DxK58yoaYhMChMRYTDu7pLkSenkabRjmjFvrH7WBx2n8
                isSigner: false
                isWritable: true
              - pubkey: EdVxQZg2LWQpJ5sYkP9W9yHdE82Sh72MXzLCkZq7Vep9
                isSigner: false
                isWritable: true
              - pubkey: GDnVaY9DZNnrirV7QXia6X5aPzdqhQ8seSvGDeVXcDE3
                isSigner: false
                isWritable: true
              - pubkey: 97kDUqyxUEh4iCqWxREYUtU9scA4TKMuHBm1TD6D9fRv
                isSigner: false
                isWritable: true
              - pubkey: 84z7SCPSzAtvpsYNq6DFCZtaGgaNvUXzgj1RjJk2xPXy
                isSigner: false
                isWritable: true
              - pubkey: pHnkoj6wRWqeXDM9K5CNioiGie73H6BFxKF4H9mrEqG
                isSigner: false
                isWritable: true
            data: >-
              AQEDAQAAMgD/////AOH1BQAAAAAHNgAfCvr/////Cf8IFimvsgAAAAAACv4AEAAAAAAAAAAACAcIIQIAHAAHlbMAgPD6BgKDhIWGh4gJCosCwAwMDQ4Cj5CRkpOUlZaXmJmam5ydngAIAADh9QUAAAAAARAAKa+yAAAAAABBSz9M61tbiADh9QUAAAAAKa+yAAAAAAAAAAAA
        cleanupInstruction:
          programId: TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA
          accounts:
            - pubkey: 8LjUgMjzZuHj8VdyxzkmLLQVmW4C3gd56md1nLd76TNW
              isSigner: false
              isWritable: true
            - pubkey: 9WzDXwBbmkg8ZTbNMqUxvQRAyrZzDsGYdLVL9zYtAWWM
              isSigner: false
              isWritable: true
            - pubkey: 9WzDXwBbmkg8ZTbNMqUxvQRAyrZzDsGYdLVL9zYtAWWM
              isSigner: true
              isWritable: false
          data: CQ==
        otherInstructions: []
        addressLookupTableAddresses: []
        quoteId: 23e14e01000044c6
        buildId: e2492701bd5ca34f3f2ae4c6d7e8ea5e
        shape: token_exact_in
        inAmount: '100000000'
        outAmount: '11769095'
        otherAmountThreshold: '11710249'
        swapMode: ExactIn
        minReturn: 11710249
        maxAmountIn: 100000000
        computeUnits: 250000
        loadedAccountsDataSize: 2848871
        txVersion: v1
        transactionConfig:
          priorityFeeLamports: 6864
          computeUnitLimit: 250000
          loadedAccountsDataSizeLimit: 2848871
        swapTransaction: gQEACg8AAABzC5BGsDaM61xZPkeGm/RoYH/gF9m9YhrkMz2ZM9aR9wYifowI…
        lastValidBlockHeight: 430448451
        routePlan:
          - swapInfo:
              ammKey: HTvjzsfX3yU6BUodCjZ5vZkUrAxMDTrBs3CJaq43ashR
              label: Meteora DLMM
              inputMint: So11111111111111111111111111111111111111112
              outputMint: EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v
              inAmount: '100000000'
              outAmount: '11769095'
              walkSteps: 1
            percent: 100
            bps: 10000
        costs:
          baseFeeLamports: '5000'
          priorityFeeLamports: '6864'
          priorityFeeSource: chain
          priorityFeeMicroLamportsPerCu: '27456'
          tipLamports: '0'
          rentLamports: '2976880'
          rentRefundedLamports: '1488440'
          rentExact: true
          totalLamports: '1500304'
  responses:
    SwapBadRequest:
      description: >
        Fix the request; retrying will not help. `error` is one of:

        `bad_request` (a field is missing, malformed, or contradicts another:
        see `reason`),

        `quote_mismatch` (`inputMint`/`outputMint` differ from the
        `quoteResponse`, or the quote priced a

        platform fee and `feeAccount` is missing or `feeBps`/`feeOnInput`
        differ),

        `invalid_route_ticket` (bad signature or shape, or tickets disabled on
        this router),

        `route_ticket_mismatch` (mints or amount differ from the ticket),

        `bad_recipient` (`destinationTokenAccount` is a token account; send the
        wallet),

        `declined` with `reason` `platform_fee` (the fee cannot be built:
        `feeAccount` is the user,

        a SOL-side fee would open a missing fee wallet below rent, an on-chain
        fee pin, or tampered

        amounts) or `zero_amount`.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
          examples:
            noUser:
              summary: userPublicKey missing
              value:
                error: bad_request
                reason: userPublicKey is required
                quoteId: 23e14e010000450e
            v0:
              summary: txVersion 0
              value:
                error: bad_request
                reason: 'txVersion 0 is not served: this router emits v1'
                quoteId: 23e14e010000450f
            mismatch:
              summary: inputMint differs from the quote
              value:
                error: quote_mismatch
                reason: quoteResponse.inputMint differs from the request
                quoteId: 23e14e0100004512
            feeAccount:
              summary: The quote priced a fee and feeAccount is missing
              value:
                error: quote_mismatch
                reason: 'feeAccount is required: the quote priced a platform fee'
                quoteId: 23e14e01000044cd
            ticketsOff:
              summary: routeTicket on a router without ROUTER_TICKET_SECRET
              value:
                error: invalid_route_ticket
                reason: tickets are disabled on this host
                quoteId: 23e14e0100004510
            recipient:
              summary: A token account as destination
              value:
                error: bad_recipient
                reason: >-
                  destinationTokenAccount is the WALLET that receives the output
                  (the route delivers to its associated token account), not a
                  token account
                quoteId: 23e14e010000453d
            feeToSelf:
              summary: feeAccount equal to userPublicKey
              value:
                error: declined
                reason: platform_fee
                quoteId: 23e14e01000044f8
            malformed:
              summary: Not JSON
              value:
                error: bad_request
                reason: EOF while parsing an object at line 1 column 1
    NoRoute:
      description: >
        `declined` with `no_route` (no route exists under these filters and hop
        limit) or `no_cycle`

        (input equals output and no cycle returns more than it costs). Widen the
        filters or the

        amount; retrying the same request will not change it unless the market
        does.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
          example:
            error: declined
            reason: no_route
            quoteId: 23e14e01000045c5
    SwapConflict:
      description: >
        Re-quote, then build again. `error` is `route_expired` (the
        `routeTicket` is past its TTL),

        `venue_red` (the pinned route crosses a venue the price oracle now holds
        out), or `declined`

        with `pool_missing`, `satellite`, `layout`, `token_program` or
        `shared_account` (the pool

        state the route needs is not available or changed; a retry or a fresh
        quote can fix it).
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
          examples:
            expired:
              summary: Ticket expired (shape from the code)
              value:
                error: route_expired
                reason: Expired
                quoteId: 23e14e0100000002
            satellite:
              summary: A pool account is missing (shape from the code)
              value:
                error: declined
                reason: satellite
                quoteId: 23e14e0100000003
    TooLarge:
      description: The request body is over 256 KiB (plain-text body)
      content:
        text/plain:
          schema:
            type: string
    SwapDeclined:
      description: >
        A named decline that waiting will not change. `error` is `declined`;
        `reason` is a quote

        decline (as in `GET /quote`, for a build without `quoteResponse`; a pair
        build never answers

        `cold_unresolved`) or a build decline:

        `unbuildable` (the venue has no builder), `exact_out_shape` (this
        exact-out shape is not

        built, e.g. an output-side fee), `wire_limit` (over 64 keys, 64
        instructions or 4,096 bytes),

        `wire` (the route cannot be expressed, e.g. a native-SOL last hop sent
        to another wallet),

        `program_hop_limit` (more than 4 hops in a route), `compute_budget`
        (over 1.4M

        compute units), `transfer_guard`, `dark_trader` (the venue charges this
        wallet a listed-trader

        fee: exclude it), or the sentence `<venue> has no live row in the swap
        on-chain config` (your

        deploy's config does not allow that venue).
      content:
        application/json:
          schema:
            anyOf:
              - $ref: '#/components/schemas/Error'
              - $ref: '#/components/schemas/LowLiquidityError'
          examples:
            notAllowed:
              summary: Venue not in your deploy's config (shape from the code)
              value:
                error: declined
                reason: PumpSwap has no live row in the swap on-chain config
                quoteId: 23e14e0100000004
            wireLimit:
              summary: Too many accounts (shape from the code)
              value:
                error: declined
                reason: wire_limit
                quoteId: 23e14e0100000005
    Internal:
      description: >-
        A router bug: `error` is `internal` (`quote task failed`, `build task
        failed`, …). Report it with the `quoteId`.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
          examples:
            build:
              summary: The build task panicked (shape from the code)
              value:
                error: internal
                reason: build task failed
                quoteId: 23e14e0100000009
    SwapNotReady:
      description: >
        Retry with backoff. `error` is `not_ready` with `reasons` (the router is
        not ready,

        `blockhash unavailable` for `serialize`, `swap config not usable: …`
        when your deploy's

        config cannot be read, or `swap is paused on chain`), `declined` with
        `router_config` or

        with a sentence when the chain read for the route failed, or `rpc` when
        the owner of

        `destinationTokenAccount` could not be read.
      content:
        application/json:
          schema:
            anyOf:
              - $ref: '#/components/schemas/NotReadyError'
              - $ref: '#/components/schemas/Error'
          examples:
            paused:
              summary: Your deploy is paused (shape from the code)
              value:
                error: not_ready
                reasons:
                  - swap is paused on chain
                quoteId: 23e14e0100000006
            blockhash:
              summary: serialize without a fresh blockhash (shape from the code)
              value:
                error: not_ready
                reasons:
                  - blockhash unavailable
                quoteId: 23e14e0100000007
            fetch:
              summary: The chain read failed (shape from the code)
              value:
                error: declined
                reason: 'satellite account missing: account fetch failed'
                quoteId: 23e14e0100000008
  securitySchemes:
    ApiKeyHeader:
      type: apiKey
      in: header
      name: x-api-key
    Bearer:
      type: http
      scheme: bearer
    ApiKeyQuery:
      type: apiKey
      in: query
      name: apiKey

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.