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