Get quote

POST /v1/quote Run one quote round across the configured providers and disclose the winner.

Item	Value
Route key	`infinityQuote`
Credential	API key or project id
`X-Infinity-Subject`	required: the quote is made for that user of yours; submit it with the same subject (Authentication — your users)

Request

Request body

QuoteRequest:

Field	Type	Required	Rules	Meaning
`sourceChain`	string	yes	chain-domain shape, ≤ 64	the chain the user pays on
`destChain`	string	yes	chain-domain shape, ≤ 64	the chain the recipient is paid on
`sourceAsset`	string	yes	asset key or `<chainDomain>:<address>`, ≤ 128; a bare `0x` address is refused	the asset the user pays with
`destAsset`	string	yes	as `sourceAsset`	the asset the recipient receives
`amount`	string	yes	decimal base units, > 0, ≤ 80 characters	the input the user spends (default), or with `swapType: "exact-output"` what the recipient receives
`recipient`	string	yes	≤ 128; an address of the destination chain’s family	who is paid on the destination
`sourceAccount`	string	no	≤ 128; an address of the source chain’s family	the user’s funding account. Optional on EVM↔EVM; needed for any non-EVM leg (the solver compiles the transaction around it; a Solana source without it is `EIN0008` with no reference, bare `EIN0050` on preview) and for a signed `POST /order` (the signer must equal it). When it is absent, the hub quotes the `recipient` as the payer (`signablePayload.payer` and the signed `witness.user`): a signer other than the recipient then pays, with its own Permit2 nonce and tokens, for an order whose user and refund beneficiary is the recipient
`swapType`	string	no	`exact-input` (default) or `exact-output`, case-sensitive	which side is fixed
`maxAmountIn`	string	no	decimal base units; exact-output only	the most the user will pay
`slippageBps`	integer	no	1–1000; absent or `0` means 50	token-in lane tolerance; ignored on every other lane

Validation and resolution rules, in the order they apply:

A non-EVM recipient or sourceAccount that does not decode is EIN0001 with that field as reference. EVM addresses are not format-checked at this point — a malformed one fails later, not as EIN0001.
An asset reference whose chain is not the request’s chain is EIN0001 (reference sourceAsset / destAsset, error_params = [reference chain, request chain]).
A reference to a declared asset behaves exactly as its key.
An undeclared destination reference is forwarded as its address.
An undeclared source reference is admitted only on a chain that declares a swap router and a wrapped native — the token-in lane (the proxy swaps it into the wrapped native). An address with no code there (its decimals() call answers empty) is EIN0002, reference no ERC-20 at <chainDomain>:<address>. A contract that is not an ERC-20 passes that probe, and the round then fails at the provider, typically EIN0008 providerRefused. On any other chain an undeclared source is EIN0002 (“accepts no undeclared source”).
maxAmountIn on an exact-input request is EIN0001 (reference maxAmountIn).
exact-output with a token-in source is EIN0001 (reference swapType): that lane’s price is known only from what the user spends.
Source chains are EVM and Solana. Sui and Aptos are supported as destination chains only: a quote whose source is a Sui or Aptos chain is refused. The catalog’s family tells you which rail a chain is on.

Response

data (QuoteResponse):

Field	Type	Meaning
`quoteRequestId`	string	the round id (a ULID; on prepare, derived from your organization and `preparationId`)
`quoteId`	string	the winning quote (64 hex) — the input to `POST /order` and `POST /order/openfor`
`issuedAt`	timestamp	the round’s clock
`expiresAt`	timestamp	when the quote stops being submittable; never refreshed (Limits)
`executionClass`	string	`INFINITY_SOLVER`, `PROVIDER_NATIVE_COVERED` or `PROVIDER_NATIVE_UNCOVERED`
`amountIn`	string	base units the winner charges (on the token-in lane: the escrow’s wrapped native — see `swapInput`)
`amountOut`	string	base units the recipient receives (on an auction: the guaranteed floor)
`legs[]`	array	`{provider, product, version, sourceChain, destChain, sourceAsset, destAsset, amountIn, amountOut}` per leg
`score`	object	`{value, scoringVersion, candidatesEvaluated, providersMissedRound}`; `value` is an exact decimal string
`policy`	object	`{policyVersion, pathEpoch, scoringVersion}` — the configuration the round ran under
`disclosure`	object	`{signableHash, signablePayload}` — see below
`signPayload`	object	openFor flow only: what the user signs, verbatim (Step execution — gasless openFor)
`executionTx`	object	the user sends it: `{approvals[], steps[]}` (Step execution — proxy lanes, Step execution — open flow)
`swapInput`	object	token-in lane only: `{assetRef, amountMax, spender}` — the token the user pays with and the most that can be taken. Show this, not `amountIn`, as the cost
`signIntent`	string	the order-intent text to `personal_sign` for `POST /order` (scheme `eip191`); frozen as v1 — sign it verbatim, never derive it. Absent when the hub could not build it (it discloses none rather than a wrong one); a signed `POST /order` is then impossible, so re-quote
`etaSeconds`	integer	the provider’s own fill-time estimate; omitted when none was disclosed
`auction`	object	present on a decaying winner, and also on a `limit` / `exclusiveLimit` winner, which does not decay (`slope` `"0"`, `ceiling` = `floor`) and ranks as firm (Flows — auctions; what the fields mean: Trade types — firm and auctioned winners)

disclosure.signableHash is the value to echo as artifactHash on POST /order. disclosure.signablePayload is the canonical signable form. Its keys a client reads:

Key	Meaning
`kind`	the winner kind, which decides the submission flow: `oif-escrow-gasless`, `oif-escrow-nonevm`, `aggregator-gasless` (signed, openFor); `oif-wrap-native`, `oif-swap-token` (proxy lanes, unsigned openFor); `aggregator-bridge` (open flow); `transfer` (discloses neither `signPayload` nor `executionTx`; not completable); `solver-swap` (every `INFINITY_SOLVER` candidate; not completable)
`orderId`	the recomputed on-chain order id (proxy lanes, Solana, the external gasless lane; absent on Permit2)
`wrapsNative` / `wrappedAsset`	Solana native-coin quotes: the user pays the native coin; the escrow holds (and a refund returns) the wrapped token `wrappedAsset`
`signatureEnvelope`	`ed25519-97` on Solana

executionTx:

approvals[]: {chainId, token, spender, amount} — send first.
steps[]: {chainId, to, data, value, description} — then send in order.
chainId is an integer on the hub’s proxy lanes and a chain-domain string on the external aggregator lane; accept both.
value is decimal wei. description names the proxy call (wrapAndOpen, swapAndOpenV2).

Behavior

A winner discloses at most one of signPayload and executionTx; which one, what to do with it, and the solver-swap and transfer cases that disclose neither: Step execution. The hub caches a quote round for about 30 seconds: the same request body inside that window answers with the same quoteId and its original expiresAt. Time a quote from when you first received its quoteId, not from your latest request.

Errors

Code	When
`EIN0001`	a form field (reference = the field), `body` (well-formed JSON of the wrong shape, or a body sent without a JSON `Content-Type`; a body that is not JSON at all is the framework’s `EMC0028`, reference `Body`), the asset-reference chain rule (`error_params` = `[reference chain, request chain]`), `maxAmountIn`, `swapType`, `x-infinity-subject` (a subject outside the hub’s rule)
`EIN0002`	an asset that does not resolve: no code at a token-in reference (`no ERC-20 at …`; a contract that is not an ERC-20 passes and typically fails as `EIN0008`), a chain with no swap router, an `eip155` chain the deployment doesn’t configure (`chain <id> has no corridor assets`), or a provider reporting the asset unresolved
`EIN0007`	the hub’s own fail-closed checks refused the round
`EIN0008`	no viable route — terminal for this request. `error_reference` `providerRefused` (a provider answered and refused — typically the amount is below its economic floor: offer another amount), `notFillable` with `error_params[0]` = the destination chain (no solver delivers there: offer another destination), or empty. A `maxAmountIn` under the price is `providerRefused`
`EIN0050`	availability — retry later. `error_params[0]` may carry the cause: `responseRejected` (answers discarded by the hub’s vetting), `solverUnavailable`, `providerMissed` (a provider missed the deadline), `upstreamAuth` (the aggregator refused the hub’s own credential — configuration; retrying does not help until an operator renews it). Also bare when the deployment has paused exposure, and `responseRejected` for a chain domain outside `eip155` that the deployment doesn’t configure (an unconfigured `eip155` chain is `EIN0002`)
`EIN0051`	the quote store was unavailable
`EIN0080`	the hub’s rate limit, charged to your organization (Limits) — `error_params[0]` is a suggested back-off in milliseconds: the time one request’s token takes to refill, `floor(1000 / infinity.auth.tenantRps)` and at least 1 (200 at the defaults), the same value on every shed
`EIN0081`	the hub is at its in-flight quote cap — 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 \
  -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. signPayload is the fixture typed data verbatim; signablePayload.quoteId is the provider’s own quote id, not the hub’s quoteId above it. The deadlines are the fixture’s too: witness.expires and orderExpiresAt (4102445200) fall in the year 2100. A live quote carries an orderExpiresAt about 1 800 s after issuedAt, and the firewall refuses one more than 24 h ahead, so a live hub would not serve this sample at its issuedAt.

{
  "success": true,
  "request_id": "8b9c0d1e-2f30-416b-9c6d-7e8f9a0b1c2d",
  "data": {
    "quoteRequestId": "01M34FSW4R9F2C4E7A1B3D5F80",
    "quoteId": "b9760d500009ec356eb2fc720c32cb77b8b0420a8e2b2deb6a97ce63ba64fb58",
    "issuedAt": "2026-09-22T12:00:15Z",
    "expiresAt": "2026-09-22T12:00:45Z",
    "executionClass": "PROVIDER_NATIVE_UNCOVERED",
    "amountIn": "1000000000000000",
    "amountOut": "32548366596169380000",
    "legs": [
      {
        "provider": "c8-solver",
        "product": "oif-escrow-v0",
        "version": "v0",
        "sourceChain": "eip155-1",
        "destChain": "eip155-56",
        "sourceAsset": "weth",
        "destAsset": "wbnb",
        "amountIn": "1000000000000000",
        "amountOut": "32548366596169380000"
      }
    ],
    "score": {
      "value": "30920948266360911000.000000",
      "scoringVersion": "score:v3",
      "candidatesEvaluated": 1,
      "providersMissedRound": 0
    },
    "policy": {
      "policyVersion": "pv1",
      "pathEpoch": "pe1",
      "scoringVersion": "score:v3"
    },
    "disclosure": {
      "signableHash": "leaf:v1:5c70e8deaaac78819757d29073bcc8dbdb299da6016a35e1e3017569a1202a40",
      "signablePayload": {
        "amountIn": "1000000000000000",
        "amountOut": "32548366596169380000",
        "deadline": "4102444900",
        "dependencyNodes": [
          {
            "destChain": "eip155-56",
            "family": "oif-escrow",
            "permit2": "0x000000000022d473030f116ddee9f6b43ac78ba3",
            "provider": "c8-solver",
            "sourceChain": "eip155-1",
            "spender": "0xf439808b5a80e3c355645b62310502817000cd1d"
          }
        ],
        "destAsset": "wbnb",
        "destChain": "eip155-56",
        "expires": 4102445200,
        "integrityChecksum": "5f2c8a1db06e4bb0a2f37e5d9c8b1a4e6f0d2c3b5a79881726354493827160aa",
        "kind": "oif-escrow-gasless",
        "nonce": "1786146443149",
        "oifSemanticVersion": 1,
        "orderExpiresAt": 4102445200,
        "payer": "0xf39fd6e51aad88f6f4ce6ab8827279cfffb92266",
        "permit2": "0x000000000022d473030f116ddee9f6b43ac78ba3",
        "productKey": "c8-solver:oif-escrow-v0:v0:eip155-1:std",
        "provider": "c8-solver",
        "quoteId": "e2e-quote-1",
        "recipient": "0xf39fd6e51aad88f6f4ce6ab8827279cfffb92266",
        "schemaVersion": 1,
        "signPayload": { "…": "the top-level signPayload below, verbatim — put it back here to reproduce signableHash" },
        "sourceAsset": "weth",
        "sourceChain": "eip155-1",
        "spender": "0xf439808b5a80e3c355645b62310502817000cd1d",
        "validUntil": 4102444800
      }
    },
    "signPayload": {
      "signatureType": "eip712",
      "domain": {
        "name": "Permit2",
        "chainId": 1,
        "verifyingContract": "0x000000000022D473030F116dDEE9F6B43aC78BA3"
      },
      "primaryType": "PermitBatchWitnessTransferFrom",
      "message": {
        "permitted": [
          { "token": "0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2", "amount": "1000000000000000" }
        ],
        "spender": "0xF439808b5A80E3C355645B62310502817000CD1D",
        "nonce": "1786146443149",
        "deadline": "4102444900",
        "witness": {
          "user": "0xf39Fd6e51aad88F6F4ce6aB8827279cffFb92266",
          "expires": 4102445200,
          "inputOracle": "0xDc64a140Aa3E981100a9becA4E685f962f0cF6C9",
          "outputs": [
            {
              "oracle": "0x0000000000000000000000002279b7a0a67db372996a5fab50d91eaa73d2ebe6",
              "settler": "0x0000000000000000000000008a791620dd6260079bf849dc5567adc3f2fdc318",
              "chainId": 56,
              "token": "0x000000000000000000000000bb4cdb9cbd36b01bd1cbaebf2de08d9173bc095c",
              "amount": "32548366596169380000",
              "recipient": "0x000000000000000000000000f39fd6e51aad88f6f4ce6ab8827279cfffb92266",
              "callbackData": "0x",
              "context": "0x"
            }
          ]
        }
      },
      "types": {
        "EIP712Domain": [
          { "name": "name", "type": "string" },
          { "name": "chainId", "type": "uint256" },
          { "name": "verifyingContract", "type": "address" }
        ],
        "MandateOutput": [
          { "name": "oracle", "type": "bytes32" },
          { "name": "settler", "type": "bytes32" },
          { "name": "chainId", "type": "uint256" },
          { "name": "token", "type": "bytes32" },
          { "name": "amount", "type": "uint256" },
          { "name": "recipient", "type": "bytes32" },
          { "name": "callbackData", "type": "bytes" },
          { "name": "context", "type": "bytes" }
        ],
        "Permit2Witness": [
          { "name": "user", "type": "address" },
          { "name": "expires", "type": "uint32" },
          { "name": "inputOracle", "type": "address" },
          { "name": "outputs", "type": "MandateOutput[]" }
        ],
        "PermitBatchWitnessTransferFrom": [
          { "name": "permitted", "type": "TokenPermissions[]" },
          { "name": "spender", "type": "address" },
          { "name": "nonce", "type": "uint256" },
          { "name": "deadline", "type": "uint256" },
          { "name": "witness", "type": "Permit2Witness" }
        ],
        "TokenPermissions": [
          { "name": "token", "type": "address" },
          { "name": "amount", "type": "uint256" }
        ]
      }
    },
    "signIntent": "{\"amountIn\":\"1000000000000000\",\"amountOut\":\"32548366596169380000\",\"kind\":\"infinity-signable-intent:dev-v1\",\"leaf\":\"leaf:v1:5c70e8deaaac78819757d29073bcc8dbdb299da6016a35e1e3017569a1202a40\",\"productKey\":\"c8-solver:oif-escrow-v0:v0:eip155-1:std\",\"quoteId\":\"b9760d500009ec356eb2fc720c32cb77b8b0420a8e2b2deb6a97ce63ba64fb58\",\"recipient\":\"0xf39fd6e51aad88f6f4ce6ab8827279cfffb92266\",\"schemaVersion\":1}",
    "etaSeconds": 30
  }
}

No executionTx or swapInput (the escrow lane discloses neither); no auction (this is a firm quote, not a decaying winner).

// client: your InteropClient (see /infinity-interop/sdk/installation)
const q = await client.getQuote({
  sourceChain: "eip155-1", destChain: "eip155-56",
  sourceAsset: "weth", destAsset: "wbnb",
  amount: "1000000000000000", recipient: "0xf39Fd6e51aad88F6F4ce6aB8827279cffFb92266",
  sourceAccount: "0xf39Fd6e51aad88F6F4ce6aB8827279cffFb92266", // the payer
});
q.response; // the answer above, unchanged
q.lane;     // what executing it involves

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