Block number at a timestamp (8 EVM chains)
block_at_timeThe last block at or before a given time (unix seconds/ms or ISO 8601) on base, ethereum, bsc, arbitrum, optimism, polygon, gnosis or celo, with its timestamp and the next block's, so you can pin eth_call reads, audits and snapshots to a moment. Batched k-ary search over live block headers (about 7 round trips). Very old history may be unavailable on public nodes. Price: $0.002 USDC on Base per call, paid with x402 (MCP transport: an unpaid call returns the x402 PaymentRequired object; retry with params._meta["x402/payment"]). Same tool over HTTP: GET /api/block-at-time.
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>",
"time": "<time>"
},
"name": "block_at_time"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| time | Yes | unix seconds, unix ms, or ISO 8601 (UTC) | |
| chain | Yes |