get https://api.tatum.io/v4/data/events
20 credits per API call
Get all events on given addresses and / or in the requested block range on the following blockchains:
- Celo - celo / celo-testnet
- Ethereum - ethereum / ethereum-sepolia / ethereum-holesky
- BNB (Binance) Smart Chain - bsc / bsc-testnet
- Polygon - polygon
- Horizen EON - eon-mainnet
- Chiliz - chiliz-mainnet
To get started:
- To improve response times and obtain specific data, it is recommended to use proper filtering techniques. Please provide a chain name and a combination of filters that will accomplish this (at least block range or contract addresses must be specified).
- It is possible to specify multiple contract addresses at once by passing them as a comma separated string.
- If block range is not specified, the API attempts to go through all available blocks, which may result in a timeout error.
- When you are filtering data using blockFrom and not using blockTo, blockTo is automatically added as blockFrom + 1000. The same applies when blockTo is present and blockFrom is not. In that case blockFrom is automatically added as blockTo - 1000.
- It is recommended to filter only one specific type of events, which comes with built-in decoding for all the supported types.
- It is, however, also possible to filter by signature hashes, which can be passed together as a comma separated string.
As noted above, aside from general info and hashed event data, the API also decodes them for you in case you filter by one of the following supported event types:
tokenTransfer
: All transfers of fungible tokens (including stablecoins) and NFTs as per ERC-20 and ERC-721 standard.multitokenTransfer
: All transfers of multitokens (both single transfers and batch transfers) as per ERC-1155 standard.stablecoinTransfer
: Refers to the transfer of specific stablecoins on the mainnet. Typically, the top 10 to 16 stablecoins on each chain according to CoinMarketCap are included. If thecontractAddresses
parameter is also used in the filter combination, any tokens specified in it will also be included in the list.uniswapTrade
: Provides all swap events that occur on both Uniswap V2 and V3. In some cases, it may not be possible to map the swapped amounts to specific tokens. As a result, certain decoded data such as token amounts might be missing or in the original big number format. This will be indicated by the response parameterpartiallyRaw: true
.