Skip to main content
API 预设为 LI.FI API 提供了经过调优的路由默认值。当你传入一个预设时，LI.FI 会加载该预设的默认值，并在其上合并任何请求特定的选项。你显式提供的值始终优先，因此你可以从一个预设开始，并有选择地覆盖你关心的部分。

​
支持的端点

​
预设的应用方式

  1. LI.FI 加载预设默认值。
  2. LI.FI 在这些默认值之上合并你的请求选项。
  3. 任何冲突的键都会回退到你在请求体或查询字符串中提供的值。
这样既能保持请求简洁，又能保留完全的控制权。

​
处理流程

  1. 校验请求的预设名称是否存在且处于启用状态。
  2. 加载预设配置（默认值、工具偏好等），若不可用则使用内置默认值。
  3. 将预设默认值合并到请求负载或查询参数中。
  4. 应用用户提供的覆盖值，使显式值优先。
  5. 记录解析出的预设，以便观测和排障。
如果校验失败，例如因为预设名称不符合所需的模式，API 将返回 HTTP 400。

​
预设名称

预设可以通过以下方式引用：
  • 通用名称，例如 stablecoin
  • 具体名称，例如 stablecoin-cheapest
查看所有可用预设。 一个通用名称可以映射到一个具体的预设。例如，stablecoin 默认解析为 stablecoin-cheapest。当出现新配置（如 stablecoin-fastest）或合作伙伴专属变体（如 stablecoin-partnerX）时，LI.FI 可能会将其他预设提升到同一个通用名称之下。

​
使用 preset 参数

​
高级路由

在 options 对象内提供预设。

​
报价

将预设作为查询参数发送。

​
可用预设

随着更多预设的发布，我们会陆续为其补充文档。