请求报价

订单服务器缓存来自求解器网络的报价。在开启订单之前，调用 POST /api/v1/integrator/quote/request 来获取意图的定价。使用订单服务器获取报价是可选的，但推荐使用。它将意图与求解器的常驻报价进行匹配，并提供更强的执行保证。无需身份验证。您可以选择性地传入 X-Integrator-Key 请求头：设置该头后，订单服务器只会返回标记给该密钥的求解器报价。它不会包含公开市场报价，也不会回退到公开市场报价，因此如果没有求解器为您的密钥标记过报价，您将得不到任何报价。

请求格式

每一个用于标识账户或资产的字段，都是一个原生地址加上一个 CAIP-2 链 id（Base 为 eip155:8453，Tron 为 tron:728126428，Solana 主网为 solana:1151111081099710）。下面的示例请求从 Base 到 Arbitrum 的 USDC 报价（exact-input）：

curl -X POST 'https://order.li.fi/api/v1/integrator/quote/request' \
  -H 'Content-Type: application/json' \
  -d '{
    "user": {
      "chain": "eip155:8453",
      "address": "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"
    },
    "intent": {
      "intentType": "oif-swap",
      "inputs": [{
        "chain": "eip155:8453",
        "user": "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045",
        "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
        "amount": "10000000"
      }],
      "outputs": [{
        "chain": "eip155:42161",
        "receiver": "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045",
        "asset": "0xaf88d065e77c8cC2239327C5EDb3A432268e5831",
        "amount": null
      }],
      "swapType": "exact-input"
    },
    "supportedTypes": ["oif-user-open-v0"]
  }'

const response = await fetch('https://order.li.fi/api/v1/integrator/quote/request', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({
    user: {
      chain: 'eip155:8453',
      address: '0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045',
    },
    intent: {
      intentType: 'oif-swap',
      inputs: [{
        chain: 'eip155:8453',
        user: '0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045',
        asset: '0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913',  // USDC on Base
        amount: '10000000',  // 10 USDC (6 decimals)
      }],
      outputs: [{
        chain: 'eip155:42161',
        receiver: '0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045',
        asset: '0xaf88d065e77c8cC2239327C5EDb3A432268e5831',  // USDC on Arbitrum
        amount: null,
      }],
      swapType: 'exact-input',
    },
    supportedTypes: ['oif-user-open-v0'],
  }),
});

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

如果没有匹配的求解器报价，响应会是 200 且 "quotes": []，而不是错误。

请求字段

字段	类型	描述
`user`	object	`{ chain, address }`——CAIP-2 链 id 加上用户的原生地址（失败时的退款接收方）
`intent.intentType`	string	始终为 `"oif-swap"`
`intent.inputs[]`	array	输入资产，每项为 `{ chain, user, asset, amount }`，地址均为原生格式
`intent.outputs[]`	array	期望的输出，每项为 `{ chain, receiver, asset, amount }`（exact-input 时 `amount` 为 `null`）
`intent.swapType`	string	`"exact-input"` 固定输入数额并让求解器确定输出（将 `outputs[].amount` 设为 `null`）。这是最常用的模式。`"exact-output"` 固定输出数额并让求解器确定所需的输入（将 `inputs[].amount` 设为 `null`）。当目标数额很重要时使用它，例如偿还贷款或满足合约要求。
`supportedTypes`	array	你的集成所支持的订单类型。传入 `["oif-user-open-v0"]`——每条报价都会返回一笔用于开启订单的源链交易。
`intent.metadata.exclusiveFor`	string 或 array	可选。将报价查找限制为特定的求解器地址。对合规或合作伙伴关系很有用，但过度限制会降低填充可靠性。

请求的结构在所有链上都相同——下面的示例只是替换了 chain 值和地址格式。

Solana 请求

Solana 使用 solana:1151111081099710（主网；devnet 为 solana:1151111081099712）和 base58 地址。以下是一个从 Solana 到 EVM 的示例：

curl -X POST 'https://order.li.fi/api/v1/integrator/quote/request' \
  -H 'Content-Type: application/json' \
  -d '{
    "user": {
      "chain": "solana:1151111081099710",
      "address": "8YLKoCu7NwqHNS8GzuvA2ibsvLrsg22YMfMDafxh1B15"
    },
    "intent": {
      "intentType": "oif-swap",
      "inputs": [{
        "chain": "solana:1151111081099710",
        "user": "8YLKoCu7NwqHNS8GzuvA2ibsvLrsg22YMfMDafxh1B15",
        "asset": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
        "amount": "1000000"
      }],
      "outputs": [{
        "chain": "eip155:8453",
        "receiver": "0x9773DAcbc46CAFb4e055060565e319922B48607D",
        "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
        "amount": null
      }],
      "swapType": "exact-input"
    },
    "supportedTypes": ["oif-user-open-v0"]
  }'

const response = await fetch('https://order.li.fi/api/v1/integrator/quote/request', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({
    user: {
      chain: 'solana:1151111081099710',
      address: '8YLKoCu7NwqHNS8GzuvA2ibsvLrsg22YMfMDafxh1B15',
    },
    intent: {
      intentType: 'oif-swap',
      inputs: [{
        chain: 'solana:1151111081099710',
        user: '8YLKoCu7NwqHNS8GzuvA2ibsvLrsg22YMfMDafxh1B15',
        asset: 'EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v', // USDC on Solana
        amount: '1000000',
      }],
      outputs: [{
        chain: 'eip155:8453',
        receiver: '0x9773DAcbc46CAFb4e055060565e319922B48607D',
        asset: '0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913', // USDC on Base
        amount: null,
      }],
      swapType: 'exact-input',
    },
    supportedTypes: ['oif-user-open-v0'],
  }),
});

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

完整的 Solana 差异列表见 Solana vs EVM。关于请求字段有两条 Solana 专属的规则：

Solana 一端请使用 solana: 命名空间。 如果 Solana 一端使用 eip155: 报价，会被拒绝——而且错误信息描述的是该资产的编码问题（一个十六进制格式或 bytes32 相关的抱怨，具体取决于地址给出的方式），而不是真正导致问题的命名空间错误。
接收方必须是曲线上的钱包公钥。 对于 Solana 输出，API 会拒绝将 PDA 或其他不在曲线上的地址用作 receiver。

Tron 请求

Tron 使用 tron:728126428 和 base58 格式的 T… 地址（也接受带 0x 前缀的 20 字节十六进制；响应始终以 base58 渲染）。以下是一个从 Tron 到 EVM 的示例：

curl -X POST 'https://order.li.fi/api/v1/integrator/quote/request' \
  -H 'Content-Type: application/json' \
  -d '{
    "user": {
      "chain": "tron:728126428",
      "address": "TYYUrA6nV1EYxQqo7RiBJh6roFq4mtiBLT"
    },
    "intent": {
      "intentType": "oif-swap",
      "inputs": [{
        "chain": "tron:728126428",
        "user": "TYYUrA6nV1EYxQqo7RiBJh6roFq4mtiBLT",
        "asset": "TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t",
        "amount": "10000000"
      }],
      "outputs": [{
        "chain": "eip155:8453",
        "receiver": "0x841F63697cFa0e3B54c4D42b3d679F07F7F2485f",
        "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
        "amount": null
      }],
      "swapType": "exact-input"
    },
    "supportedTypes": ["oif-user-open-v0"]
  }'

const response = await fetch('https://order.li.fi/api/v1/integrator/quote/request', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({
    user: {
      chain: 'tron:728126428',
      address: 'TYYUrA6nV1EYxQqo7RiBJh6roFq4mtiBLT',
    },
    intent: {
      intentType: 'oif-swap',
      inputs: [{
        chain: 'tron:728126428',
        user: 'TYYUrA6nV1EYxQqo7RiBJh6roFq4mtiBLT',
        asset: 'TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t', // USDT (TRC-20)
        amount: '10000000',
      }],
      outputs: [{
        chain: 'eip155:8453',
        receiver: '0x841F63697cFa0e3B54c4D42b3d679F07F7F2485f',
        asset: '0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913', // USDC on Base
        amount: null,
      }],
      swapType: 'exact-input',
    },
    supportedTypes: ['oif-user-open-v0'],
  }),
});

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

Tron 仅支持 Escrow 结算——没有 Compact / 资源锁流程。地址转换规则和完整的差异列表见 Tron vs EVM。

响应格式

interface QuoteResponse {
  quotes: {
    order: {
      type: 'oif-user-open-v0';
      openIntentTx: OpenIntentTx;  // varies by origin chain — see below
      checks: {
        allowances: {
          chain: string;
          token: string;
          user: string;
          spender: string;
          required: string;
        }[];
      };
    };
    validUntil: number;
    quoteId: string;         // e.g. "quote_yCyE5aWW4NILo2UdM-8ETpia05TCLv"
    provider: 'LI.FI Intent';
    preview: {
      inputs: { chain: string; user: string; asset: string; amount: string }[];
      outputs: { chain: string; receiver: string; asset: string; amount: string }[];
    };
    metadata: {
      exclusiveFor: string | null;
    };
    partialFill: boolean;
    failureHandling: string; // e.g. "refund-automatic"
  }[];
}

最佳报价始终位于索引 0 处。

响应字段

字段	描述
`order.openIntentTx`	用于开启订单的、可直接签名的源链交易。其结构取决于源链——见开启交易。
`order.checks.allowances`	在发送该交易之前必须满足的授权和余额检查。每一项都断言用户为 `spender` 持有并已授权至少 `required` 数量的 `token`。在 Solana 上始终为 `[]`。
`validUntil`	报价过期之后的 Unix 时间戳。如果过期则重新获取。
`quoteId`	将您的订单与此报价关联起来的引用 ID，用于优先的求解器匹配。
`preview.inputs` / `preview.outputs`	此报价的预期输入和输出数额。仅供参考——签名前请与订单本身核对。
`metadata.exclusiveFor`	为此报价选择的求解器地址，或 `null`。
`partialFill`	求解器是否支持此报价的部分填充。
`failureHandling`	如何处理失败（例如 `"refund-automatic"`）。

开启交易

order.openIntentTx 始终携带 chain、to 和 data，外加一个与链相关的费用字段：

源链	`to`	`data`	费用字段
EVM	输入结算器（校验和格式的十六进制）	交易 calldata（十六进制）	`gasRequired`——gas 预估值，十进制字符串
Solana	输入结算器程序 id（base58）	Base58 序列化的 `VersionedTransaction`	`computeUnitsRequired`——计算单元预估值，十进制字符串
Tron	输入结算器（base58check）	完整的 ABI calldata（十六进制）——需包裹进 `TriggerSmartContract` 信封	`feeLimit`——以 SUN 计的能量上限，十进制字符串

发送前，各链所需的处理方式：

EVM：在广播 calldata 之前，满足 checks.allowances 中的每一项（ERC-20 的 approve 或 Permit2）。
Solana：序列化交易中的 recentBlockhash 是一个全零的占位值（11111111111111111111111111111111），必须在签名前替换为一个新的区块哈希。序列化后的消息不包含 Compute Budget 指令；请在签名前，用 computeUnitsRequired 构造一个 ComputeBudgetProgram.setComputeUnitLimit 指令并重建消息。checks.allowances 始终为 []：SPL 转账发生在 open 指令内部，因此不存在预先授权的步骤。
Tron：data 是 calldata，而不是一笔现成的交易——请通过 TronWeb 的 triggerSmartContract 将其包裹起来，并先授权 TRC-20 输入。feeLimit 是能量花费的上限，而非估算值。

各链上具体的签名并发送流程见创建并提交订单。

独占求解器匹配

metadata.exclusiveFor 字段标识了被选定来领取输入的求解器，因此它使用的是输入链的原生地址格式。当一条报价胜出时，订单服务器会将该身份和独占窗口编码进所构建订单的输出 context 中。

入门

Intents API

Solver API

MCP Server

架构

知识库

请求格式

请求字段

Solana 请求

Tron 请求

响应格式

响应字段

开启交易

独占求解器匹配

后续步骤

创建并提交订单

跟踪订单状态

​请求格式

​请求字段

​Solana 请求

​Tron 请求

​响应格式

​响应字段

​开启交易

​独占求解器匹配

​后续步骤

创建并提交订单

跟踪订单状态

请求格式

请求字段

Solana 请求

Tron 请求

响应格式

响应字段

开启交易

独占求解器匹配

后续步骤