GET
/
v1
/
status
Check the status of a cross chain transfer
curl --request GET \
  --url https://li.quest/v1/status
{
  "transactionId": "0x5e9bd1e1232bcfb28e660ce116fe910aa058345604334e5f560034f51ef5327c",
  "sending": {
    "txHash": "0xe1ffdcf09d5aa92a2d89b1b39db3f8cadf09428a296cce0d5e387595ac83d08f",
    "txLink": "https://arbiscan.io/tx/0xe1ffdcf09d5aa92a2d89b1b39db3f8cadf09428a296cce0d5e387595ac83d08f",
    "amount": "129486280",
    "token": {
      "address": "0xFd086bC7CD5C481DCC9C85ebE478A1C0b69FCbb9",
      "chainId": 42161,
      "symbol": "USDT",
      "decimals": 6,
      "name": "USDT",
      "coinKey": "USDT",
      "logoURI": "https://raw.githubusercontent.com/trustwallet/assets/master/blockchains/ethereum/assets/0xdAC17F958D2ee523a2206206994597C13D831ec7/logo.png",
      "priceUSD": "1.00074"
    },
    "chainId": 42161,
    "gasPrice": "10000000",
    "gasUsed": "477174",
    "gasToken": {
      "address": "0x0000000000000000000000000000000000000000",
      "chainId": 42161,
      "symbol": "ETH",
      "decimals": 18,
      "name": "ETH",
      "coinKey": "ETH",
      "logoURI": "https://raw.githubusercontent.com/trustwallet/assets/master/blockchains/ethereum/assets/0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2/logo.png",
      "priceUSD": "3166.21"
    },
    "gasAmount": "4771740000000",
    "gasAmountUSD": "0.0151",
    "amountUSD": "129.5821",
    "value": "11551536072923",
    "includedSteps": [
      {
        "tool": "gasZip",
        "toolDetails": {
          "key": "gasZip",
          "name": "LI.Fuel",
          "logoURI": "https://raw.githubusercontent.com/lifinance/types/main/src/assets/icons/bridges/lifi.svg"
        },
        "fromAmount": "129486280",
        "fromToken": {
          "address": "0xFd086bC7CD5C481DCC9C85ebE478A1C0b69FCbb9",
          "chainId": 42161,
          "symbol": "USDT",
          "decimals": 6,
          "name": "USDT",
          "coinKey": "USDT",
          "logoURI": "https://raw.githubusercontent.com/trustwallet/assets/master/blockchains/ethereum/assets/0xdAC17F958D2ee523a2206206994597C13D831ec7/logo.png",
          "priceUSD": "1.00074"
        },
        "toToken": {
          "address": "0xFd086bC7CD5C481DCC9C85ebE478A1C0b69FCbb9",
          "chainId": 42161,
          "symbol": "USDT",
          "decimals": 6,
          "name": "USDT",
          "coinKey": "USDT",
          "logoURI": "https://raw.githubusercontent.com/trustwallet/assets/master/blockchains/ethereum/assets/0xdAC17F958D2ee523a2206206994597C13D831ec7/logo.png",
          "priceUSD": "1.00074"
        },
        "toAmount": "128671479",
        "bridgedAmount": "128671479"
      }
    ],
    "timestamp": 1729163645
  },
  "receiving": {
    "txHash": "0xd3142ffb0abaefd030e9c108d6fedcd9b5bab9099346531b54f370762301bb4e",
    "txLink": "https://taikoscan.io/tx/0xd3142ffb0abaefd030e9c108d6fedcd9b5bab9099346531b54f370762301bb4e",
    "amount": "128671479",
    "token": {
      "address": "0x9c2dc7377717603eB92b2655c5f2E7997a4945BD",
      "chainId": 167000,
      "symbol": "USDT(Stargate)",
      "decimals": 6,
      "name": "Tether USD",
      "coinKey": "USDT",
      "logoURI": "https://static.debank.com/image/coin/logo_url/usdt/23af7472292cb41dc39b3f1146ead0fe.png",
      "priceUSD": "1.00074"
    },
    "chainId": 167000,
    "gasPrice": "60000001",
    "gasUsed": "109839",
    "gasToken": {
      "address": "0x0000000000000000000000000000000000000000",
      "chainId": 167000,
      "symbol": "ETH",
      "decimals": 18,
      "name": "ETH",
      "coinKey": "ETH",
      "logoURI": "https://raw.githubusercontent.com/trustwallet/assets/master/blockchains/ethereum/assets/0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2/logo.png",
      "priceUSD": "3166.21"
    },
    "gasAmount": "6590340109839",
    "gasAmountUSD": "0.0209",
    "amountUSD": "128.7667",
    "value": "0",
    "includedSteps": [],
    "timestamp": 1729164251
  },
  "feeCosts": [
    {
      "name": "Relay fee",
      "description": "The fee required to pay for the relay on the receiving chain",
      "percentage": "0.6802",
      "token": {
        "chainId": 42161,
        "address": "0x0000000000000000000000000000000000000000",
        "symbol": "ETH",
        "decimals": 18,
        "name": "ETH",
        "coinKey": "ETH",
        "logoURI": "https://raw.githubusercontent.com/trustwallet/assets/master/blockchains/ethereum/assets/0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2/logo.png",
        "priceUSD": "2616.99"
      },
      "amount": "2100002100000",
      "amountUSD": "0.0055",
      "included": true
    },
    {
      "name": "LayerZero native fee",
      "description": "protocol native fee",
      "percentage": "0.0002",
      "token": {
        "chainId": 42161,
        "address": "0x0000000000000000000000000000000000000000",
        "symbol": "ETH",
        "decimals": 18,
        "name": "ETH",
        "coinKey": "ETH",
        "logoURI": "https://raw.githubusercontent.com/trustwallet/assets/master/blockchains/ethereum/assets/0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2/logo.png",
        "priceUSD": "2616.99"
      },
      "amount": "11551536072923",
      "amountUSD": "0.0302",
      "included": false
    }
  ],
  "lifiExplorerLink": "https://scan.li.fi/tx/0xe1ffdcf09d5aa92a2d89b1b39db3f8cadf09428a296cce0d5e387595ac83d08f",
  "fromAddress": "0x204dedcf79dbbb02359205f4f64ce2cbdd483906",
  "toAddress": "0x204dedcf79dbbb02359205f4f64ce2cbdd483906",
  "tool": "stargateV2Bus",
  "status": "DONE",
  "substatus": "COMPLETED",
  "substatusMessage": "The transfer is complete.",
  "metadata": {
    "integrator": "dev.jumper.exchange"
  },
  "bridgeExplorerLink": "https://layerzeroscan.com/tx/0xe1ffdcf09d5aa92a2d89b1b39db3f8cadf09428a296cce0d5e387595ac83d08f"
}

Headers

x-lifi-api-key
string

Authentication header, contact support if you want to get registered.

Query Parameters

txHash
string
required

The transaction hash on the sending chain, destination chain or lifi step id

bridge
enum<string>

The bridging tool used for the transfer

Available options:
hop,
cbridge,
celercircle,
optimism,
polygon,
arbitrum,
avalanche,
across,
gnosis,
omni,
relay,
celerim,
symbiosis,
thorswap,
squid,
allbridge,
mayan,
debridge,
relay,
chainflip
fromChain
string

The sending chain. Can be the chain id or chain key

toChain
string

The receiving chain. Can be the chain id or chain key

Response

Response of the Status request

The current status of a transfer

sending
object
required

The transaction on the sending chain

Example:
{
"txHash": "0xd3ad8fb8798d8440f3a1ec7fd51e102a88e4690f9365fad4eff1a17020376b4a",
"txLink": "https://polygonscan.com/tx/0xd3ad8fb8798d8440f3a1ec7fd51e102a88e4690f9365fad4eff1a17020376b4a",
"amount": "13000000",
"token": {
"address": "0xd69b31c3225728cc57ddaf9be532a4ee1620be51",
"symbol": "anyUSDC",
"decimals": 6,
"chainId": 137,
"name": "USDC",
"coinKey": "anyUSDC",
"priceUSD": "0",
"logoURI": ""
},
"gasToken": {
"address": "0x0000000000000000000000000000000000001010",
"symbol": "MATIC",
"decimals": 18,
"chainId": 137,
"name": "MATIC",
"coinKey": "MATIC",
"priceUSD": "0",
"logoURI": ""
},
"chainId": 137,
"gasAmount": "10000",
"gasAmountUSD": "0.0",
"gasPrice": "1000",
"gasUsed": "1000",
"timestamp": 1720545119,
"value": "0"
}
status
enum<string>
required

The current status of the transfer. Can be PENDING, DONE, NOT_FOUND or FAILED

Available options:
NOT_FOUND,
INVALID,
PENDING,
DONE,
FAILED
tool
string
required

The tool used for this transfer

receiving
object

The transaction on the receiving chain

Example:
{
"txHash": "0xd3ad8fb8798d8440f3a1ec7fd51e102a88e4690f9365fad4eff1a17020376b4a",
"txLink": "https://polygonscan.com/tx/0xd3ad8fb8798d8440f3a1ec7fd51e102a88e4690f9365fad4eff1a17020376b4a",
"amount": "13000000",
"token": {
"address": "0xd69b31c3225728cc57ddaf9be532a4ee1620be51",
"symbol": "anyUSDC",
"decimals": 6,
"chainId": 137,
"name": "USDC",
"coinKey": "anyUSDC",
"priceUSD": "0",
"logoURI": ""
},
"gasToken": {
"address": "0x0000000000000000000000000000000000001010",
"symbol": "MATIC",
"decimals": 18,
"chainId": 137,
"name": "MATIC",
"coinKey": "MATIC",
"priceUSD": "0",
"logoURI": ""
},
"chainId": 137,
"gasAmount": "10000",
"gasAmountUSD": "0.0",
"gasPrice": "1000",
"gasUsed": "1000",
"timestamp": 1720545119,
"value": "0"
}
feeCosts
object[]

An array of fee costs for the transaction

substatus
enum<string>

A more specific substatus. This is available for PENDING and DONE statuses. More information can be found here: https://docs.li.fi/more-integration-options/li.fi-api/checking-the-status-of-a-transaction

Available options:
WAIT_SOURCE_CONFIRMATIONS,
WAIT_DESTINATION_TRANSACTION,
BRIDGE_NOT_AVAILABLE,
CHAIN_NOT_AVAILABLE,
REFUND_IN_PROGRESS,
UNKNOWN_ERROR,
COMPLETED,
PARTIAL,
REFUNDED
substatusMessage
string

A message that describes the substatus

transactionId
string

The ID of this transfer (NOT a transaction hash).

fromAddress
string

The address of the sender.

toAddress
string

The address of the receiver.

The link to the LI.FI explorer.

metadata
object

The transaction metadata which includes integrator's string, etc.