Preview quotes

POST /v1/quote/preview Indicative offers for browsing. Reserves nothing, appends nothing, and returns nothing signable.

Item	Value
Route key	`infinityQuotePreview`
Credential	API key or project id
`X-Infinity-Subject`	required: the preview is for that user of yours (Authentication — your users)

Request

Request body

The same QuoteRequest as POST /quote, with the same validation.

Response

data (QuotePreviewResponse):

Field	Type	Meaning
`signable`	boolean	always `false`
`offers[]`	array	`{provider, previewId, expiresAt, amountIn, amountOut}` — estimates, ordered by provider id, not by price. `previewId` is informational, never a quote id

Behavior

An empty offers array with success means no provider call failed and none produced an offer: for each provider asked, the aggregator either answered that no solver serves the request, or answered without a usable offer (any it sent were discarded, below) and without reporting a solver unavailable. It also comes back when no provider was asked at all, because every provider’s circuit breaker is open, so it can hide an outage.
Any provider error turns a round without offers into EIN0050, and refusals of the request as sent count as errors: an amount below the provider’s minimum, an exact-output request whose input would exceed maxAmountIn, a Solana source without sourceAccount. Such a request gets EIN0050, not an empty success, and retrying doesn’t change it; POST /quote answers it with EIN0008 (known issue). A provider that cannot preview at all counts as failed on every round.
On a token-in lane an offer’s amountIn is the slippage-widened ceiling, rounded up — the figure the wallet will be asked to approve.
Offers with invalid amounts, a changed fixed-side amount, or an exact-output input above maxAmountIn are discarded.

Errors

Code	When
(`POST /quote` validation codes)	see `POST /quote`
`EIN0050`	bare, when there are zero offers and at least one provider call failed, a refusal of the request as sent included (known issue); or when the deployment has paused exposure
`EIN0080`	your organization’s quote bucket, shared by the three quote routes; `error_params[0]` is the same suggested back-off as on `POST /quote`, `floor(1000 / tenantRps)` ms and at least 1
`EIN0081`	busy — back off

The gateway’s own refusals — a refused credential, a route not open to it, a rate limit, the hub unreachable or too slow — can come back from every route, with an EPX code and a real HTTP status (Errors — gateway codes); EIN0049 (internal, scrubbed) can come back from any route.

Example

curl -sS -X POST https://proxy-api.infinimesh.net/v1/quote/preview \
  -H "x-api-key: $HUB_API_KEY" \
  -H "X-Infinity-Subject: user-42" \
  -H 'Content-Type: application/json' \
  -d '{"sourceChain":"eip155-1","destChain":"eip155-56","sourceAsset":"weth","destAsset":"wbnb","amount":"1000000000000000","recipient":"0xf39Fd6e51aad88F6F4ce6aB8827279cffFb92266"}'

Response

Illustrative values; formats follow the Response table.

{
  "success": true,
  "request_id": "9c0d1e2f-3041-427c-ad7e-8f9a0b1c2d3e",
  "data": {
    "signable": false,
    "offers": [
      {
        "provider": "c8-solver",
        "previewId": "indicative-reference",
        "expiresAt": "2026-09-22T12:00:45Z",
        "amountIn": "1000000000000000",
        "amountOut": "32548366596169380000"
      }
    ]
  }
}

// client: your InteropClient (see /infinity-interop/sdk/installation)
const preview = await client.previewQuotes({
  sourceChain: "eip155-1", destChain: "eip155-56",
  sourceAsset: "weth", destAsset: "wbnb",
  amount: "1000000000000000", recipient: "0xf39Fd6e51aad88F6F4ce6aB8827279cffFb92266",
});

Get started

Core concepts

Resources

API reference

SDK

SDK reference

Request

Request body

Response

Behavior

Errors

Example

Response

See also

​Request

​Request body

​Response

​Behavior

​Errors

​Example

​Response

​See also

Request

Request body

Response

Behavior

Errors

Example

Response

See also