{"endpoint":"/api/safety/freshness-check","method":"POST","service_trust":"https://defi-shield-hazel.vercel.app/api/trust-signal","free_check":{"endpoint":"https://defi-shield-hazel.vercel.app/api/free/token-check","method":"POST","price":"FREE","note":"Try before you buy — free basic token safety check with risk math."},"also_available_on":{"virtuals_acp":{"agent":"Authensor","agent_id":18805,"offerings":["pre_trade_safety","token_deep_scan","wallet_report","batch_seal"],"marketplace":"https://app.virtuals.io/acp/scan/agents","note":"Same service, accessible to 18,000+ autonomous agents on Virtuals Protocol."},"mcp_server":{"package":"devsecure-mcp","install":"npx devsecure-mcp","tools":67,"note":"Install as MCP server in Claude, Cursor, or any MCP-compatible client for direct tool access."},"bazaar":"https://defi-shield-hazel.vercel.app/.well-known/x402","agent_card":"https://defi-shield-hazel.vercel.app/.well-known/agent-card.json"},"powered_by":"DeFi Shield by Authensor","price":"$0.01","description":"Check whether a URL's content is fresh or stale by actually fetching it (HEAD request, 5-second timeout) and analyzing HTTP cache headers including Last-Modified, Cache-Control (max-age, no-cache, no-store, must-revalidate, immutable), ETag, Age, and Date. Returns freshness status (fresh/stale/unknown_freshness) with detailed reasoning.","llm_usage_prompt":"Call this endpoint BEFORE relying on data from an API or webpage to verify the information is current and not stale cached content. Provide the full URL. Returns reachability, freshness_status (fresh/stale/unknown_freshness), staleness_reasons array explaining why content is stale, freshness_signals array showing positive indicators, Last-Modified date and age, Cache-Control with parsed max-age, ETag, and response time. unknown_freshness means the server provides no cache headers so freshness cannot be determined — treat with caution. A stale=true result means content has not been updated in over 30 days or has exceeded its cache max-age. Costs $0.01 per call.","params":{"url":{"type":"string","required":true,"description":"Full URL to check for freshness (e.g., 'https://api.example.com/prices')"}},"exampleRequest":{"url":"https://api.coingecko.com/api/v3/simple/price?ids=ethereum&vs_currencies=usd"}}