Provider Events

For a given wallet (EOA), this endpoint returns all events associated with the EOA's liquidity events across pools (mint, burn and swap).

Events can be filtered by pair and time, and are ordered in time ascending order.

👍

Protocols Supported

This endpoint only supports Uniswap v2.

👍

Blockchains Supported

This endpoint only supports data from ethereum-mainnet.

📘

Not specifying startDate and endDate

If the startDate and endDate query parameters are not provided, the API will return the data from the previous 24 hours.

🚧

Time Range Limit

The maximum time range (difference between endDate and startDate) is 60 days.

🚧

200 - OK and empty payload when startDate and endDate are not specified

There were no events for the given address in the past 24 hours.

Response Data

Field

Type

Description

payload[index].timestamp

string | number

The timestamp of the liquidity event.

payload[index].blockNumber

number

The block number of the liquidity event.

payload[index].transactionHash

string

The transaction hash.

payload[index].liquidityProviderAddress

string

The address of the liquidity provider that the event is associated with.

payload[index].event

string

The liquidity event type (mint, burn, skim, swap, etc)

payload[index].poolAddress

string

The address of the pair or liquidity pool, i.e. the address of the lp token.

payload[index].poolName

string

Name of the pair or liquidity pool.

  • *[Optional]**: Returned when includeMetadata=true.

payload[index].poolTokenBalance

string

The number of lp tokens the provider holds in this pool.

payload[index].poolTokenDelta

string

The delta/change of lp tokens as a result of this event.

payload[index].token0Address

string

The address of token0 in the pair or liquidity pool.

  • *[Optional]**: Returned when includeMetadata=true.

payload[index].token0Name

string

The name of token0 in the pair or liquidity pool.

  • *[Optional]**: Returned when includeMetadata=true.

payload[index].token0Balance

number

The balance of token0 in the pair or liquidity pool.

  • *[Optional]**: Returned when includeMetadata=true.

payload[index].token0Delta

string

The delta/change of token0 in the pair or liquidity pool.

  • *[Optional]**: Returned when includeMetadata=true.

payload[index].token1Address

string

The address of token1 in the pair or liquidity pool.

  • *[Optional]**: Returned when includeMetadata=true.

payload[index].token1Name

string

The name of token1 in the pair or liquidity pool.

  • *[Optional]**: Returned when includeMetadata=true.

payload[index].token1Balance

number

The balance of token1 in the pair or liquidity pool.

  • *[Optional]**: Returned when includeMetadata=true.

payload[index].token1Delta

string

The delta/change of token1 in the pair or liquidity pool.

  • *[Optional]**: Returned when includeMetadata=true.

payload[index].priceNative

string

Ratio between tokens in pool.

Language
Credentials
Header
Click Try It! to start a request and see the response here!