Prepare quote

POST /v1/quote/prepare Prepare one chosen provider under a stable preparationId. The result is a normal, signable QuoteResponse; a retry with the same id returns the same stored quote.

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

Request

Request body

The QuoteRequest fields plus:

Field	Type	Required	Rules	Meaning
`provider`	string	yes	1–128 characters	the provider picked from a preview offer
`preparationId`	string	yes	`^[A-Za-z0-9_-]{16,128}$`	one id per deliberate signing attempt — a UUID works

Response

data: QuoteResponse, as POST /quote.

Behavior

Replay: a stored preparation under this id is returned as-is, with its original expiresAt — a retry never extends it. The inputs, the organization and the provider must match the stored one, or it is EIN0001 (reference preparationId). A stored preparation that has expired (or whose configuration moved on) is EIN0005: create a new id.
Only the named provider is asked. No winner is EIN0008 with an empty reference.
The prepared transaction template is stored with the quote, so a prepared quote can be submitted through any hub replica sharing the event store.

Errors

Code	When
(`POST /quote` codes)	see `POST /quote`
`EIN0001`	reference `preparationId/provider` (a malformed id or provider)
`EIN0001`	reference `preparationId` (the id reused with different inputs)
`EIN0005`	the stored preparation expired

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/prepare \
  -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","provider":"<provider from a POST /quote/preview offer>","preparationId":"0d5b1f44-64aa-44ad-8ffb-f576b55e9ac2"}'

Response

Illustrative values; formats follow the Response table. Identical shape to POST /quote; the ids differ because prepare derives the round id from your organization and preparationId. signablePayload.quoteId is the provider’s own quote id, not the hub’s quoteId above it. The year-2100 deadlines are the test fixture’s, which a live hub would not serve (POST /quote — example).

{
  "success": true,
  "request_id": "0d1e2f30-4152-438d-be8f-9a0b1c2d3e4f",
  "data": {
    "quoteRequestId": "ba09213b767a4060c13fa044c2cd07881f91586253231b9f418bf6b4ace2b155",
    "quoteId": "d81346ecccae20db0ae167581128091e3d6cad874626d601c0716d5725ba8e28",
    "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\":\"d81346ecccae20db0ae167581128091e3d6cad874626d601c0716d5725ba8e28\",\"recipient\":\"0xf39fd6e51aad88f6f4ce6ab8827279cfffb92266\",\"schemaVersion\":1}",
    "etaSeconds": 30
  }
}

No executionTx or swapInput (the escrow lane discloses neither); no auction (firm quote).

import type { QuoteRequest } from "@c8ntinuum/infinity-interop-sdk";

// client: your InteropClient (see /infinity-interop/sdk/installation)
const req: QuoteRequest = {
  sourceChain: "eip155-1", destChain: "eip155-56",
  sourceAsset: "weth", destAsset: "wbnb",
  amount: "1000000000000000", recipient: "0xf39Fd6e51aad88F6F4ce6aB8827279cffFb92266",
};
const preview = await client.previewQuotes(req);
const offer = preview.offers?.[0];
if (offer?.provider) {
  const q = await client.prepareQuote(req, offer.provider); // a fresh preparationId unless you pass one
}

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