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 / ethereum-holesky
  • 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
  • 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.

Language
Credentials
Header
Click Try It! to start a request and see the response here!