跳转到主要内容
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
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

可用选项:
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

可用选项:
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
Root type for Transaction Metadata · object

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