{"uid":"cap_B5O7eybm-qIwbUy07_rDK","slug":"delx-data-freshness-adf14cb4","name":"Delx Data Freshness","description":"Evaluate data age against a caller-supplied freshness objective. Use it as a bounded preflight or analysis step inside an enterprise agent workflow before data, policy, integration, security, or commercial decisions reach production. Returns deterministic machine-readable JSON for $0.003 USDC via x402 on Base or Solana. Execution is first-party, local-only, stateless, memory-only, and has no paid upstream or input retention. Results are advisory; the caller remains responsible for authorization…","url":"https://api.delx.ai/api/v1/x402/data-freshness","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_q375V7J7-FhUbaXKc2yIS","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":"Evaluates whether a given data age meets a caller-supplied maximum freshness requirement, returning a deterministic pass/fail assessment","exampleAgentPrompt":"Check if data that's 4500 seconds old is still fresh enough given a max allowed age of 3600 seconds.","exampleUseCases":[{"title":"Cache expiry preflight before API call","prompt":"Before we use this cached user profile that was last updated 7200 seconds ago, check if it's still within our freshness policy of 3600 seconds — I don't want stale data reaching the recommendation engine."},{"title":"Policy compliance before data handoff","prompt":"We're about to hand off a risk score to the underwriting system. The score is 900 seconds old and our compliance policy says nothing over 1800 seconds is acceptable — can you verify it passes the freshness check?"},{"title":"Sensor data staleness check before alerting","prompt":"The temperature reading from the IoT sensor is 250 seconds old. Our alerting pipeline requires data to be no older than 300 seconds — confirm whether this reading is fresh enough to trigger an alert."}],"resultDescription":"Returns deterministic machine-readable JSON indicating whether the input data age (age_seconds) meets the specified maximum freshness threshold (max_age_seconds), including pass/fail status and relevant computed values for downstream decision-making.","failureModes":["Missing required field age_seconds returns an error response","Missing required field max_age_seconds returns an error response","Non-numeric values for age_seconds or max_age_seconds cause validation errors","Negative age values may produce undefined or error results","Payment failure via x402 prevents execution"],"whenToPreferThis":"Choose this endpoint when you need a deterministic, stateless, machine-readable freshness evaluation as a lightweight preflight step in an automated workflow — especially before data, policy, security, or commercial decisions. It is ideal when you need a clear pass/fail signal based on a caller-defined age threshold rather than building custom comparison logic. Prefer it over custom code when operating inside an agent pipeline where auditability and low latency matter.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-16T01:05:36.104Z","isFirstParty":false}