Get block by time

/v4/data/block/time

20 credits per API call

Get block number by time on the following blockchains:

• Ethereum - ethereum-mainnet / ethereum-sepolia
• 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
• Avalanche - avax-mainnet / avax-testnet
• Gnosis - gno-mainnet / gno-testnet
• zkSync - zksync-mainnet / zksync-testnet
• Rootstock - rsk-mainnet / rsk-testnet
• Ethereum Classic - ethereum-classic-mainnet / ethereum-classic-testnet
• Lisk - lisk-mainnet / lisk-testnet
• XDC - xdc-mainnet / xdc-testnet
• Sonic - sonic-mainnet / sonic-blaze

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.