Skip to main content
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"
}

Documentation Index

Fetch the complete documentation index at: https://docs.li.fi/llms.txt

Use this file to discover all available pages before exploring further.

Headers

​
x-lifi-api-key
string

Authentication header, register in the LI.FI Partner Portal (https://portal.li.fi/ ) to get your API Key.

Query Parameters

​
txHash
string
required

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

​
bridge
string

The bridging tool used for the transfer Identifier for a bridge tool. Retrieve the latest bridge keys from the /v1/tools endpoint. Keywords such as all, none, default, and [] are also supported where applicable.

​
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
Root Type for TransactionInfo · 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
Root Type for TransactionInfo · 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/introduction/user-flows-and-examples/status-tracking

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.

​
lifiExplorerLink
string

The link to the LI.FI explorer.

​
metadata
Root type for Transaction Metadata · object

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