{"uid":"cap_CxjYq8conc7hNpsDFerE7","slug":"webref-unix-timestamp-lookup-881e92f7","name":"WebRef Unix Timestamp Lookup","description":"Web standards and time reference for AI agents: HTTP status codes with what the client should do, retry semantics, MIME types and content-type matching, request-method safety and idempotency, plus deadline arithmetic - time until a moment, weekday and business-day checks, duration conversion and Unix timestamps. Pay per call in USDC on Base via x402 or USDC on Tempo via MPP. No signup, no API key, no KYC.","url":"https://webref.johnaio281.workers.dev/api/time/unix_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":{"type":"string","const":"http"},"method":{"enum":["GET","HEAD","DELETE"],"type":"string"},"queryParams":{"date":{"def":{"type":"optional","innerType":{"def":{"type":"string"},"type":"string"}},"type":"optional"},"type":"object","timestamp":{"def":{"type":"optional","innerType":{"def":{"type":"number","checks":[]},"type":"number","isFinite":true}},"type":"optional"}}},"additionalProperties":false}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.003","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.003/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.003","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.003","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_jecnToH8ojs8GZ47LQfQa","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.003","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns the current Unix timestamp (and optionally parses a date or existing timestamp) for use in deadline arithmetic and time calculations","exampleAgentPrompt":"What is the current Unix timestamp right now, and also what Unix timestamp does the date 2025-12-31 correspond to?","exampleUseCases":[{"title":"Deadline arithmetic for scheduled job","prompt":"What's the Unix timestamp for January 15, 2026 so I can set the expiry field in my task queue?"},{"title":"Current epoch time for logging","prompt":"Give me the current Unix timestamp — I need to stamp this event log entry with seconds since epoch."},{"title":"Convert human date to epoch","prompt":"Convert 2024-07-04 to a Unix timestamp for me — I need the number to pass into an API that only accepts epoch seconds."}],"resultDescription":"Returns the current Unix timestamp as an integer (seconds since the Unix epoch, January 1 1970 00:00:00 UTC), or the Unix timestamp corresponding to a supplied date string or numeric timestamp. The response provides a machine-readable epoch value suitable for deadline arithmetic, expiry calculations, and time comparisons.","failureModes":["Invalid date string supplied — returns an error indicating the date could not be parsed","Non-finite or out-of-range numeric timestamp — rejected by schema validation","Payment not fulfilled (402) — x402 or MPP payment must be completed before the response is returned","Network timeout on the Cloudflare Worker edge","Unsupported HTTP method (only GET, HEAD, DELETE accepted)"],"whenToPreferThis":"Choose this endpoint when an AI agent needs an authoritative current Unix timestamp or needs to convert a human-readable date string to epoch seconds without standing up its own time service. Especially useful for agents doing deadline arithmetic, setting expiry fields, or stamping logs, when they cannot rely on local system clocks or need a pay-per-call, no-signup solution. Prefer over building date-math locally when correctness and simplicity matter.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-22T12:40:54.754Z","isFirstParty":false,"canonicalSlug":"webref-unix-timestamp-lookup-881e92f7"}