跳转到主要内容

交易状态

本指南解释了如何使用 LI.FI 提供的 /status 端点检查跨链和交换交易的状态。

查询状态端点

要获取转账的状态,可以使用以下任一方式查询 /status 端点:
  1. 发送交易哈希
  2. 接收交易哈希
  3. transactionId
只需要上述值之一,并需要在 txHash 参数中传递。

必需:

  • txHash

可选:

  • fromChain:加快请求速度(推荐)
  • toChain
  • bridge
对于交换交易,将 fromChaintoChain 设置为相同的值。可以省略 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:代币已退款