{
  "meta": {
    "base_url": "https://kairossignal.com",
    "mcp_endpoint": "https://kairossignal.com/mcp",
    "auth": "X-API-Key header; POST /v1/credits/register (no body fields required beyond agent_name)",
    "payment": "Card one-shot https://buy.stripe.com/14A28j6nH3L85a5gM81ZS28 ($4.99 = $4.99 credits). USDC topups unavailable pending sender ownership verification; do not send USDC."
  },
  "feeds": {
    "depin_onchain": {
      "what": "Live DePIN supply/market/infra telemetry \u2014 one row per (symbol, metric) observation",
      "rows": 10948259,
      "history_from": "2026-05-08",
      "freshness": "continuous collectors; newest value per metric carries as_of + age_seconds",
      "coverage": "499 live symbols = 370 networks + 129 Bittensor subnets; 318 first-party",
      "provenance": "every row: source + verify_url + as_of",
      "endpoint": "GET /v1/network/<SYM> or MCP get_stats"
    },
    "depin_daily": {
      "what": "Daily snapshot history \u2014 one row per (day, network, metric) with observation count",
      "rows": 766806,
      "history_from": "2026-08-06 (clean epoch; days with no reading are ABSENT, never interpolated)",
      "freshness": "daily batch 08:00 UTC, Merkle-rooted + Bitcoin-anchored (OpenTimestamps)",
      "coverage": "407 networks + 129 Bittensor subnets (distinct network values in the table)",
      "endpoint": "product depin_history $7.99 (purchase_data MCP tool)"
    },
    "health_profiles": {
      "what": "Health profile per network: mcap, FDV, dilution, GitHub activity, first-party metric count, node quality, composite scores, grade; absent inputs are null and named in missing_fields",
      "rows": 421,
      "freshness": "rebuilt as one generation; current generation built 2026-10-12T19:50:01Z",
      "coverage": "421 profiled networks; 0 carry a letter grade and 0 a composite score (grades and scores are withheld where their inputs are unmeasured)",
      "endpoint": "GET /v1/health-profile/<SYM> (paid tier; product depin_health_profile)"
    },
    "signal_ledger": {
      "what": "Hash-chained trading signals \u2014 each row links prev_hash, tamper-evident audit trail",
      "rows": 1407,
      "history_from": "2026-06-14",
      "freshness": "one row per signal the paper trader emits; newest 2026-10-11T21:08:29Z",
      "endpoint": "product signal_ledger $9.99; GET /v1/signals (paid)"
    },
    "market_ticks": {
      "what": "Market + world telemetry ticks \u2014 one row per (sector, symbol) observation: crypto perps/spot/order books and on-chain, plus physical-world sectors (AIS, airspace, seismic, weather, rail, ...)",
      "rows": 12751056263,
      "freshness": "live ingestion, newest row minutes old",
      "coverage": "109 sectors and 9644 (sector, symbol) series live in the last 24h",
      "endpoint": "GET /v1/world (free: estate totals + physical-world gauges, each with as_of); GET /v1/supply (sampled) / quantitative tier"
    },
    "zk_footprints": {
      "what": "SHA-256 zero-knowledge provenance footprints (per-record receipts)",
      "rows": 1442520,
      "written": "2026-02-15 .. 2026-05-31",
      "endpoint": "MCP get_zk_provenance / verify_footprint (free)"
    }
  },
  "per_value_guarantee": "every value ships {symbol, metric, value, unit, source, verify_url, as_of}",
  "measurement_contract": {
    "reference": "arXiv 2609.25173 (Attack Success Rate Is Not a Number), transposed to telemetry",
    "single_pass": "every published value is one collector observation; as_of + age_seconds always shipped, variance not yet",
    "derived_metrics": "grades and scores (node-quality, dilution, sector-health, ai-intel) are ORDINAL heuristics over point estimates, not calibrated measurements; their contracts are declared on the engine outputs (measurement_contract key) and in measurement_contract.py",
    "mdd_note": "no minimum detectable difference is published: the paper's binomial MDD (\u00a7V-A) describes repeated independent trials of one system, and our figures are single observations of a census or deterministic scores over them \u2014 no sampling model applies, run-to-run variance is not yet measured, so no noise floor is claimed in either direction",
    "absent_vs_zero": "a missing input is NULL, never 0 \u2014 measured zero is preserved and distinguishable from unmeasured",
    "quarantine": "excluded rows are incident-registry-driven (state/glm_collector_monitor/quality_incidents.json), preserved-and-flagged, never silently restated"
  },
  "verify_free": "GET /try \u2014 3 showcase networks, no key, same provenance",
  "whats_new": "2026-08-28: prose_origin_policy shipped \u2014 every guidance string now carries authored_by (provider|upstream), and /v1/compare caveats are origin-tagged. Cross-network comparisons (/v1/compare) group 95+ device series into graded canonical concepts \u2014 the GPU tier split (consumer saturated, spot pools empty) is one call. Schema evolves; keys stay stable.",
  "buy": {
    "start": "POST /v1/credits/register \u2014 $5 free credits, no card (first 3 keys per IP per 30 days), ~5 seconds",
    "wedge": "depin_provenance $0.49 \u2014 full first-party supply snapshot, every network /v1/supply carries (free tier rotates a 40-network window). Delivered inline in the purchase response.",
    "ladder": "depin_networks $0.99 \u00b7 depin_revenue_snapshot $2.99 \u00b7 derivation_replay $2.99 \u00b7 depin_history $7.99 \u00b7 engines $4.99-$9.99 \u00b7 depin_ai_intel $14.99 \u00b7 depin_intel_bundle $29.99",
    "refill": "$4.99 card one-shot, no account: https://buy.stripe.com/14A28j6nH3L85a5gM81ZS28. USDC topups unavailable pending sender ownership verification; do not send USDC.",
    "full_catalog": "GET /v1/credits/pricing"
  }
}