交易状态
本指南说明如何使用 LI.FI 提供的/status 端点检查跨链和交换交易的状态。
查询 status 端点
要获取转账状态,可以使用以下任一值查询/status 端点:
- 发送交易哈希
- 接收交易哈希
- transactionId
上述值只需提供其中一个,并需要通过
txHash 参数传入。必填:
txHash
可选:
fromChain:加快请求速度(推荐)toChainbridge
fromChain 和 toChain 设置为相同的值。bridge 参数可以省略。
示例响应
状态值
子状态定义
PENDING
WAIT_SOURCE_CONFIRMATIONS:等待源链确认WAIT_DESTINATION_TRANSACTION:等待目标交易BRIDGE_NOT_AVAILABLE:桥接 API 不可用CHAIN_NOT_AVAILABLE:源链/目标链 RPC 不可用REFUND_IN_PROGRESS:退款进行中(如果支持)UNKNOWN_ERROR:状态不确定
DONE
COMPLETED:转账成功PARTIAL:仅完成部分转账(常见于 across、hop、stargate、amarok)REFUNDED:代币已退回
FAILED
NOT_PROCESSABLE_REFUND_NEEDED:无法完成,需要退款OUT_OF_GAS:交易 gas 耗尽SLIPPAGE_EXCEEDED:接收金额过低INSUFFICIENT_ALLOWANCE:授权额度不足INSUFFICIENT_BALANCE:余额不足EXPIRED:交易已过期UNKNOWN_ERROR:未知或无效状态REFUNDED:代币已退回

