# Sentinel402 Live Data Collection Retrieval

> Sentinel402 Live Data Collection Retrieval is a paid API for AI agents from pii-guardrail.chronokey.workers.dev, paid per call via x402, $0.003/call, status unknown (last checked 2026-10-10).

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

## Facts

- Endpoint: GET https://pii-guardrail.chronokey.workers.dev/v1/data/%7Bcollection%7D?utm_source=zero.xyz
- Price: $0.003/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-10
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/sentinel402-live-data-collection-retrieval-1f72197a
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_gep7yf5mEPNe36hHpPyk9

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability sentinel402-live-data-collection-retrieval-1f72197a
```

Example prompt: What's the current Bitcoin price with its 24-hour change? Pull live data from the crypto collection on Sentinel402.

## When to prefer this

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.

## Known failure modes

- 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

## How this service works

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.

## Output

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.

## Request schema (JSON Schema)

```json
{
 "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": {
     
… (truncated)
```

## Response schema (JSON Schema)

```json
{
 "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
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/sentinel402-live-data-collection-retrieval-1f72197a/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from pii-guardrail.chronokey.workers.dev](https://www.zero.xyz/host/pii-guardrail.chronokey.workers.dev/llms.txt)