{"uid":"cap_gep7yf5mEPNe36hHpPyk9","slug":"sentinel402-live-data-collection-retrieval-1f72197a","name":"Sentinel402 Live Data Collection Retrieval","description":"Paid tools for AI agents over x402: a PII and secret guardrail that scans outbound payloads, live citable data (crypto, weather, GitHub, sports, FX), and an RCP/1 retrieval server backed by that live data.","url":"https://pii-guardrail.chronokey.workers.dev/v1/data/%7Bcollection%7D?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET","HEAD","DELETE"],"type":"string"},"pathParams":{"type":"object","required":["collection"],"properties":{"collection":{"enum":["crypto","weather","github","sports","fx","hn","wiki","stocks","news","geo","npm","pypi","hnsearch","ens","arxiv"],"type":"string","description":"crypto | weather | github | sports | fx | hn | wiki | stocks | news | geo | npm | pypi | hnsearch | ens | arxiv"}}},"queryParams":{"type":"object","properties":{"q":{"type":"string","description":"news/hnsearch: the search query"},"ip":{"type":"string","description":"geo: IPv4/IPv6 address, or 'me' for the caller"},"base":{"type":"string","description":"fx: base currency, default USD"},"lang":{"type":"string","description":"wiki: language subdomain, default en"},"name":{"type":"string","description":"ens: name to resolve, e.g. vitalik.eth"},"page":{"type":"string","description":"wiki: Wikipedia page title, e.g. 'Base (blockchain)'"},"repo":{"type":"string","description":"github: owner/name"},"limit":{"type":"string","description":"hn: how many top stories (1-15, default 10)"},"place":{"type":"string","description":"weather: city or place name"},"story":{"type":"string","description":"hn: numeric HN item id — fetch one story instead of the front page"},"league":{"enum":["NBA","NFL","MLB","NHL","EPL","UCL","LALIGA","SERIEA","BUNDESLIGA","MLS"],"type":"string","description":"sports: league key"},"quotes":{"type":"string","description":"fx: comma-separated targets, default EUR,GBP,JPY"},"symbol":{"type":"string","description":"crypto: ticker such as BTC, ETH, SOL"},"address":{"type":"string","description":"ens: 0x address to reverse-resolve"},"package":{"type":"string","description":"npm/pypi: the package name"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","required":["ok","collection","items"],"properties":{"ok":{"type":"boolean"},"items":{"type":"array"},"fromCache":{"type":"boolean"},"collection":{"type":"string"}}}}}}},"responseSchema":{"type":"json","example":{"ok":true,"items":[{"meta":{"kind":"crypto.price","symbol":"BTC","priceUsd":84621.74,"change24hPct":1.83},"text":"Bitcoin (BTC) is trading at $84,621.74 USD, 24h +1.83%. Source: Binance BTCUSDT.","citation":{"uri":"https://www.binance.com/en/trade/BTCUSDT","title":"Bitcoin price"}}],"fromCache":false,"collection":"crypto","freshnessSeconds":30}},"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_xXmdg9fBAxCZaTAYUzoBc","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":"Fetches live, citable data from a named collection (crypto prices, weather, GitHub repos, sports scores, FX rates, news, Wikipedia, and more) via a paid x402 micro-payment gateway","exampleAgentPrompt":"What's the current Bitcoin price with its 24-hour change? Pull live data from the crypto collection on Sentinel402.","exampleUseCases":[{"title":"Live crypto price check for trading bot","prompt":"Get me the current price and 24-hour percentage change for ETH right now — I need a citable source."},{"title":"Real-time weather for travel planning","prompt":"What's the weather like in Paris right now? Give me the current conditions with a source I can cite."},{"title":"Sports scores for fantasy league update","prompt":"Pull the latest NBA scores for today — I want current standings or game results I can reference."}],"resultDescription":"A JSON object with ok=true, a collection name, a freshness window in seconds, and an items array where each item contains a meta object (with collection-specific fields like priceUsd, change24hPct, place name, etc.), a human-readable text summary, and a citation object with a URI and title pointing to the authoritative source. fromCache indicates whether the data was served from cache.","failureModes":["Invalid or unsupported collection name returns an error — must be one of the allowed enum values","Missing required query parameters for certain collections (e.g. no symbol for crypto, no place for weather) may return an error or empty result","Payment failure via x402 protocol results in a 402 response before any data is returned","Rate limits or upstream data source outages may cause stale or missing data","Invalid IP address format for geo collection returns a validation error","ENS name not found returns an empty or null resolution result"],"whenToPreferThis":"Choose this endpoint when you need live, citable, real-time data across a broad set of categories (crypto, weather, FX, sports, GitHub, news, ENS, geo, packages) in a single unified API with micro-payment billing via x402. It is especially useful for AI agents that need a verified source URI alongside the data for grounding or citation. Prefer it over scraping or unauthenticated public APIs when freshness guarantees (freshnessSeconds) and citation provenance matter. Not suitable for historical time-series queries or bulk data exports.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-10T06:33:12.923Z","isFirstParty":false,"canonicalSlug":"sentinel402-live-data-collection-retrieval-1f72197a"}