Copy const getFilteredTransfers = async () => {
const result = await axios.get('https://li.quest/v1/analytics/transfers', {
params: {
integrator: 'yourIntegrator', // Optional
wallet: '0xYourWalletAddress', // Optional
status: 'DONE', // Optional
fromTimestamp: Date.now() - 30 * 24 * 60 * 60 * 1000, // Optional
toTimestamp: Date.now(), // Optional
fromChain: 'ETH', // Optional
toChain: 'POL', // Optional
fromToken: 'USDC', // Optional
toToken: 'DAI' // Optional
}
});
return result.data;
}
The response will include an array of transfers, each with relevant details. A sample response might look like this:
Copy {
"transfers": [
{
"transactionId": "0xe70ece7c8ab8464677b556f8b131b796a465dac6b5b6ab0fb984f6fda9fcd8c5",
"sending": {
"txHash": "0x31a395ab598992dfd8f609f8a5903132d4a754a2b2e968ea20a2ca968c4476c8",
"txLink": "https://arbiscan.io/tx/0x31a395ab598992dfd8f609f8a5903132d4a754a2b2e968ea20a2ca968c4476c8",
"amount": "24300000",
"token": {
"address": "0xD56734d7f9979dD94FAE3d67C7e928234e71cD4C",
"chainId": 42161,
"symbol": "TIA.n",
"decimals": 6,
"name": "TIA",
"coinKey": "TIA.n",
"logoURI": "https://static.debank.com/image/arb_token/logo_url/0xd56734d7f9979dd94fae3d67c7e928234e71cd4c/3c3f24b022a460d15e9b20d556571119.png",
"priceUSD": "4.175175330341799"
},
"chainId": 42161,
"gasPrice": "13000000",
"gasUsed": "763761",
"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": "2352.93"
},
"gasAmount": "9928893000000",
"gasAmountUSD": "0.0234",
"amountUSD": "101.4568",
"value": "0",
"timestamp": 1725966891
},
"receiving": {
"txHash": "0x31a395ab598992dfd8f609f8a5903132d4a754a2b2e968ea20a2ca968c4476c8",
"txLink": "https://arbiscan.io/tx/0x31a395ab598992dfd8f609f8a5903132d4a754a2b2e968ea20a2ca968c4476c8",
"amount": "43151907949846671",
"token": {
"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": "2352.93"
},
"chainId": 42161,
"gasPrice": "13000000",
"gasUsed": "763761",
"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": "2352.93"
},
"gasAmount": "9928893000000",
"gasAmountUSD": "0.0234",
"amountUSD": "101.4568",
"value": "0",
"timestamp": 1725966891
},
"lifiExplorerLink": "https://explorer.li.fi/tx/0x31a395ab598992dfd8f609f8a5903132d4a754a2b2e968ea20a2ca968c4476c8",
"fromAddress": "0x9ac7eadead2fde39e485265254afcec25d50861e",
"toAddress": "0x9ac7eadead2fde39e485265254afcec25d50861e",
"tool": "1inch",
"status": "DONE",
"substatus": "COMPLETED",
"substatusMessage": "The transfer is complete.",
"metadata": {
"integrator": "jumper.exchange"
}
},
{
"transactionId": "0xdae898b1e568497d25176075a2a6974cedabbd62b440c07f18357babdee961e1",
"sending": {
"txHash": "0x77ffcedfe15b492e5125dcce8a9c9024b672e77bcfe6820f366b1d187b710443",
"txLink": "https://optimistic.etherscan.io/tx/0x77ffcedfe15b492e5125dcce8a9c9024b672e77bcfe6820f366b1d187b710443",
"amount": "10000000000000000",
"token": {
"address": "0x0000000000000000000000000000000000000000",
"chainId": 10,
"symbol": "ETH",
"decimals": 18,
"name": "ETH",
"coinKey": "ETH",
"logoURI": "https://raw.githubusercontent.com/trustwallet/assets/master/blockchains/ethereum/assets/0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2/logo.png",
"priceUSD": "2351.69"
},
"chainId": 10,
"gasPrice": "1951739",
"gasUsed": "129255",
"gasToken": {
"address": "0x0000000000000000000000000000000000000000",
"chainId": 10,
"symbol": "ETH",
"decimals": 18,
"name": "ETH",
"coinKey": "ETH",
"logoURI": "https://raw.githubusercontent.com/trustwallet/assets/master/blockchains/ethereum/assets/0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2/logo.png",
"priceUSD": "2351.69"
},
"gasAmount": "252272024445",
"gasAmountUSD": "0.01",
"amountUSD": "23.5169",
"value": "10010291699014547",
"timestamp": 1725965593
},
"receiving": {
"txHash": "0x6e3901e35f193e8c2b2562582af654f74215cb59136615496dc0a34a17b01045",
"txLink": "https://arbiscan.io/tx/0x6e3901e35f193e8c2b2562582af654f74215cb59136615496dc0a34a17b01045",
"amount": "9999000000000000",
"token": {
"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": "2352.93"
},
"chainId": 42161,
"gasPrice": "16412400",
"gasUsed": "291908",
"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": "2352.93"
},
"gasAmount": "4790910859200",
"gasAmountUSD": "0.0113",
"amountUSD": "23.5269",
"value": "0",
"timestamp": 1725965838
},
"lifiExplorerLink": "https://explorer.li.fi/tx/0x77ffcedfe15b492e5125dcce8a9c9024b672e77bcfe6820f366b1d187b710443",
"fromAddress": "0x9ac7eadead2fde39e485265254afcec25d50861e",
"toAddress": "0x9ac7eadead2fde39e485265254afcec25d50861e",
"tool": "stargateV2Bus",
"status": "DONE",
"substatus": "COMPLETED",
"substatusMessage": "The transfer is complete.",
"metadata": {
"integrator": "jumper.exchange"
}
}
]
}
Here’s how you can request the total amount of a token received on a specific chain:
Copy const getTransferSummary = async () => {
const result = await axios.get('https://li.quest/v1/analytics/transfers/summary', {
params: {
limit: 10, // Optional
fromTimestamp: 1694275200, // Required
toTimestamp: 1694361600, // Required
toChain: 'ETH', // Required
toToken: 'ETH', // Required
integrator: 'yourIntegrator' // Optional
}
});
return result.data;
}
The response contains a summary of total amounts received for each wallet address. A sample response might look like this:
Copy {
"data": [
{
"id": {
"toAddress": "0x908dc8d62546d16008c5672498ed389aea272118",
"sendingChainId": 10
},
"totalReceivedAmount": 47858962336189310000
},
{
"id": {
"toAddress": "0x9f85221d7ec0dec8c4a28e5c7038cfc4ad285a68",
"sendingChainId": 8453
},
"totalReceivedAmount": 21924359719464920000
},
{
"id": {
"toAddress": "0x4ef6f0d3f94ff609acef88068b1fc66a1184b3f3",
"sendingChainId": 42161
},
"totalReceivedAmount": 9511630052419813000
},
{
"id": {
"toAddress": "0x884950ac4307545f1fe7e40670f9d53ca589ba5d",
"sendingChainId": 56
},
"totalReceivedAmount": 7861952176837143000
},
{
"id": {
"toAddress": "0xf7a1a91317be01ad0a47845bcc4f4dff4d30afb8",
"sendingChainId": 42161
},
"totalReceivedAmount": 5997286233338414000
},
{
"id": {
"toAddress": "0xb88b31718af72572cd519ff8c15f8ee456423e87",
"sendingChainId": 42161
},
"totalReceivedAmount": 5943886087405610000
},
{
"id": {
"toAddress": "0x6fe7f3bc9a5f94a0a4bb3513ce23c8a2a17fc367",
"sendingChainId": 42161
},
"totalReceivedAmount": 4957468922316814000
},
{
"id": {
"toAddress": "0x9fa7bb759641fcd37fe4ae41f725e0f653f2c726",
"sendingChainId": 42161
},
"totalReceivedAmount": 4223402011314221600
},
{
"id": {
"toAddress": "0x69bbbfde43c49fc50f5647223da5ef4756d78659",
"sendingChainId": 42161
},
"totalReceivedAmount": 4193735685236319700
},
{
"id": {
"toAddress": "0xdf7d0d3d199706f5b937d6763174a2c73fa75b00",
"sendingChainId": 10
},
"totalReceivedAmount": 3382572915546771500
}
],
"hasPrevious": false,
"hasNext": true,
"next": "WzMzODI1NzI5MTU1NDY3NzE1MDAseyJ0b0FkZHJlc3MiOiIweGRmN2QwZDNkMTk5NzA2ZjViOTM3ZDY3NjMxNzRhMmM3M2ZhNzViMDAiLCJzZW5kaW5nQ2hhaW5JZCI6MTB9XQ"
}