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

200
application/json

Response of the Status request

The current status of a transfer