This API retrieves information about all of the actions that occurred on the protocol within a certain timespan.
Time Range Limit
The maximum time range (difference between endDate and startDate) is 60 days.
Not specifying startDate and endDate
If the startDate and endDate query parameters are not provided, the API will return data from the current date - 30 days.
So if the date-time today is 2022-12-20T00:00:00, then the first object in payload.data would start from at least 2022-11-20T00:00:00.
Understanding Actions in Uniswap
There are many different types of actions in Uniswap, as you'll see in the action property for each item of the payload.data array. The guide below will help you understand the possible actions.
| Uniswap v2 Actions | Uniswap v3 Actions |
|---|---|
| PairCreated | PoolCreated |
PairCreated
Only Uniswap v2
The protocol creates a liquidity pool for the pair token0 and token1 if it does not exist already.
{
"event": "PairCreated(address token0, address token1, address pair, uint256)",
"timestamp": "2022-07-03 00:00:08 000",
"blockNumber": 15066169,
"transactionHash": "0x9bcc2fdb2ddd4164882f2603c3c6bb1fdc3c5010b94778468b8c90debdb30cdb",
"logIndex": 118,
"poolAddress": "0x44636fa12c6e318a322fb6f09054864c8d4b1f9d",
"token0": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
"token1": "0xd2eb0c7a3fdbf6d7782ea2ac1df27aed03c1a1f3"
}
| property | type |
|---|---|
| event | string |
| timestamp | string | number |
| blockNumber | number |
| transactionHash | string |
| logIndex | number |
| poolAddress | string |
| token0 | string |
| token1 | string |
PoolCreated
Only Uniswap v3
The protocol creates a liquidity pool at the address pool for the pair token0 and token1 where each trade/swap incurs the given fee.
Multiply feeNormalized by 100 to get the percentage. In this case 0.3%.
{
"blockNumber": 15536706,
"transactionHash": "0x54085172515c1a785021f3275b21b3527535753854a24513ad2b59bca27c3af0",
"logIndex": 564,
"timestamp": "2022-09-15 03:55:29 000",
"factoryAddress": "0x1f98431c8ad98523631ae4a59f267346ea31f984",
"walletAddress": "0xb65ec76af01266bd3589677e46ae1255cbcccbb6",
"event": "PoolCreated(address indexed token0, address indexed token1, uint24 indexed fee, int24 tickSpacing, address pool)",
"action": "PoolCreated",
"fee": "3000",
"pool": "0xc6276da84fbd7d29990e848683b19fe3218888c9",
"token0": "0x616d9c78cc0781b838ca66fe2d6d86d090211908",
"token1": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
"tickSpacing": "60",
"feeNormalized": "0.003"
}
| property | type |
|---|---|
| blockNumber | number |
| transactionHash | string |
| logIndex | number |
| timestamp | string | number |
| factoryAddress | string |
| walletAddress | string |
| event | string |
| action | string |
| fee | string |
| pool | string |
| token0 | string |
| token1 | string |
| tickSpacing | string |
| feeNormalized | string |