/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.