Request a Quote

The order server caches quotes from its solver network. Call POST /quote/request to get pricing for an intent before constructing an order. Using the order server for quotes is optional but recommended. It matches intents against solver standing quotes and gives stronger execution guarantees.

For simpler integrator parameter handling, a V1 quote endpoint is also available at POST /api/v1/integrator/quote/request. It takes CAIP-2 chains plus native addresses (e.g. { "chain": "tron:728126428", "address": "T…" }), which makes it the recommended path for Tron — see Tron vs EVM.

Request Format

curl -X POST 'https://order.li.fi/quote/request' \
  -H 'Content-Type: application/json' \
  -d '{
    "user": "0x0001000002210514d8dA6BF26964aF9D7eEd9e03E53415D37aA96045",
    "intent": {
      "intentType": "oif-swap",
      "inputs": [{
        "user": "0x0001000002210514d8dA6BF26964aF9D7eEd9e03E53415D37aA96045",
        "asset": "0x0001000002210514833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
        "amount": "10000000"
      }],
      "outputs": [{
        "receiver": "0x0001000002A4B114d8dA6BF26964aF9D7eEd9e03E53415D37aA96045",
        "asset": "0x0001000002A4B114af88d065e77c8cC2239327C5EDb3A432268e5831",
        "amount": null
      }],
      "swapType": "exact-input"
    },
    "supportedTypes": ["oif-escrow-v0"]
  }'

const response = await fetch('https://order.li.fi/quote/request', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({
    user: '0x0001000002210514d8dA6BF26964aF9D7eEd9e03E53415D37aA96045',
    intent: {
      intentType: 'oif-swap',
      inputs: [{
        user: '0x0001000002210514d8dA6BF26964aF9D7eEd9e03E53415D37aA96045',
        asset: '0x0001000002210514833589fCD6eDb6E08f4c7C32D4f71b54bdA02913',  // USDC on Base
        amount: '10000000',  // 10 USDC (6 decimals)
      }],
      outputs: [{
        receiver: '0x0001000002A4B114d8dA6BF26964aF9D7eEd9e03E53415D37aA96045',
        asset: '0x0001000002A4B114af88d065e77c8cC2239327C5EDb3A432268e5831',  // USDC on Arbitrum
        amount: null,
      }],
      swapType: 'exact-input',
    },
    supportedTypes: ['oif-escrow-v0'],
  }),
});

const { quotes } = await response.json();

Request Fields

Field	Type	Description
`user`	string	Interoperable address of the user (refund recipient on failure)
`intent.intentType`	string	Always `"oif-swap"`
`intent.inputs[]`	array	Input assets with `user`, `asset` (interoperable address), and `amount`
`intent.outputs[]`	array	Desired outputs with `receiver`, `asset`, and `amount` (`null` for exact-input)
`intent.swapType`	string	`"exact-input"` fixes the input amount and lets the solver determine the output (set `outputs[].amount` to `null`). This is the most common mode. `"exact-output"` fixes the output amount and lets the solver determine the required input (set `inputs[].amount` to `null`). Use this when the destination amount matters, for example to repay a loan or meet a contract requirement.
`supportedTypes`	array	Resource lock types the user supports. Use `"oif-escrow-v0"` for standard escrow integrations; include `"oif-resource-lock-v0"` only if your flow supports Compact/resource-lock claims. On Tron, use `"oif-escrow-v0"` only — Compact/resource locks are not available (Tron vs EVM).
`intent.metadata.exclusiveFor`	array	Optional. Restrict quotes to specific solver addresses. Useful for compliance or partnerships, but over-restriction can reduce fill reliability.

Response Format

interface QuoteResponse {
  quotes: {
    order: null;
    validUntil: number;
    quoteId: string;         // e.g. "quote_yCyE5aWW4NILo2UdM-8ETpia05TCLv"
    preview: {
      inputs: { user: string; asset: string; amount: string }[];
      outputs: { receiver: string; asset: string; amount: string }[];
    };
    metadata: {
      exclusiveFor: string | null;
    };
    partialFill: boolean;
    failureHandling: string; // e.g. "refund-automatic"
  }[];
}

The best quote is always at index 0. Save the quoteId for use when submitting the order.

Response Fields

Field	Description
`validUntil`	Unix timestamp after which the quote expires. Re-fetch if stale.
`quoteId`	Reference ID to include when submitting an order for preferential solver matching.
`preview.inputs` / `preview.outputs`	The expected input and output amounts for this quote.
`metadata.exclusiveFor`	The solver address selected for this quote, or `null`.
`partialFill`	Whether the solver supports partial fills for this quote.
`failureHandling`	How failures are handled (e.g. `"refund-automatic"`).

Exclusive Solver Matching

The metadata.exclusiveFor field in the response identifies the solver selected for this quote. If you want to enforce exclusivity when constructing the order, encode the solver address and an expiry into the output’s context field:

const exclusiveFor = bestQuote.metadata.exclusiveFor;
if (exclusiveFor) {
  const currentTime = Math.floor(Date.now() / 1000);
  const exclusiveExpiry = (currentTime + 60).toString(16);
  const paddedExclusiveFor = exclusiveFor.replace('0x', '').padStart(64, '0');
  mandateOutput.context = `0xe0${paddedExclusiveFor}${exclusiveExpiry}`;
}

Apply exclusivity only if you fully control solver policy and fallback behavior.

Getting Started

Intents API

Solver API

MCP Server

Architecture

Knowledge Base

Request a Quote

Request Format

Request Fields

Response Format

Response Fields

Exclusive Solver Matching

Next Steps

Create and Submit Orders

Track Order Status

​Request Format

​Request Fields

​Response Format

​Response Fields

​Exclusive Solver Matching

​Next Steps

Create and Submit Orders

Track Order Status

Request Format

Request Fields

Response Format

Response Fields

Exclusive Solver Matching

Next Steps