{"uid":"cap_j_iS2u09DMe0k9z5Y04PP","slug":"pulsechain-block-by-timestamp-d384bbcc","name":"PulseChain Block by Timestamp","description":"Resolve a Unix timestamp to the exact PulseChain block at or nearest that moment.","url":"https://api.immuta.app/pulsechain/block-by-timestamp","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":{"type":"string","const":"http"},"method":{"enum":["GET","HEAD","DELETE"],"type":"string"},"queryParams":{"type":"object","required":["ts"],"properties":{"ts":{"type":"integer","description":"Unix timestamp in seconds to resolve to a block"},"mode":{"enum":["before","after"],"type":"string","description":"'before' = last block at or before ts; 'after' = first block at or after ts"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.002","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.002/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_JghLQDrvubu1hed6M7RVq","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.002","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Resolves a Unix timestamp to the exact PulseChain block number at or nearest that moment, with optional before/after mode.","exampleAgentPrompt":"What PulseChain block number was active at Unix timestamp 1700000000? Use 'before' mode so I get the last block at or before that moment.","exampleUseCases":null,"resultDescription":"Returns the PulseChain block number and its timestamp that corresponds to (or is nearest to) the given Unix timestamp, based on the selected before/after mode.","failureModes":["Missing required 'ts' query parameter returns an error","Invalid or non-integer timestamp causes a bad request","Timestamp before PulseChain genesis returns an error or null","Payment not provided or insufficient results in HTTP 402","Timestamp far in the future returns an error or nearest known block"],"whenToPreferThis":"Use this endpoint when you need to anchor a PulseChain blockchain query to a specific point in time — e.g., to replay state, audit historical events, or synchronize off-chain timestamps with on-chain block heights on the PulseChain network specifically.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-13T18:38:44.440Z","isFirstParty":false}