Dynamic Pricing

LI.FI 企业级功能的定价按每个集成单独协商，而非固定费率表。LI.FI 会根据你的交易量、链和所运行的业务组合来定制商业模式。

为什么按集成单独定价

企业级集成之间的差异很大。以稳定币为主的支付流程和波动性资产交易流程的经济模型截然不同，单一固定费率要么让薄利润的流程被多收费，要么让其余流程定价过低。因此 LI.FI 会依据你所在集成的具体特征来设定价格。

影响费率的因素

交易量。 更高的承诺交易量会影响费率。
路由类型。 同链和跨链的定价不同。
代币类型。 稳定币兑稳定币的流程费率可以低于波动性资产交换。
功能组合。 你启用了哪些企业级功能，以及它们的应用方式。

DYNAMIC 费用类型

Dynamic Pricing 仅面向获批的企业级集成，开通方式与 LI.FI 协商确定。未加入 Dynamic Pricing 的集成按费用与盈利中所述的标准固定 LI.FI 服务费计费。开通后，你的集成会切换为 DYNAMIC 费用类型。LI.FI 会针对每笔报价，依据你的商业模式解析出自身费率（参见影响费率的因素）。费用类型只改变 LI.FI 费率的确定方式。解析出的金额作为报价上一条普通费用条目返回，并遵循与其他费用相同的 included 逻辑。你自己的集成商 fee 不受影响，会全额支付到你配置的费用钱包。

逐请求解析

每笔报价，LI.FI 会根据以下输入解析自身费率：

请求的 fromAmount。
源代币和目标代币：chain ID、地址，以及 stablecoin 等 token tags。
链对：同链或跨链。
你的集成商 fee（如有设置）。

同一集成的两笔报价在这些输入不同时，费率也可能不同。具体权重属于你的商业条款，不对外公布。请以返回报价中的数值为准，不要在客户端重建。

Fail-closed 行为

DYNAMIC 不会回退到标准固定费用，解析失败也不会变成零费用报价。下表中的错误码参见 Error codes。

情况	结果
LI.FI 无法解析费用（服务中断、超时、集成不存在）	HTTP `424`，错误码 `1008`（`ThirdPartyError`）
源链不受支持	请求校验可能在费用解析前以 HTTP `400`、错误码 `1011` 拒绝报价。上面的 `424` / `1008` 适用于费用解析阶段的失败，并非所有不支持的链请求。接入新链前请先联系你的 LI.FI 对接人。
设置了 `fee`，但该集成在源链上没有费用钱包	HTTP `400`，错误码 `1011`（`ValidationError`）。请在 LI.FI Portal 配置钱包。
设置了 `intermediary`	HTTP `400`，错误码 `1011`。`DYNAMIC` 不支持 intermediary fee。

已解析费用出现的位置

像往常一样通过 GET /v1/quote 请求报价。先设置 API key：

export LIFI_API_KEY=your-api-key

以下示例对从 Ethereum 到 Polygon 的 1,000 USDC 收取 0.5% 集成商费用：

curl -X GET 'https://li.quest/v1/quote?fromChain=1&toChain=137&fromToken=0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48&toToken=0x2791Bca1f2de4661ED88A30C99A7a9449Aa84174&fromAddress=0x1234567890123456789012345678901234567890&fromAmount=1000000000&integrator=your-integrator-id&fee=0.005' \
  --header "x-lifi-api-key: $LIFI_API_KEY"

const params = new URLSearchParams({
  fromChain: '1',
  toChain: '137',
  fromToken: '0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48',
  toToken: '0x2791Bca1f2de4661ED88A30C99A7a9449Aa84174',
  fromAddress: '0x1234567890123456789012345678901234567890',
  fromAmount: '1000000000',
  integrator: 'your-integrator-id',
  fee: '0.005',
})

const response = await fetch(`https://li.quest/v1/quote?${params}`, {
  headers: { 'x-lifi-api-key': process.env.LIFI_API_KEY! },
})
const quote = await response.json()
if (!response.ok) {
  throw new Error(`Quote request failed (HTTP ${response.status}): ${JSON.stringify(quote)}`)
}

const feeEntry = quote.estimate?.feeCosts?.find((cost) =>
  cost.feeSplit?.recipients?.some((r) => r.type === 'DYNAMIC')
)
if (!feeEntry) {
  throw new Error('No DYNAMIC fee entry found. Do not interpret this as a zero fee; confirm your integration configuration with LI.FI.')
}

解析出的 LI.FI 费用和你的集成商费用会合并为 estimate.feeCosts 中的一条记录返回，没有单独的顶层 dynamicFee 字段。假设解析出的 LI.FI 费率为 0.1%，上述请求对应的条目如下：

{
  "name": "LIFI Fixed Fee",
  "description": "Fixed LIFI fee, independent of any other fee",
  "percentage": "0.0060",
  "token": { "address": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48", "chainId": 1, "symbol": "USDC", "decimals": 6 },
  "amount": "6000000",
  "amountUSD": "6.00",
  "included": true,
  "feeSplit": {
    "lifiFee": "1000000",
    "integratorFee": "5000000",
    "recipients": [
      { "name": "lifi", "fee": "1000000", "type": "DYNAMIC" },
      { "name": "your-integrator-id", "fee": "5000000", "type": "DYNAMIC" }
    ]
  }
}

字段	含义
`amount`、`amountUSD`	LI.FI 费用与你的集成商费用之和，分别以 `token` 的最小单位和美元表示。
`percentage`	总费率，表示为 `fromAmount` 的分数，保留四位小数。
`included`	`true`：已从报价的 `toAmount` 中扣除。`false`：在 `fromAmount` 之外额外收取。参见 Gas costs and fee costs。
`name`、`description`	展示用标签。`DYNAMIC` 报价显示为 `LIFI Fixed Fee`。请勿用它们判断费用类型。
`feeSplit.lifiFee`、`feeSplit.integratorFee`	LI.FI 解析出的份额和你的集成商费用，以 `token` 的最小单位表示。
`feeSplit.recipients[]`	每个接收方一条记录。`type` 为 `FIXED`、`SHARED`、`DYNAMIC`、`INTERMEDIARY`、`DISTRIBUTION` 之一。后续可能新增取值，请保留默认分支。

要判断报价是否使用了 Dynamic Pricing，请查找 type: "DYNAMIC" 的接收方记录。

透明度

每笔解析出的费用都会随报价返回，因此适用费率对你可见，并可逐笔审计。feeSplit 会分别展示 LI.FI 的份额和你的集成商费用。你的集成商费用会全额支付到你配置的费用钱包。集成商费用的收取方式见集成盈利。

如何设置

定价在你的集成配置阶段协商确定，后续也可以调整。

联系 LI.FI 团队

告诉我们你的交易量和所运行的业务流程。我们会提出与之匹配的商业模式方案。

​为什么按集成单独定价

​影响费率的因素

​DYNAMIC 费用类型

​逐请求解析

​Fail-closed 行为

​已解析费用出现的位置

​透明度

​如何设置