跳转到主要内容
Intents API 是面向集成方的接口,用于请求报价、提交订单和跟踪状态。所有端点均为开放的,无需 API 密钥。
关于面向求解器的端点(报价提交、账户管理),请参阅 Solver API 概述。关于认证详情,请参阅认证。

Base URL

两个环境上都提供交互式 API 文档,地址为 /docs。

端点

平台差异

在所有链上,报价与跟踪的流程都是一样的:请求 V1 报价,签名并发送返回的交易,然后轮询 /orders/status。差异主要在边缘细节上:
  • EVM:发送前需满足 checks.allowances;链下流程(无 gas 托管、已签名的 Compact 领取)可以改用 POST /orders/submit。参见创建并提交订单。
  • Tron:将返回的 calldata 包裹在 TriggerSmartContract 信封中;仅支持 Escrow 结算。参见 Tron vs EVM。
  • Solana:在签名之前,用返回的计算单元限制和一个新的区块哈希重建交易模板;仅限链上——POST /orders/submit 不接受 Solana 订单。参见 Solana vs EVM。

订单生命周期

GET /orders/status 会返回以下四种状态之一:
Signed 涵盖填充之前的所有情况,包括链上的 Open 事件。如果订单在 fillDeadline 之前未被填充,则可在 expires 之后退款,最终进入 Refunded 状态。轮询方式和 WebSocket 状态映射请参阅跟踪订单状态。

地址

所有端点均以 CAIP-2 链 id 加原生地址的形式接收地址({ "chain": "eip155:8453", "address": "0x…" })——EVM 上为十六进制,Tron 和 Solana 上为 base58。无需任何特殊编码。

数额

所有数额均以代币的最小单位(wei 等价)表示,不带小数。例如,1.5 USDC(6 位小数)为 1500000。

后续步骤

请求报价

为您的意图获取求解器定价

创建并提交订单

构造订单并提交到求解器网络

跟踪订单状态

通过 API 或链上事件监控订单

Solver API

求解器端点、报价和填充订单