{"uid":"cap_j2qiAO9xXv6wJSYgTIGmh","slug":"delx-commerce-data-freshness-validator-49aebc4d","name":"Delx Commerce — Data Freshness Validator","description":"Pay-per-result APIs for agents. No signup. Exact price. Verifiable delivery. USDC on Base + Solana via x402.","url":"https://commerce.delx.ai/api/v1/x402/data-freshness?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"age_seconds":{"type":"number","description":"Input field: age_seconds."},"max_age_seconds":{"type":"number","description":"Input field: max_age_seconds."}}},"responseSchema":{"type":"json","example":{"fresh":true,"schema":"delx/util-data-freshness/v1","age_seconds":300,"max_age_seconds":900,"overdue_seconds":0,"freshness_percent":66.6667}},"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_SLWtpHU2R1i8STSbMzoiT","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":"Checks whether a given data age falls within an acceptable freshness window, returning freshness status and percentage.","exampleAgentPrompt":"Check if data that is 300 seconds old is still fresh when the maximum allowed age is 900 seconds, and tell me the freshness percentage.","exampleUseCases":[{"title":"Cache expiry check before API call","prompt":"Before I use this cached weather response, check if it's still fresh — it's 300 seconds old and my max acceptable age is 600 seconds."},{"title":"Pipeline gate for stale data","prompt":"My ETL pipeline just pulled a record that's 1200 seconds old. Validate whether it's still within the freshness window of 900 seconds and tell me how overdue it is."},{"title":"Agent self-check on stored context","prompt":"I stored some context data 45 seconds ago and my freshness limit is 120 seconds — is it still fresh enough to use, and what percentage fresh is it?"}],"resultDescription":"Returns a JSON object indicating whether the data is fresh (boolean), the provided age and max age in seconds, how many seconds overdue the data is (0 if fresh), and a freshness percentage (0–100+) showing how much of the allowed age window has been consumed.","failureModes":["Missing required fields (age_seconds or max_age_seconds not provided) may result in a 400 error or undefined behavior","Non-numeric inputs for age_seconds or max_age_seconds may cause validation errors","Payment failure via x402 (insufficient USDC balance) will block the request","Negative values for age_seconds or max_age_seconds may produce unexpected results"],"whenToPreferThis":"Use this endpoint when an AI agent needs a deterministic, pay-per-call utility to programmatically assess data freshness without building custom logic. Ideal for agents that need to gate downstream actions on whether cached or stored data is still valid. Preferred over custom code when operating in a pay-per-result agent commerce context (x402/USDC) where no signup or long-term subscription is desired.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-01T00:53:41.302Z","isFirstParty":false,"canonicalSlug":"delx-commerce-data-freshness-validator-49aebc4d"}