{"uid":"cap_ifAjHQQFivp9DAsjrMEei","slug":"live-data-freshness-5cf6dc4d","name":"Live Data Freshness","description":"Test whether source observations meet an explicit maximum-age policy","url":"https://phion.systems/v1/paid/trust/live-data-freshness?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input","output"],"properties":{"input":{"type":"object","required":["body"],"properties":{"body":{"type":"object","additionalProperties":true}}},"output":{"type":"object","required":["example"],"properties":{"example":{"type":"object","additionalProperties":true}}}}},"responseSchema":{"type":"json"},"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_mayuSMnuZ3BIz-50IhejW","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":"Tests whether source observations meet an explicit maximum-age policy, validating that data is fresh enough to be trusted","exampleAgentPrompt":"Before I use this sensor reading, check if it meets a maximum age policy of 5 minutes — here's the observation with its timestamp, and reject it if it's stale.","exampleUseCases":[{"title":"Real-time pipeline freshness gate","prompt":"I'm about to feed this weather observation into my model — can you verify it satisfies a maximum-age policy of 10 minutes before I proceed?"},{"title":"Financial data staleness check","prompt":"Before I execute this trade logic, confirm that this market price observation is no older than 30 seconds — reject it if it doesn't meet the freshness requirement."},{"title":"IoT sensor data validation","prompt":"I've got a batch of temperature sensor readings with timestamps — check whether each one satisfies a 2-minute maximum-age policy and flag any that are too stale to trust."}],"resultDescription":"Returns a pass/fail freshness verdict indicating whether the source observation satisfies the declared maximum-age policy, along with the observed data age and any policy violation details such as how much the age limit was exceeded.","failureModes":["Missing or unparseable timestamp on the observation leads to inability to compute age","Maximum-age policy value not provided or ambiguously formatted causes policy enforcement failure","Network latency introduces small timing uncertainty near the age threshold","Clock skew between source and validator may cause borderline observations to fail incorrectly","Malformed input schema results in a 400-level error with no freshness verdict"],"whenToPreferThis":"Choose this endpoint when you need a lightweight, policy-enforced freshness check on individual source observations before acting on them — especially in agentic pipelines where stale data could cause incorrect decisions. Prefer this over manual timestamp comparisons when you need a signed, auditable freshness result or when enforcing an explicit declared maximum-age policy rather than an ad-hoc recency heuristic.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-02T18:48:18.664Z","isFirstParty":false,"canonicalSlug":"live-data-freshness-5cf6dc4d"}