LIlifi

Get a paginated list of filtered transfers

A paginated version of the GET /v1/analytics/transfers endpoint. This endpoint can be used to retrieve a list of transfers filtered by certain properties.

get/v2/analytics/transfers

Request

Query parameters

limitinteger

Pagination limit. Defines the maximum number of returned results.

nextstring

The next page cursor. Must come from the next field of the response of the previous request.

previousstring

The previous page cursor. Must come from the previous field of the response of the previous request.

string
OR
string[]

Either a single integrator string, or an array of unique integrator strings to filter transfers by.

walletstring

The sending OR receiving wallet address

statusstring

The status of the transfers. Possible values are ALL, DONE, PENDING, and FAILED. The default is DONE

fromTimestampnumber

The oldest timestamp that should be taken into consideration. Defaults to 30 days ago

toTimestampnumber

The newest timestamp that should be taken into consideration. Defaults to now

fromChainstring

The chain where the transfer originates from.

toChainstring

The chain where the transfer ends.

fromTokenstring

The token transferred from the originating chain. To use this parameter fromChain must be set.

toTokenstring

The token received on the destination chain. To use this parameter toChain must be set.

Response

Response for GET /analytics/transfers/summary endpoint

hasNextboolean

Flag indicating if there is a next page

hasPreviousboolean

Flag indicating if there is a previous page

nextstring nullable

Cursor for fetching the next page. Should be passed to next in the pagination query.

previousstring nullable

Cursor for fetching the previous page. Should be passed to previous in the pagination query.

Example response

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

Changes

No recorded changes to this operation across all 1 revision of this API.