curl --request GET \
--url https://li.quest/v1/analytics/transfers{
"transfers": [
{
"sending": {
"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": ""
},
"chainId": 137,
"gasToken": {
"address": "0x0000000000000000000000000000000000001010",
"symbol": "MATIC",
"decimals": 18,
"chainId": 137,
"name": "MATIC",
"coinKey": "MATIC",
"priceUSD": "0",
"logoURI": ""
},
"gasAmount": "10000",
"gasAmountUSD": "0.0",
"gasPrice": "1000",
"gasUsed": "1000",
"timestamp": 1720545119,
"value": "0"
},
"receiving": {
"txHash": "0xba2793065e20835ef60993144d92e6bc1a86529a70e16c357f66ad13774868ad",
"txLink": "https://bscscan.com/tx/0xba2793065e20835ef60993144d92e6bc1a86529a70e16c357f66ad13774868ad",
"amount": "12100000000000000000",
"token": {
"address": "0x8965349fb649a33a30cbfda057d8ec2c48abe2a2",
"symbol": "anyUSDC",
"decimals": 18,
"chainId": 56,
"name": "USDC",
"coinKey": "anyUSDC",
"priceUSD": "0",
"logoURI": ""
},
"chainId": 56,
"gasToken": {
"address": "0x0000000000000000000000000000000000001010",
"symbol": "BNB",
"decimals": 18,
"chainId": 56,
"name": "BNB",
"coinKey": "BNB",
"priceUSD": "0",
"logoURI": ""
},
"gasAmount": "10000",
"gasAmountUSD": "0.0",
"gasPrice": "1000",
"gasUsed": "1000",
"timestamp": 1720560232,
"value": "0"
},
"tool": "anyswap",
"status": "DONE",
"substatus": "COMPLETED",
"substatusMessage": "The transfer is complete.",
"transactionId": "0x0000000000000000000000000000000000001010",
"fromAddress": "0x0000000000000000000000000000000000001010",
"toAddress": "0x0000000000000000000000000000000000001010",
"lifiExplorerLink": "https://scan.li.fi/tx/0xd3ad8fb8798d8440f3a1ec7fd51e102a88e4690f9365fad4eff1a17020376b4a",
"metadata": {
"integrator": "jumper.exchange"
}
}
]
}Get a list of filtered transfers
This endpoint can be used to retrieve a list of transfers filtered by certain properties. Returns a maximum of 1000 transfers.
curl --request GET \
--url https://li.quest/v1/analytics/transfers{
"transfers": [
{
"sending": {
"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": ""
},
"chainId": 137,
"gasToken": {
"address": "0x0000000000000000000000000000000000001010",
"symbol": "MATIC",
"decimals": 18,
"chainId": 137,
"name": "MATIC",
"coinKey": "MATIC",
"priceUSD": "0",
"logoURI": ""
},
"gasAmount": "10000",
"gasAmountUSD": "0.0",
"gasPrice": "1000",
"gasUsed": "1000",
"timestamp": 1720545119,
"value": "0"
},
"receiving": {
"txHash": "0xba2793065e20835ef60993144d92e6bc1a86529a70e16c357f66ad13774868ad",
"txLink": "https://bscscan.com/tx/0xba2793065e20835ef60993144d92e6bc1a86529a70e16c357f66ad13774868ad",
"amount": "12100000000000000000",
"token": {
"address": "0x8965349fb649a33a30cbfda057d8ec2c48abe2a2",
"symbol": "anyUSDC",
"decimals": 18,
"chainId": 56,
"name": "USDC",
"coinKey": "anyUSDC",
"priceUSD": "0",
"logoURI": ""
},
"chainId": 56,
"gasToken": {
"address": "0x0000000000000000000000000000000000001010",
"symbol": "BNB",
"decimals": 18,
"chainId": 56,
"name": "BNB",
"coinKey": "BNB",
"priceUSD": "0",
"logoURI": ""
},
"gasAmount": "10000",
"gasAmountUSD": "0.0",
"gasPrice": "1000",
"gasUsed": "1000",
"timestamp": 1720560232,
"value": "0"
},
"tool": "anyswap",
"status": "DONE",
"substatus": "COMPLETED",
"substatusMessage": "The transfer is complete.",
"transactionId": "0x0000000000000000000000000000000000001010",
"fromAddress": "0x0000000000000000000000000000000000001010",
"toAddress": "0x0000000000000000000000000000000000001010",
"lifiExplorerLink": "https://scan.li.fi/tx/0xd3ad8fb8798d8440f3a1ec7fd51e102a88e4690f9365fad4eff1a17020376b4a",
"metadata": {
"integrator": "jumper.exchange"
}
}
]
}Query Parameters
The integrator string to filter by
The sending OR receiving wallet address
The status of the transfers. Possible values are ALL, DONE, PENDING, and FAILED. The default is DONE
The oldest timestamp that should be taken into consideration. Defaults to 30 days ago
The newest timestamp that should be taken into consideration. Defaults to now
The chain where the transfer originates from.
The chain where the transfer ends.
The token transferred from the originating chain. To use this parameter fromChain must be set.
The token received on the destination chain. To use this parameter toChain must be set.
Response
Response for GET /analytics/transfers endpoint
Show child attributes
Show child attributes
The transaction on the sending chain
Show child attributes
Show child attributes
The hash of the transaction
Link to a block explorer showing the transaction
The amount of the transaction
Information about the token
Show child attributes
Show child attributes
Address of the token
Number of decimals the token uses
Symbol of the token
Id of the token's chain
Name of the token
Identifier for the token
Logo of the token
Token price in USD
{
"address": "0x8f3cf7ad23cd3cadbd9735aff958023239c6a063",
"symbol": "DAI",
"decimals": 18,
"chainId": 137,
"name": "(PoS) Dai Stablecoin",
"coinKey": "DAI",
"priceUSD": "1",
"logoURI": "https://static.debank.com/image/matic_token/logo_url/0x8f3cf7ad23cd3cadbd9735aff958023239c6a063/549c4205dbb199f1b8b03af783f35e71.png"
}The id of the chain
The token in which gas was paid
Show child attributes
Show child attributes
Address of the token
Number of decimals the token uses
Symbol of the token
Id of the token's chain
Name of the token
Identifier for the token
Logo of the token
Token price in USD
{
"address": "0x8f3cf7ad23cd3cadbd9735aff958023239c6a063",
"symbol": "DAI",
"decimals": 18,
"chainId": 137,
"name": "(PoS) Dai Stablecoin",
"coinKey": "DAI",
"priceUSD": "1",
"logoURI": "https://static.debank.com/image/matic_token/logo_url/0x8f3cf7ad23cd3cadbd9735aff958023239c6a063/549c4205dbb199f1b8b03af783f35e71.png"
}The amount of the gas that was paid
The amount of the gas that was paid in USD
The price of the gas
The amount of the gas that was used
The transaction timestamp
The transaction value
An array of swap or protocol steps included in the LI.FI transaction
Show child attributes
Show child attributes
The tool used for this step
The amount that was sent to the tool
The token that was sent to the tool
The amount that was received from the tool
The token that was received from the tool
The amount that was sent to the bridge
{
"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"
}The current status of the transfer. Can be PENDING, DONE, NOT_FOUND or FAILED
NOT_FOUND, INVALID, PENDING, DONE, FAILED The tool used for this transfer
The transaction on the receiving chain
Show child attributes
Show child attributes
The hash of the transaction
Link to a block explorer showing the transaction
The amount of the transaction
Information about the token
Show child attributes
Show child attributes
Address of the token
Number of decimals the token uses
Symbol of the token
Id of the token's chain
Name of the token
Identifier for the token
Logo of the token
Token price in USD
{
"address": "0x8f3cf7ad23cd3cadbd9735aff958023239c6a063",
"symbol": "DAI",
"decimals": 18,
"chainId": 137,
"name": "(PoS) Dai Stablecoin",
"coinKey": "DAI",
"priceUSD": "1",
"logoURI": "https://static.debank.com/image/matic_token/logo_url/0x8f3cf7ad23cd3cadbd9735aff958023239c6a063/549c4205dbb199f1b8b03af783f35e71.png"
}The id of the chain
The token in which gas was paid
Show child attributes
Show child attributes
Address of the token
Number of decimals the token uses
Symbol of the token
Id of the token's chain
Name of the token
Identifier for the token
Logo of the token
Token price in USD
{
"address": "0x8f3cf7ad23cd3cadbd9735aff958023239c6a063",
"symbol": "DAI",
"decimals": 18,
"chainId": 137,
"name": "(PoS) Dai Stablecoin",
"coinKey": "DAI",
"priceUSD": "1",
"logoURI": "https://static.debank.com/image/matic_token/logo_url/0x8f3cf7ad23cd3cadbd9735aff958023239c6a063/549c4205dbb199f1b8b03af783f35e71.png"
}The amount of the gas that was paid
The amount of the gas that was paid in USD
The price of the gas
The amount of the gas that was used
The transaction timestamp
The transaction value
An array of swap or protocol steps included in the LI.FI transaction
Show child attributes
Show child attributes
The tool used for this step
The details of the tool used for this step. E.g. 1inch or feeProtocol
The amount that was sent to the tool
The token that was sent to the tool
The amount that was received from the tool
The token that was received from the tool
The amount that was sent to the bridge
{
"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"
}An array of fee costs for the transaction
Show child attributes
Show child attributes
Show child attributes
Show child attributes
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 A message that describes the substatus
The ID of this transfer (NOT a transaction hash).
The address of the sender.
The address of the receiver.
The link to the LI.FI explorer.