Skip to main content

交易状态

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

查询 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:代币已退回