获取分页的过滤转账列表

Query Parameters

limit

integer

default:10

Pagination limit. Defines the maximum number of returned results.

string

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

string

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

integrator

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

wallet

string

The sending OR receiving wallet address

status

string

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

fromTimestamp

number

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

toTimestamp

number

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

fromChain

string

The chain where the transfer originates from.

toChain

string

The chain where the transfer ends.

fromToken

string

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

toToken

string

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

Response

200 - application/json

Response for GET /analytics/transfers/summary endpoint

Parameters used to query paginated endpoints

hasNext

boolean

default:false

Flag indicating if there is a next page

hasPrevious

boolean

default:false

Flag indicating if there is a previous page

string | null

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

string | null

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

data

Root Type for StatusResponse · object[]

An array containing the paginated data returned by the endpoint

显示子属性

data.sending

Root Type for TransactionInfo · object

required

The transaction on the sending chain

显示子属性

data.sending.txHash

string

required

The hash of the transaction

data.sending.txLink

string

required

Link to a block explorer showing the transaction

data.sending.amount

string

required

The amount of the transaction

data.sending.token

Root Type for Token · object

required

Information about the token

显示子属性

data.sending.token.address

string

required

Address of the token

data.sending.token.decimals

number<number>

required

Number of decimals the token uses

data.sending.token.symbol

string

required

Symbol of the token

data.sending.token.chainId

number<number>

required

Id of the token's chain

data.sending.token.name

string

required

Name of the token

data.sending.token.coinKey

string

Identifier for the token

data.sending.token.logoURI

string

Logo of the token

data.sending.token.priceUSD

string

Token price in USD

Example:

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

data.sending.chainId

number

required

The id of the chain

data.sending.gasToken

Root Type for Token · object

The token in which gas was paid

显示子属性

data.sending.gasToken.address

string

required

Address of the token

data.sending.gasToken.decimals

number<number>

required

Number of decimals the token uses

data.sending.gasToken.symbol

string

required

Symbol of the token

data.sending.gasToken.chainId

number<number>

required

Id of the token's chain

data.sending.gasToken.name

string

required

Name of the token

data.sending.gasToken.coinKey

string

Identifier for the token

data.sending.gasToken.logoURI

string

Logo of the token

data.sending.gasToken.priceUSD

string

Token price in USD

Example:

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

data.sending.gasAmount

string

The amount of the gas that was paid

data.sending.gasAmountUSD

string

The amount of the gas that was paid in USD

data.sending.gasPrice

string

The price of the gas

data.sending.gasUsed

string

The amount of the gas that was used

data.sending.timestamp

number

The transaction timestamp

data.sending.value

string

The transaction value

data.sending.includedSteps

Root type for included swaps or protocol steps in the status response · object[]

An array of swap or protocol steps included in the LI.FI transaction

显示子属性

data.sending.includedSteps.tool

string

The tool used for this step

data.sending.includedSteps.toolDetails

object

The details of the tool used for this step. E.g. 1inch or feeProtocol

显示子属性

data.sending.includedSteps.toolDetails.key

string

The tool key

data.sending.includedSteps.toolDetails.name

string

The tool name

data.sending.includedSteps.toolDetails.logoURI

string

The tool logo URL

data.sending.includedSteps.fromAmount

string

The amount that was sent to the tool

data.sending.includedSteps.fromToken

string

The token that was sent to the tool

data.sending.includedSteps.toAmount

string

The amount that was received from the tool

data.sending.includedSteps.toToken

string

The token that was received from the tool

data.sending.includedSteps.bridgedAmount

string

The amount that was sent to the bridge

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

data.status

enum<string>

required

The current status of the transfer. Can be PENDING, DONE, NOT_FOUND or FAILED

可用选项:

NOT_FOUND,

INVALID,

PENDING,

DONE,

FAILED

data.tool

string

required

The tool used for this transfer

data.receiving

Root Type for TransactionInfo · object

The transaction on the receiving chain

显示子属性

data.receiving.txHash

string

required

The hash of the transaction

data.receiving.txLink

string

required

Link to a block explorer showing the transaction

data.receiving.amount

string

required

The amount of the transaction

data.receiving.token

Root Type for Token · object

required

Information about the token

显示子属性

data.receiving.token.address

string

required

Address of the token

data.receiving.token.decimals

number<number>

required

Number of decimals the token uses

data.receiving.token.symbol

string

required

Symbol of the token

data.receiving.token.chainId

number<number>

required

Id of the token's chain

data.receiving.token.name

string

required

Name of the token

data.receiving.token.coinKey

string

Identifier for the token

data.receiving.token.logoURI

string

Logo of the token

data.receiving.token.priceUSD

string

Token price in USD

Example:

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

data.receiving.chainId

number

required

The id of the chain

data.receiving.gasToken

Root Type for Token · object

The token in which gas was paid

显示子属性

data.receiving.gasToken.address

string

required

Address of the token

data.receiving.gasToken.decimals

number<number>

required

Number of decimals the token uses

data.receiving.gasToken.symbol

string

required

Symbol of the token

data.receiving.gasToken.chainId

number<number>

required

Id of the token's chain

data.receiving.gasToken.name

string

required

Name of the token

data.receiving.gasToken.coinKey

string

Identifier for the token

data.receiving.gasToken.logoURI

string

Logo of the token

data.receiving.gasToken.priceUSD

string

Token price in USD

Example:

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

data.receiving.gasAmount

string

The amount of the gas that was paid

data.receiving.gasAmountUSD

string

The amount of the gas that was paid in USD

data.receiving.gasPrice

string

The price of the gas

data.receiving.gasUsed

string

The amount of the gas that was used

data.receiving.timestamp

number

The transaction timestamp

data.receiving.value

string

The transaction value

data.receiving.includedSteps

Root type for included swaps or protocol steps in the status response · object[]

An array of swap or protocol steps included in the LI.FI transaction

显示子属性

data.receiving.includedSteps.tool

string

The tool used for this step

data.receiving.includedSteps.toolDetails

object

The details of the tool used for this step. E.g. 1inch or feeProtocol

显示子属性

data.receiving.includedSteps.toolDetails.key

string

The tool key

data.receiving.includedSteps.toolDetails.name

string

The tool name

data.receiving.includedSteps.toolDetails.logoURI

string

The tool logo URL

data.receiving.includedSteps.fromAmount

string

The amount that was sent to the tool

data.receiving.includedSteps.fromToken

string

The token that was sent to the tool

data.receiving.includedSteps.toAmount

string

The amount that was received from the tool

data.receiving.includedSteps.toToken

string

The token that was received from the tool

data.receiving.includedSteps.bridgedAmount

string

The amount that was sent to the bridge

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

data.feeCosts

object[]

An array of fee costs for the transaction

显示子属性

data.feeCosts.name

string

data.feeCosts.description

string

data.feeCosts.percentage

string

data.feeCosts.token

object

显示子属性

data.feeCosts.token.address

string

data.feeCosts.token.decimals

number<number>

data.feeCosts.token.symbol

string

data.feeCosts.token.chainId

number<number>

data.feeCosts.token.coinKey

string

data.feeCosts.token.name

string

data.feeCosts.token.logoURI

string

data.feeCosts.amount

string

data.feeCosts.amountUSD

string

data.feeCosts.included

boolean

data.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

data.substatusMessage

string

A message that describes the substatus

data.transactionId

string

The ID of this transfer (NOT a transaction hash).

data.fromAddress

string

The address of the sender.

data.toAddress

string

The address of the receiver.

data.lifiExplorerLink

string

The link to the LI.FI explorer.

data.metadata

Root type for Transaction Metadata · object

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

显示子属性

data.metadata.integrator

string

Integrator ID

关于 API

通用 API

请求报价

获取分页的过滤转账列表

Query Parameters

Response