求解器 API 概述

求解器 API 是供求解器提交报价、管理账户和跟踪信誉的、需要身份验证的接口。所有求解器端点都需要 API 密钥。

有关面向集成商的端点（报价、订单、状态跟踪），请参阅 Intents API 概述。

基础 URL

环境	基础 URL	求解器 UI
Production	`https://order.li.fi`	intents.li.fi
Testnet	`https://order-dev.li.fi`	devintents.li.fi

两个环境上均可在 /docs 获取交互式 API 文档。

身份验证

所有求解器 API 端点都需要通过 x-api-key 请求头传入 API 密钥。请在上面链接的求解器 UI 中注册密钥。有关完整细节，请参阅身份验证。

curl -X POST 'https://order.li.fi/quotes/submit' \
  -H 'Content-Type: application/json' \
  -H 'x-api-key: YOUR_SOLVER_API_KEY' \
  -d '{ ... }'

不要把 API 密钥留在客户端代码或版本控制中——请从环境变量或密钥存储中加载它。

端点

报价管理

Method	Path	说明
`POST`	`/quotes/submit`	一次提交或更新最多 20 万条求解器报价
`GET`	`/solver-api/quotes`	获取你当前已上传的报价库存

报价定义了你愿意填充的路由、价格曲线和金额范围。订单服务器使用你的报价来匹配意图，因此你无需响应单个报价请求。有关完整的报价格式和策略，请参阅报价订单。

账户管理

注册你用来填充的账户，以便订单服务器能够将你的链上活动关联到你的求解器身份：

Method	Path	说明
`GET`	`/api/v1/solver/register/message`	获取用于签名的一次性消息（24 小时内有效，仅可使用一次）
`POST`	`/api/v1/solver/register`	注册求解器账户——支持 EVM ECDSA、EIP-1271 或 Solana ed25519 签名
`POST`	`/api/v1/solver/unregister`	注销求解器账户

完整流程请参阅注册账户。旧版 V0 端点 /solver-api/account/register 和 /solver-api/account/unregister（仅支持 EVM 签名，无服务器签发的消息）仍可供现有集成使用。

支持的合约

Method	Path	说明
`GET`	`/api/v1/solver/supported-contracts`	读取你已声明的预言机 / 输入结算器 / 输出结算器集合
`PUT`	`/api/v1/solver/supported-contracts`	替换整个集合（CAIP-2 的 `{chain, address}` 条目）

你声明的合约集合决定了你的报价可以服务哪些路由。

信誉

Method	Path	说明
`GET`	`/solver-api/solver/identities`	获取为信誉跟踪注册的求解器身份
`GET`	`/api/v1/solver/reliability`	获取您当前的状态、当前生效的暂停、进行中的恢复考核，以及未按时填充次数
`GET`	`/api/v1/solver/reliability/pauses`	列出您的暂停历史，按时间从新到旧排列

哪些订单会被计入以及您何时可能被暂停，请参阅信誉。

订单收集

求解器通过两种渠道接收订单：

WebSocket（推荐）： 连接到订单服务器以进行实时订单流传输。
链上监控： 监视 InputSettlerEscrow 或 InputSettlerCompact 合约上的 Open 事件。

有关连接细节和订单验证，请参阅订单流。

求解器流程摘要

Register account → Submit quotes → Receive orders → Fill outputs → Validate via oracle → Settle

步骤	你要做的事	参考
注册（Register）	通过 `/api/v1/solver/register` 注册你的账户	本页
报价（Quote）	将库存推送到 `/quotes/submit`	报价
接收（Receive）	连接到 WebSocket 或监控链上事件	订单流
填充（Fill）	通过 `OutputSettlerSimple.fill()` 交付资产	解算 LI.FI Intents
证明（Prove）	通过预言机系统提交填充证明	预言机系统
结算（Settle）	在输入结算器上调用 `finalise` 以收款	结算

后续步骤

解算 LI.FI Intents

完整的求解器集成指南，含订单类型与填充

报价订单

报价格式、价格曲线与库存管理

订单流

WebSocket 连接、订单验证与链上监控

身份验证

API 密钥注册与环境细节

入门

Intents API

Solver API

MCP Server

架构

知识库

求解器 API 概述

基础 URL

身份验证

端点

报价管理

账户管理

支持的合约

信誉

订单收集

求解器流程摘要

后续步骤

解算 LI.FI Intents

报价订单

订单流

身份验证

​基础 URL

​身份验证

​端点

​报价管理

​账户管理

​支持的合约

​信誉

​订单收集

​求解器流程摘要

​后续步骤

解算 LI.FI Intents

报价订单

订单流

身份验证

基础 URL

身份验证

端点

报价管理

账户管理

支持的合约

信誉

订单收集

求解器流程摘要

后续步骤