{"uid":"cap_O9VGm88xbnJqjmnqRnqH8","slug":"defi-shield-hazel-vercel-app-b36dcd7b","name":"URL Freshness Check","description":"","url":"https://defi-shield-hazel.vercel.app/api/safety/freshness-check?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":null,"responseSchema":null,"example":{"request":{"input":{"body":{"url":"https://api.coingecko.com/api/v3/simple/price?ids=ethereum&vs_currencies=usd"},"type":"http","method":"POST","bodyType":"json"}},"response":{"url":"https://api.coingecko.com/api/v3/simple/price?ids=ethereum&vs_currencies=usd","etag":"W/\"b9d16f0a6ff7657986295516e1f1eb36\"","stale":true,"server":"cloudflare","reachable":true,"age_seconds":33,"analyzed_at":"2026-06-12T02:04:03.831Z","status_code":200,"content_type":"application/json; charset=utf-8","cache_control":"max-age=30, public, must-revalidate, s-maxage=60","cache_max_age":30,"last_modified":null,"content_length":null,"freshness_status":"stale","response_time_ms":42,"freshness_signals":["Cache-Control: max-age=30, public, must-revalidate, s-maxage=60","must-revalidate directive present","ETag present: W/\"b9d16f0a6ff7657986295516e1f..."],"staleness_reasons":["Age (33s) exceeds max-age (30s)"],"last_modified_age_seconds":null}},"exampleRequest":{"url":"https://api.coingecko.com/api/v3/simple/price?ids=ethereum&vs_currencies=usd"},"tags":["x402"],"displayCostAmount":"0.01","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","requiresHandshake":false,"reviewCount":1,"rating":{"score":"1.00","successRate":"1.00","reviews":1,"stars":"5.0","state":"rated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_fv435T4hHeXFxm4Izj67j","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Performs a real HTTP fetch of a URL and analyzes cache headers, staleness, ETag, and response time to determine if the resource is fresh or stale.","exampleAgentPrompt":"Can you check if https://api.coingecko.com/api/v3/simple/price?ids=bitcoin&vs_currencies=usd is returning fresh data right now — I want to know if the response is stale, what its cache age is, and whether it's actually reachable?","exampleUseCases":null,"resultDescription":"Returns a JSON object with the target URL's reachability status, HTTP status code, freshness_status (fresh/stale), age_seconds, cache_control directives, cache_max_age, ETag, last_modified, response_time_ms, content_type, server, an array of freshness_signals supporting the determination, and an array of staleness_reasons if applicable, plus the timestamp it was analyzed.","failureModes":["URL is unreachable or returns a network error — reachable: false with no cache data","Request to target URL times out after 5 seconds — timeout error returned","Target URL returns a non-200 status code — status_code reflects the error, freshness may be undetermined","Malformed or missing URL input — validation error response","Target URL blocks the checker's IP or returns a captcha/403"],"whenToPreferThis":"Use this endpoint when you need to programmatically verify whether a specific URL is serving fresh or stale content based on real HTTP cache headers, rather than relying on static assumptions. Ideal for monitoring data pipelines, validating third-party API freshness before consuming their data, or checking whether a CDN or cache layer is behaving correctly. Prefer this over simple availability checks when cache semantics (max-age, ETag, must-revalidate) matter for your use case.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":1,"lastUsedAt":"2026-04-20T15:29:53.467Z","lastSuccessfullyRanAt":"2026-04-20T15:29:53.467Z","lastHealthCheckAt":"2026-10-11T06:30:44.310Z","isFirstParty":false,"canonicalSlug":"defi-shield-hazel-vercel-app-b36dcd7b"}