Blocks by Timestamp | Alchemy Docs

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

Authentication

Authorizationstring

An API key that will be supplied in a named header.

Path parameters

apiKeystringRequiredDefaults to docs-demo

For higher throughput, [create your own API key](https://dashboard.alchemy.com/signup)

Query parameters

networkslist of stringsRequired

Array of networks to query on. The response will be an array with one block per network. Find network enums [here](https://dashboard.alchemy.com/chains)

timestampstringRequiredDefaults to 2025-02-28T19:38:57Z

Unix or ISO timestamp

directionenumRequiredDefaults to AFTER

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

Allowed values:

Response

Successful response

datalist of objects

List of blocks

1	curl -G https://api.g.alchemy.com/data/v1/docs-demo/utility/blocks/by-timestamp \
2	-H "Authorization: <apiKey>" \
3	-d networks=eth-mainnet \
4	--data-urlencode timestamp=2025-02-28T19:38:57Z \
5	-d direction=AFTER

1	{
2	"data": [
3	{
4	"network": "string",
5	"block": {
6	"number": 1,
7	"timestamp": "string"
8	}
9	}
10	]
11	}

Authentication

Path parameters

Query parameters

Response

Errors