> ## Documentation Index
> Fetch the complete documentation index at: https://docs.li.fi/llms.txt
> Use this file to discover all available pages before exploring further.

# API 预设

> 为 LI.FI 报价和高级路由端点预配置的路由默认值。

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

## 支持的端点

* [`POST /v1/advanced/routes`](/api-reference/advanced/get-a-set-of-routes-for-a-request-that-describes-a-transfer-of-tokens)
* [`GET /v1/quote`](/api-reference/get-a-quote-for-a-token-transfer)

## 预设的应用方式

1. LI.FI 加载预设默认值。
2. LI.FI 在这些默认值之上合并你的请求选项。
3. 任何冲突的键都会回退到你在请求体或查询字符串中提供的值。

这样既能保持请求简洁，又能保留完全的控制权。

## 处理流程

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

如果校验失败，例如因为预设名称不符合所需的模式，API 将返回 HTTP `400`。

## 预设名称

预设可以通过以下方式引用：

* **通用名称**，例如 `stablecoin`
* **具体名称**，例如 `stablecoin-cheapest`

查看所有[可用预设](/api-reference/presets/overview#available-presets)。

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

## 使用 preset 参数

### 高级路由

在 `options` 对象内提供预设。

```json theme={"system"}
{
  "fromChainId": 1,
  "toChainId": 137,
  "fromAmount": "1000000000000000000",
  "fromTokenAddress": "0xA0b86a33E6441b8C4C8C0C4C0C4C0C4C0C4C0C4C",
  "toTokenAddress": "0x2791Bca1f2de4661ED88A30C99A7a9449Aa84174",
  "options": {
    "preset": "stablecoin"
  }
}
```

### 报价

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

```
GET /v1/quote?fromChain=1&toChain=137&fromToken=0xA0b86a33E6441b8C4C8C0C4C0C4C0C4C0C4C0C4C&toToken=0x2791Bca1f2de4661ED88A30C99A7a9449Aa84174&fromAddress=0x123...&fromAmount=1000000000000000000&preset=stablecoin
```

## 可用预设

* [Stablecoin 预设](/api-reference/presets/stablecoin)
* Commerce 预设（即将推出）

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