KAIROS Signal Customer Technical Manual

API health check. Returns service status and version. No key required.

CURL — Healthcurl https://api.kairossignal.com/health

RESPONSE{"status": "ok", "version": "v1", "time": "2026-08-25T12:00:00Z"}

Full network list with telemetry tiers. This is the free browsing surface — no key required. Each entry tells you whether the network is first-party, market-only, or catalog-only.

This endpoint is paged. One anonymous call returns a slice of the catalog — 40 rows at the time of writing — not the whole list. The response tells you exactly what you got: n_networks (the full catalogued count), n_networks_shown (rows in this response), and access.withheld_networks (the remainder). The slice is ordered richest-telemetry first and re-rotates every 30 minutes, so a given symbol is not guaranteed to be on the page you happen to fetch. The counts, the tier legend and the not_covered map are always complete and always free. To pull a specific network, call /v1/network/<SYM> directly — also free, and not subject to the rotation.

CURL — Network Listcurl https://api.kairossignal.com/v1/networks

RESPONSE (abridged){
  "n_networks": 782,
  "n_networks_shown": 40,
  "access": {"tier_served": "free", "withheld_networks": 742},
  "networks": [
    {"symbol": "HNT", "name": "Helium", "category": "wireless", "chains": "solana",
     "telemetry_tier": "first_party_telemetry", "has_live_supply_telemetry": true,
     "has_onchain_market_data": true, "first_party_stats_api": true,
     "live_supply_metrics": 2},
    {"symbol": "MOBILE", "name": "Helium Mobile", "category": "wireless", "chains": "solana",
     "telemetry_tier": "first_party_telemetry", "has_live_supply_telemetry": true},
    {"symbol": "FIL", "name": "Filecoin", "category": "storage",
     "telemetry_tier": "onchain_only", "has_onchain_market_data": true,
     "has_live_supply_telemetry": false}
  ],
  "not_covered": {"IO": "io.net — no free public network-stats endpoint", "...": "..."}
}

Tier values, exactly as the API spells them: first_party_telemetry (295), onchain_only (77), market_data_only, catalog_only (224). The not_covered map names the networks we deliberately do not claim first-party coverage for, and says why — read it before you assume a missing symbol is an outage.

Single network detail. No key required — this is part of the free browsing surface, same as /v1/networks and /v1/supply. Use the network's canonical ticker, not its project name: Helium is HNT (with IOT and MOBILE as its two subnetworks), Filecoin is FIL. A project name such as HELIUM is not a symbol and returns 404. If you are unsure of a symbol, take it from the symbol field of /v1/networks — but note that on the free tier that list is a sample, not the full directory: compare n_networks_shown against n_networks in the response to see how much of the catalog you are being shown. /v1/network/<SYM> resolves any catalogued symbol, including ones the sampled list does not display — HNT, FIL and STORJ all return full detail whether or not they appear in your copy of /v1/networks. So a symbol missing from that list is not evidence the network is unavailable.

CURL — Network Detail (no key)curl https://api.kairossignal.com/v1/network/HNT

Returns the symbol you asked for echoed back, the catalog record (name, category, chains, token address, website), on-chain market/revenue values, the live first-party series under live.supply_telemetry, and the standing disclosure block. Every live value carries its own source, as_of and verify_yourself URL; every on-chain value carries source, as_of and verify_url. For HNT that verify link points at entities.nft.helium.io — Helium's own hotspot endpoint, which you can call without us.

First-party supply telemetry — the scarce tier. This is real circulating supply read from each network's own API or chain, not a CoinGecko estimate. Free to browse.

CURL — Supply (no key)curl https://api.kairossignal.com/v1/supply

RESPONSE (abridged){
  "series": 11,127,
  "networks": 295,
  "tier": "supply_telemetry",
  "data": {
    "HNT": {
      "MOBILE_HOTSPOTS": {
        "value": 57904.0, "source": "depin_first_party",
        "as_of": "2026-09-13 17:09:33.702", "age_hours": 0.9, "freshness": "live",
        "verify_yourself": "https://entities.nft.helium.io/v2/hotspots/pagination-metadata?subnetwork=mobile"
      }
    }
  },
  "not_covered": {"IO": "io.net — no free public network-stats endpoint", "...": "..."}
}

Shape and paging. data is keyed by symbol, then by metric name — it is not a flat array. Like /v1/networks, an anonymous call returns a rotating slice (n_networks of n_networks_available), so a particular symbol may not be on the page you fetch; /v1/network/<SYM> always returns a named one. Every metric carries source, as_of and verify_yourself. Absent metrics are omitted, never zero-filled — a symbol missing here means no verified value exists, and not_covered says which ones we do not claim and why.

Market data — price, market cap, volume — sourced from CoinGecko and DefiLlama. No key required: an anonymous call returns a rotating sample of the networks with live market telemetry (n_symbols of n_symbols_available), with every value carrying its own provenance. A key lifts the sampling, it does not change the values. This is the commodity tier — price is available anywhere; it is included for convenience, not as the product.

CURL — Market (no key)curl https://api.kairossignal.com/v1/market

Protocol revenue / fees. Real fee capture per network, from the DefiLlama fees dataset. No key required — like /v1/market this is a sampled free tier: the response reports n_networks of n_networks_available, and not_covered names the networks we do not claim revenue for.

CURL — Revenue (no key)curl https://api.kairossignal.com/v1/revenue

Source registry — every source we read from, with a verify_url per source. This is how you confirm the data yourself. Free to browse.

CURL — Provenance (no key)curl https://api.kairossignal.com/v1/provenance

RESPONSE (abridged){
  "sources": 69,
  "sources": [
    {"name": "CoinGecko", "kind": "commodity", "networks": 288,
     "verify_url": "https://api.coingecko.com/api/v3/coins/markets"},
    {"name": "bittensor_subtensor_rpc", "networks": 130,
     "verify_url": "https://...subtensor..."},
    {"name": "evm_blockscout", "networks": 118,
     "verify_url": "https://.../api/v2/"}
  ]
}

Cross-network correlation matrix. Requires key.

CURL — Correlationscurl -H "X-API-Key: your_key" \
  https://api.kairossignal.com/v1/correlations

Lead-lag analysis — which series leads, which lags, and the lag horizon. Requires key.

CURL — Lead-Lagcurl -H "X-API-Key: your_key" \
  https://api.kairossignal.com/v1/correlations/lead-lag

Technical indicators computed over live series. Requires key.

CURL — Indicatorscurl -H "X-API-Key: your_key" \
  https://api.kairossignal.com/v1/indicators

Trading signals derived from the indicator layer. Requires key.

CURL — Signalscurl -H "X-API-Key: your_key" \
  https://api.kairossignal.com/v1/signals

Daily digest of changes across networks. Requires key.

CURL — Digestcurl -H "X-API-Key: your_key" \
  https://api.kairossignal.com/v1/digest

Recent changes and movements across the dataset. Requires key.

CURL — Changescurl -H "X-API-Key: your_key" \
  https://api.kairossignal.com/v1/changes

Compare multiple networks on a single canonical metric. Requires key.

CURL — Comparecurl -H "X-API-Key: your_key" \
  "https://api.kairossignal.com/v1/compare?metric=circulating_supply"

Use canonical metric names from /v1/provenance.

Historical time series for one network and metric over N days. No key required, but the free tier caps the window: the response echoes window_days and window_capped_by_tier so you can see whether you got the full range you asked for. The requested symbol comes back as a key inside data, not as a top-level network field.

CURL — History (no key)curl "https://api.kairossignal.com/v1/history?network=HNT&metric=circulating_supply&days=30"

RESPONSE (abridged){
  "source_table": "default.depin_onchain",
  "window_days": 30, "window_capped_by_tier": true, "tier_served": "free",
  "data": {
    "HNT": {
      "circulating_supply": {
        "tier": "market", "source": "CoinGecko /coins/markets",
        "points": [{"date": "2026-09-06", "value": 187659024.4339131, "n_observations": 24}, "..."]
      }
    }
  }
}

Network health profile — the composite operating-health view. Requires key.

CURL — Health Profilecurl -H "X-API-Key: your_key" \
  https://api.kairossignal.com/v1/health-profile/HNT

Network grades across the catalog. Requires key.

CURL — Gradescurl -H "X-API-Key: your_key" \
  https://api.kairossignal.com/v1/grades

Enrichment data per network — supplementary derived fields. Requires key.

CURL — Enrichmentcurl -H "X-API-Key: your_key" \
  https://api.kairossignal.com/v1/enrichment/HNT

AI intelligence layer — the agent-facing analytical surface. Requires key.

CURL — AI Intelcurl -H "X-API-Key: your_key" \
  https://api.kairossignal.com/v1/ai-intel

Node-quality engine. Returns 5 key metrics per network evaluating node operational health.

CURL — Node Qualitycurl -H "X-API-Key: pro_key" \
  https://api.kairossignal.com/v1/node-quality

Sector-health engine. Returns 4 sector-level health indices.

CURL — Sector Healthcurl -H "X-API-Key: pro_key" \
  https://api.kairossignal.com/v1/sector-health

Bot-detection engine. Returns 5 bot-detection signals per network.

CURL — Bot Detectioncurl -H "X-API-Key: pro_key" \
  https://api.kairossignal.com/v1/bot-detection

Competitive-landscape engine. Returns 4 competitive metrics.

CURL — Competitive Landscapecurl -H "X-API-Key: pro_key" \
  https://api.kairossignal.com/v1/competitive-landscape

GPU supply/demand engine. Returns 6 GPU market metrics.

CURL — GPU Supply & Demandcurl -H "X-API-Key: pro_key" \
  https://api.kairossignal.com/v1/gpu-supply-demand