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.

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

RESPONSE (abridged){
  "count": 800,
  "live": 457,
  "networks": [
    {"symbol": "IO", "name": "io.net", "tier": "first_party", "chain": "solana"},
    {"symbol": "HELIUM", "name": "Helium", "tier": "first_party", "chain": "solana"},
    {"symbol": "FIL", "name": "Filecoin", "tier": "onchain_market", "chain": "evm"},
    {"symbol": "X", "name": "Catalog-only network", "tier": "catalog_only"}
  ]
}

Tier values: first_party (383), onchain_market (78), catalog_only (339).

Single network detail. Use the network symbol (e.g. IO, HELIUM). Requires a valid key.

CURL — Network Detailcurl -H "X-API-Key: your_key" \
  https://api.kairossignal.com/v1/network/IO

Returns symbol, name, chain, tier, live series list, last update, and linked provenance.

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": 11061,
  "networks": 383,
  "supply": [
    {"network": "IO", "total_supply": 123456789, "circulating": 98765432,
     "source": "solana_rpc", "as_of": "2026-08-25T11:00:00Z",
     "verify_url": "https://api.mainnet-beta.solana.com/...", "freshness": "fresh"}
  ]
}

Market data — price, market cap, volume — sourced from CoinGecko and DefiLlama. Requires key.

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

Protocol revenue / fees. Real fee capture per network. Requires key.

CURL — Revenuecurl -H "X-API-Key: your_key" \
  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. Requires key.

CURL — Historycurl -H "X-API-Key: your_key" \
  "https://api.kairossignal.com/v1/history?network=IO&metric=circulating_supply&days=30"

RESPONSE (abridged){
  "network": "IO", "metric": "circulating_supply", "days": 30,
  "points": [{"ts": "2026-08-25T00:00:00Z", "value": 98765432}, ...]
}

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/HELIUM

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/IO

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:6035/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:6035/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:6035/v1/bot-detection

Competitive-landscape engine. Returns 4 competitive metrics.

CURL — Competitive Landscapecurl -H "X-API-Key: pro_key" \
  https://api.kairossignal.com:6035/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:6035/v1/gpu-supply-demand