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

FieldTypeDescription
payload[index].timestampstring | numberThe timestamp of the liquidity event.
payload[index].blockNumbernumberThe block number of the liquidity event.
payload[index].transactionHashstringThe transaction hash.
payload[index].liquidityProviderAddressstringThe address of the liquidity provider that the event is associated with.
payload[index].eventstringThe liquidity event type (mint, burn, skim, swap, etc)
payload[index].poolAddressstringThe address of the pair or liquidity pool, i.e. the address of the lp token.
payload[index].poolNamestringName of the pair or liquidity pool.

[Optional]: Returned when includeMetadata=true.
payload[index].poolTokenBalancestringThe number of lp tokens the provider holds in this pool.
payload[index].poolTokenDeltastringThe delta/change of lp tokens as a result of this event.
payload[index].token0AddressstringThe address of token0 in the pair or liquidity pool.

[Optional]: Returned when includeMetadata=true.
payload[index].token0NamestringThe name of token0 in the pair or liquidity pool.

[Optional]: Returned when includeMetadata=true.
payload[index].token0BalancenumberThe balance of token0 in the pair or liquidity pool.

[Optional]: Returned when includeMetadata=true.
payload[index].token0DeltastringThe delta/change of token0 in the pair or liquidity pool.

[Optional]: Returned when includeMetadata=true.
payload[index].token1AddressstringThe address of token1 in the pair or liquidity pool.

[Optional]: Returned when includeMetadata=true.
payload[index].token1NamestringThe name of token1 in the pair or liquidity pool.

[Optional]: Returned when includeMetadata=true.
payload[index].token1BalancenumberThe balance of token1 in the pair or liquidity pool.

[Optional]: Returned when includeMetadata=true.
payload[index].token1DeltastringThe delta/change of token1 in the pair or liquidity pool.

[Optional]: Returned when includeMetadata=true.
payload[index].priceNativestringRatio between tokens in pool.
Language
Authorization
Header
Click Try It! to start a request and see the response here!