Complete guide to checking cross-chain transaction statuses using the LI.FI API
/status
endpoint provided by LI.FI.
/status
endpoint can be queried with:
txHash
param.txHash
fromChain
: Speeds up the request (recommended)toChain
bridge
fromChain
and toChain
to the same value. The bridge
parameter can be omitted.
Status | Description |
---|---|
NOT_FOUND | Transaction doesn’t exist or not yet mined. |
INVALID | Hash is not tied to the requested tool. |
PENDING | Bridging is still in progress. |
DONE | Transaction completed successfully. |
FAILED | Bridging process failed. |
WAIT_SOURCE_CONFIRMATIONS
: Waiting for source chain confirmationsWAIT_DESTINATION_TRANSACTION
: Waiting for destination transactionBRIDGE_NOT_AVAILABLE
: Bridge API is unavailableCHAIN_NOT_AVAILABLE
: Source/destination chain RPC unavailableREFUND_IN_PROGRESS
: Refund in progress (if supported)UNKNOWN_ERROR
: Status is indeterminateCOMPLETED
: Transfer was successfulPARTIAL
: Only partial transfer completed (common for across, hop, stargate, amarok)REFUNDED
: Tokens were refundedNOT_PROCESSABLE_REFUND_NEEDED
: Cannot complete, refund neededOUT_OF_GAS
: Transaction ran out of gasSLIPPAGE_EXCEEDED
: Received amount too lowINSUFFICIENT_ALLOWANCE
: Not enough allowanceINSUFFICIENT_BALANCE
: Not enough balanceEXPIRED
: Transaction expiredUNKNOWN_ERROR
: Unknown or invalid stateREFUNDED
: Tokens were refunded