Requesting Analytics Data

Get a List of Filtered Transfers

The full API documentation for our /analytics/transfers endpoint can be found here.

To fetch a list of filtered transfers, the /analytics/transfers endpoint can be queried. You can provide several optional parameters to customize your request

Parameters:

• integrator: Filter by integrator (optional)

• wallet: Sending or receiving wallet address (optional)

• status: Transfer status (ALL, DONE (default), PENDING, FAILED)

• fromTimestamp: Oldest timestamp (default: 30 days ago)

• toTimestamp: Newest timestamp (default: now)

• fromChain: Originating chain (optional)

• toChain: Destination chain (optional)

• fromToken: Token on the originating chain (optional, requires fromChain)

• toToken: Token on the destination chain (optional, requires toChain)

Sample Request

Here’s how you can request a list of filtered transfers:

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;
}

Sample Response

The response will include an array of transfers, each with relevant details. A sample response might look like this:

{
  "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"
      }
    }
  ]
}

Get the Total Amount of a Token Received on a Specific Chain

The full API documentation for our /analytics/transfers/summary endpoint can be found here.

To fetch a summary of token transfers, the /analytics/transfers/summary endpoint can be queried

Parameters:

• limit: Pagination limit, defaults to 10 (optional)

• next: Next page cursor from the previous response (optional)

• previous: Previous page cursor from the last response (optional)

• fromTimestamp: Start of the query period (Unix timestamp, seconds) (required)

• toTimestamp: End of the query period (Unix timestamp, seconds) (required)

• toChain: Receiving chain ID or key (required)

• toToken: Token address or symbol received (required)

• fromChain: Sending chain ID or key (optional)

• integrator: Filter by integrator. (optional)

Sample Request

Here’s how you can request the total amount of a token received on a specific chain:

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;
}

Sample Response

The response contains a summary of total amounts received for each wallet address. A sample response might look like this:

{
  "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"
}