get
https://api.tatum.io/v4/data/block/time
/v4/data/block/time
20 credits per API call
Get block number by time on the following blockchains:
- Ethereum - ethereum-mainnet / ethereum-sepolia / ethereum-holesky
- Bitcoin - bitcoin-mainnet
- Base - base-mainnet / base-sepolia
- Arbitrum - arb-one-mainnet / arb-testnet
- BNB (Binance) Smart Chain - bsc-mainnet / bsc-testnet
- Polygon - polygon-mainnet
- Optimism - optimism-mainnet / optimism-testnet
- Berachain - berachain-mainnet
- Unichain - unichain-mainnet / unichain-sepolia
- Monad - monad-testnet
- Celo - celo-mainnet / celo-testnet
To get started, provide a chain name and specify one of the filters listed below (combination of the filters is not allowed):
- time
- unix
If you pass a time or Unix timestamp that is in the future, the system will return the number for the latest block.
If you pass a time or Unix timestamp in the past (dating back to or earlier than the blockchain's genesis block), the system will return 0.