Trading API 提供跨去中心化交易所的代币报价、兑换和授权服务，自动选择最优路径完成代币交换。同时支持权益代币交易（RWA / 真实世界资产，包括 Ondo 和 BStock 股票代币）的 RFQ（询价订单）流程。
功能概览
| 功能 | 接口 | 方法 | 描述 |
|---|---|---|---|
| 支持的链 | /api/v1/dex/aggregator/supported/chain | GET | 查询支持的区块链网络 |
| 获取报价 | /api/v1/dex/aggregator/quote | GET | 获取代币兑换报价（支持 SWAP 和 RFQ 两种模式） |
| 执行兑换 | /api/v1/dex/aggregator/swap | GET | 生成兑换交易数据或 RFQ 待签名数据 |
| 授权交易 | /api/v1/dex/aggregator/approve-transaction | GET | 生成代币授权交易数据 |
| 获取交易状态 | /api/v1/dex/aggregator/history | GET | 通过 txHash 查询 DEX 兑换交易状态 |
| 提交 RFQ 订单 | /api/v1/dex/aggregator/order/submit | POST | 提交已签名的 RFQ 订单（仅权益代币使用） |
| 查询 RFQ 订单状态 | /api/v1/dex/aggregator/order/{orderId} | GET | 轮询 RFQ 订单结算状态 |
执行模式
/quote 响应中的 executionMode 字段决定后续交易流程：
| 模式 | 适用代币类型 | 流程说明 |
|---|---|---|
SWAP | 普通加密货币代币 | 对 /swap 返回的 tx 签名后直接广播到链上 |
RFQ | 权益代币（Ondo、BStock 等） | 对 /swap 返回的 rfq.typedDataToSign 做 EIP-712 签名，通过 /order/submit 提交，轮询 /order/{orderId} |
权益代币交易（RWA）
Trading API 支持代币化权益资产（真实世界资产），包括：
- Ondo 代币（type=1）：代币化股票和 ETF（如 NKEon/耐克、NVDAon/英伟达、EEMon/iShares
ETF）。始终通过 3-vendor RFQ（InchFusion + CowSwap + PcsXRfq）路由，所有路由返回
executionMode=RFQ。 - BStock 代币（type=3）：交易所上市股票代币（如 PALLon/钯金、TSLAB/特斯拉）。通过 LiquidMesh（SWAP）+ PcsXRfq（RFQ）混合路由，同一次询价可能同时返回一条 SWAP 路由和一条 RFQ 路由。
注意：Ondo 和 BStock 代币集严格互斥，同一个代币只属于其中一种类型。
SWAP 模式流程（普通代币及 BStock LiquidMesh 路由）
Code
RFQ 模式流程（Ondo 代币及 BStock PcsXRfq 路由）
Code
权益代币交易关键约束
| 约束条件 | 详情 |
|---|---|
userWalletAddress | RFQ 路由时 /quote 必填。该地址将作为 RFQ 订单的接收方。 |
quoteId 有效期 | 30 秒。需在 /quote 后 30 秒内调用 /swap，否则返回 QUOTE_EXPIRED（40401）。 |
| EIP-712 签名 | 对 /swap 返回的 rfq.typedDataToSign 签名，签名钱包须与 userWalletAddress 一致。 |
/approve-transaction 的 vendor | 权益代币必填，从 /quote 响应的 vendorName 字段取值。 |
幂等性（requestId） | 重试 /order/submit 时复用同一 UUID；使用新 UUID 会创建新订单。 |
| 交易时段 | Ondo 代币在美股非交易时段可能不可用（错误码 40367）；BStock 同理（40369）。 |
Last modified on