get_block_at_time
chainpeek: find the block at a point in time on Ethereum, Base or Robinhood Chain. For the latest block use get_block_number. Returns block (the last block at or before the time) and next_block, or is_latest: true when the time is at or after the head. A time before Base's genesis is a 422 before_genesis (not charged). A malformed or inconsistent node answer is a 5xx and is not charged. Typically 1-3 s (about 3-6 reads). Price: USD 0.003. Free: 10 chain reads per IP per UTC day. Docs: https://tanod.dev/learn/block-at-timestamp-api.html
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"chain": "<chain>",
"timestamp": "<timestamp>"
},
"name": "get_block_at_time"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| chain | Yes | Chain to read. | |
| timestamp | Yes | Unix seconds or ISO 8601 (no offset = UTC), e.g. 2026-01-01T00:00:00Z. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| block | No | ||
| chain | No | ||
| error | No | Only on an error result: an object {code, message}, or the reason string of an x402 PaymentRequired object. | |
| is_latest | No | ||
| rpc_calls | No | ||
| timestamp | No | ||
| next_block | No | ||
| assumed_utc | No | ||
| timestamp_iso | No |