get https://web3api.io/api/v2/market/defi/liquidity/providers//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. |