API Reference

Blocks by Timestamp

get
https://api.g.alchemy.com/data/v1//utility/blocks/by-timestamp

Fetches the first block before or after a given timestamp. Returns the block's number and on-chain timestamp.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Path Params
string
required
Defaults to docs-demo

For higher throughput, create your own API key

Query Params
networks
array of strings
required
length between 1 and 3

Array of networks to query on. The response will be an array with one block per network. Find network enums here

networks*
string
required
Defaults to 2025-02-28T19:38:57Z

Unix or ISO timestamp

string
enum
required
Defaults to AFTER

Return the first block "BEFORE" or "AFTER" the provided timestamp

Allowed:
Responses

Updated over 1 year ago

Did this page help you?
Language
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json

Updated over 1 year ago

Did this page help you?