{"uid":"cap_bjDoqUAZBMOKxVbdTXZdg","slug":"moneytools-block-at-time-d56a71f3","name":"MoneyTools Block-at-Time","description":"Block number at a timestamp: Find the last block at or before a date/time on any of 7 EVM chains (interpolation search). For historical balance queries, snapshots and log ranges. Free tier 10/day; then $0.001 via x402 (HTTP 402 + PAYMENT-REQUIRED) or X-API-Key credits. Not charged on failure. $0.001 USDC per call via x402 on Base. Run by MoneyTools.","url":"https://tools.moneytools.dev/v1/block-at-time?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"const":"http"},"method":{"const":"GET"},"queryParams":{"type":"object","required":["chain","timestamp"],"properties":{"chain":{"type":"string","examples":["base"],"description":"chain: base, ethereum, arbitrum, optimism, polygon, bsc, avalanche"},"timestamp":{"type":"string","examples":["2026-11-01T00:00:00Z"],"description":"unix seconds or ISO 8601"}}}}},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string","const":"json"},"example":{"type":"object","properties":{"payment":{"type":"object","properties":{"charged":{"type":"boolean"},"network":{"type":"string"},"amountUsd":{"type":"string"},"transaction":{"type":["string","null"]}}},"freeTier":{"type":"object"},"_moneytools":{"type":"object","description":"optional plan / partner hints"}},"description":"Tool-specific JSON result (see llms.txt / openapi.json). Always includes payment info.","additionalProperties":true}}}}},"responseSchema":{"type":"json"},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.001","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.001/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_HuXDc4hn6Jfioma4ZaIni","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.001","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns the last EVM block number at or before a given timestamp on any of 7 supported chains using interpolation search.","exampleAgentPrompt":"What was the block number on Ethereum right at or just before 2024-01-01T00:00:00Z? I need it for a historical balance snapshot.","exampleUseCases":[{"title":"Historical token balance snapshot","prompt":"I need to check a wallet's token balance as of exactly midnight UTC on March 15 2024 on Ethereum — what block number should I use for that snapshot?"},{"title":"DeFi event log range query","prompt":"I'm querying Arbitrum event logs between November 1 2023 and December 1 2023 — can you give me the starting and ending block numbers for those two timestamps?"},{"title":"Polygon governance proposal timing","prompt":"A Polygon governance vote closed at 2024-06-30T18:00:00Z — what was the last block at or before that moment so I can verify on-chain state at the cutoff?"}],"resultDescription":"A JSON object containing the block number corresponding to the requested timestamp on the specified EVM chain, along with payment metadata (whether a charge was made, the network, USD amount, and transaction hash if applicable) and optional plan/partner hints.","failureModes":["Unsupported chain name returns an error — only base, ethereum, arbitrum, optimism, polygon, bsc, and avalanche are valid","Malformed or unparseable timestamp (neither valid ISO 8601 nor unix seconds) returns a parse error","Free tier exhausted (10 calls/day) without payment credentials returns HTTP 402 PAYMENT-REQUIRED","Network or RPC errors for the target chain may cause lookup failures — not charged on failure","Future timestamps may return the latest known block or an error depending on implementation"],"whenToPreferThis":"Use this endpoint when you need to map a human-readable or unix timestamp to an EVM block number for historical on-chain queries, balance snapshots, or log range boundaries across any of the 7 supported chains (Base, Ethereum, Arbitrum, Optimism, Polygon, BSC, Avalanche). It is preferable to manual binary-search approaches or chain-specific RPC hacks because it uses interpolation search for speed and covers multiple chains in a single unified API. The free tier of 10 calls/day makes it cost-effective for low-volume use; micropayment via x402 or API key credits covers higher-volume needs at $0.001 per call.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-11-05T12:42:41.885Z","isFirstParty":false,"canonicalSlug":"moneytools-block-at-time-d56a71f3"}