← Back to kairossignal.com

KAIROS Signal API

The only comprehensive DePIN data API. 350+ projects, 254+ variables per project, 800,000+ global sensors. All cleaned, normalized, and cross-validated against physical infrastructure reality.

Base URL: https://kairossignal.com/api/v1
Auth: API key via X-API-Key header
Format: JSON (all responses)
Rate Limits: 100–10,000 req/min depending on tier

Technical Brief

KAIROS Signal is a vertically-integrated data intelligence platform purpose-built for decentralized physical infrastructure networks (DePIN). Rather than repackaging existing exchange feeds, we built a multi-layer ingestion and analysis pipeline that connects five distinct data domains:

1. DePIN Project Layer

Direct ingestion from 350+ DePIN project APIs, on-chain contracts, and validator endpoints. We collect node count, uptime, throughput, capacity, earnings, churn rate, geographic distribution, and 240+ additional variables per project. Each collector runs on a concurrent pipeline with configurable refresh cadence.

2. Solana On-Chain Layer

Dedicated RPC connections to Solana mainnet for real-time token analytics — supply, price, holder distribution, and DeFi activity across all Solana-native DePIN tokens. Separate market data collectors cross-reference pricing from multiple independent oracles.

3. Physical Sensor Network

800,000+ sensors from NOAA Space Weather, US Energy Grids (EIA), Maritime AIS, and 15+ government agencies. These physical-world signals are correlated with on-chain network performance to identify divergences invisible to pure financial analysis.

4. Exchange & Market Data

High-throughput WebSocket ingestion from major exchanges — order books, trades, funding rates, open interest, and liquidation events. Data is passed through an artifact rejection sieve before storage to eliminate anomalous ticks and bad data.

5. Analytical Engine (17 Layers)

All raw data passes through 17 proprietary analytical layers grounded in econophysics, information theory, and nonlinear dynamics:

Domain Methods Applied Output
Data Quality Artifact detection, outlier rejection, sanity thresholds Clean, validated data free of anomalous ticks
Econophysics Statistical mechanics, spectral analysis, fractal geometry, long-range dependence estimation Structural market properties invisible to standard TA
Game Theory Combinatorial Nash equilibria, multi-agent payoff modeling Participant behavior prediction and equilibrium detection
Information Theory Entropy measures, causal inference, directed information flow Order flow quality and cross-asset causality
Nonlinear Dynamics Chaos detection, regime classification, wavelet decomposition Market regime labels and transition probabilities
Cross-Domain Correlation Physical sensor × crypto correlation matrices, Reality Gap™ computation Divergence scores between on-chain claims and physical reality
Synthesis Composite scoring, health indices, AI-powered assessment, macro overlay Unified project grades, investment theses, and composite signals
17 layers total. The specific implementation of each layer is proprietary. The table above groups layers by methodological domain. API subscribers receive the computed outputs — scores, grades, regime labels, and signals — not the raw intermediate calculations.

Data Pipeline Architecture

ARCHITECTURE
┌─────────────────────────────────────────────────────────────────────┐
│  INGESTION LAYER                                                     │
│  ┌──────────────┐ ┌───────────┐ ┌──────────┐ ┌──────────────────┐  │
│  │  DePIN APIs   │ │  Solana   │ │ Exchange │ │  Physical Sensor │  │
│  │  350+ direct  │ │  RPC +    │ │  WebSocket│ │  NOAA / EIA /   │  │
│  │  collectors   │ │  Oracles  │ │  Streams │ │  AIS / Gov      │  │
│  └──────┬───────┘ └─────┬─────┘ └─────┬────┘ └────────┬────────┘  │
│         └───────────────┴─────────────┴────────────────┘            │
│                                │                                     │
│                    L1 Sieve (artifact rejection)                     │
│                                ▼                                     │
│                   ┌────────────────────────┐                        │
│                   │   ClickHouse Cluster    │                        │
│                   │   48 tables · ~100M/day │                        │
│                   └───────────┬────────────┘                        │
│                               ▼                                     │
│                   ┌────────────────────────┐                        │
│                   │  17 Analytical Layers   │                        │
│                   │  Econophysics Engine    │                        │
│                   └───────────┬────────────┘                        │
│                               ▼                                     │
│    ┌───────────┐   ┌────────────┐   ┌──────────────┐               │
│    │ REST API  │   │ WebSocket  │   │  Snowflake   │               │
│    └───────────┘   └────────────┘   └──────────────┘               │
└─────────────────────────────────────────────────────────────────────┘

Authentication

All API requests require an API key passed in the X-API-Key header. You receive your API key immediately after subscribing.

CURLcurl -H "X-API-Key: ks_your_api_key_here" \
  https://kairossignal.com/api/v1/projects
PYTHONimport requests

API_KEY = "ks_your_api_key_here"
BASE = "https://kairossignal.com/api/v1"

headers = {"X-API-Key": API_KEY}
projects = requests.get(f"{BASE}/projects", headers=headers).json()
JAVASCRIPTconst API_KEY = "ks_your_api_key_here";
const BASE = "https://kairossignal.com/api/v1";

const res = await fetch(`${BASE}/projects`, {
  headers: { "X-API-Key": API_KEY }
});
const projects = await res.json();

Quick Start

Get up and running in 60 seconds:

BASH# 1. Subscribe at https://kairossignal.com/#pricing
# 2. Copy your API key from the success page
# 3. Test it:

export KAIROS_KEY="ks_your_key_here"

# List all 350+ DePIN projects
curl -s -H "X-API-Key: $KAIROS_KEY" \
  https://kairossignal.com/api/v1/projects | python3 -m json.tool

# Get Reality Gap scores
curl -s -H "X-API-Key: $KAIROS_KEY" \
  https://kairossignal.com/api/v1/reality-gap | python3 -m json.tool

# Check your account & usage
curl -s -H "X-API-Key: $KAIROS_KEY" \
  https://kairossignal.com/api/v1/account | python3 -m json.tool

Rate Limits & Tiers

Tier Price Rate Limit Key Features
Developer $200/mo 100 req/min REST API, Health Dashboard, Reality Gap™ (daily)
Observer $499/mo 500 req/min + WebSocket streaming, weekly econophysics briefing
Analyst $4,166/mo 2,000 req/min + Full pipeline access, Snowflake, historical data, Fractal Z-Cascade
Enterprise Custom 10,000 req/min + Custom schemas, due diligence packages, dedicated support
Rate limit exceeded? You'll receive a 429 Too Many Requests response with a Retry-After header. Upgrade your tier or batch your requests.

API Reference

GET /api/v1/projects Developer+

Returns all 350+ DePIN project profiles with latest metrics.

Response Fields

Field Type Description
slug string URL-safe project identifier
name string Project display name
category string DePIN category (compute, storage, wireless, sensor, etc.)
price_usd float Current token price in USD
market_cap float Market capitalization
active_nodes int Currently active network nodes
total_nodes int Total registered nodes
health_score float Composite health index (0–100)
reality_gap float Reality Gap™ divergence score
uptime_pct float Network uptime percentage
earnings_per_node float Daily earnings per node (USD)
EXAMPLE RESPONSE{
  "projects": [
    {
      "slug": "helium",
      "name": "Helium",
      "category": "wireless",
      "price_usd": 8.42,
      "market_cap": 1420000000,
      "active_nodes": 375420,
      "total_nodes": 982000,
      "health_score": 82.4,
      "reality_gap": 0.12,
      "uptime_pct": 94.7,
      "earnings_per_node": 0.18
    },
    ...
  ],
  "count": 352,
  "updated_at": "2026-02-15T10:20:00Z"
}
GET /api/v1/projects/{slug} Developer+

Full profile for a single project — all 254+ variables.

Returns everything from the list endpoint plus deep network stats, enrichment data, AI intelligence, and grade assessments.

GET /api/v1/projects/{slug}/history Analyst+

Historical time series for a project. Up to 90 days of data at configurable resolution.

Query Parameters

Param Type Default Description
days int 30 Number of days (max 90)
resolution string 1h 5m, 15m, 1h, 4h, 1d
GET /api/v1/reality-gap Developer+

Reality Gap™ divergence scores for all projects. Measures the gap between on-chain claims and physical infrastructure reality.

A score of 0.0 = perfect alignment. Scores above 0.3 indicate significant divergence — the network's on-chain metrics don't match physical sensor verification.

EXAMPLE RESPONSE{
  "reality_gap": [
    {
      "project": "helium",
      "gap_score": 0.12,
      "on_chain_nodes": 982000,
      "verified_active": 375420,
      "confidence": 0.94,
      "last_verified": "2026-02-15T10:00:00Z"
    },
    ...
  ]
}
GET /api/v1/analytics/regime Analyst+

Current regime classifications (HMM-based) and distribution across all tracked assets.

Regimes: trending_bull, trending_bear, mean_reverting, high_volatility, low_volatility, chaotic

GET /api/v1/account Developer+

Your account info, tier, usage stats, and rate limit status.

Data Schema

KAIROS runs on ClickHouse with 48 tables. Below are the tables available to API subscribers. Analyst+ tiers get direct Snowflake access to query these schemas directly.

Snowflake delivery: Analyst and Enterprise tiers receive a private Snowflake listing with the full schema. Query with standard SQL — no API rate limits apply.

DePIN Core Tables

📊 depin_stats

Core project metrics — price, nodes, revenue, uptime. Updated every 3 minutes.

Column Type Description
timestamp DateTime64(3) Collection timestamp
project_id String Unique project identifier
project_name String Display name
category String compute, storage, wireless, sensor, AI, etc.
price_usd Float64 Current token price
market_cap Float64 Market capitalization
volume_24h Float64 24h trading volume
active_nodes Int64 Active node count
total_nodes Int64 Total registered nodes
network_revenue Float64 Cumulative network revenue
revenue_24h Float64 Last 24h revenue
earnings_per_node Float64 Daily earnings per node (USD)
device_cost Float64 Estimated hardware cost
roi_days Float64 Estimated ROI in days
latency_ms Float64 Network latency
uptime_pct Float64 Network uptime %
sentiment_score Float64 Community sentiment (-1 to 1)
source String Data source identifier

🔬 depin_deep_intel

Deep network statistics — node growth, churn, capacity, geographic distribution. 30+ fields per project.

Column Type Description
total_nodes Int64 Total node count
active_nodes Int64 Active nodes
node_uptime_avg_pct Float64 Average uptime
earnings_per_node_24h_usd Float64 Daily earnings
estimated_roi_months Float64 ROI estimate
nodes_added_24h Int64 New nodes (24h)
nodes_added_7d Int64 New nodes (7d)
growth_rate_7d_pct Float64 Weekly growth rate
churn_rate_7d_pct Float64 Weekly churn rate
network_utilization_pct Float64 Capacity utilization
capacity_total Float64 Total network capacity
capacity_used Float64 Used capacity
network_revenue_24h_usd Float64 Network revenue (24h)
countries_covered Int32 Country count
geographic_concentration_pct Float64 Geographic concentration

💎 depin_enrichment

Market microstructure — funding rates, open interest, TVL, GitHub activity, liquidity depth. 40+ fields per project.

Column Type Description
fdv Float64 Fully diluted valuation
mc_fdv_ratio Float64 Market cap / FDV ratio
vol_mcap_ratio Float64 Volume / market cap ratio
price_change_1h/24h/7d/30d Float64 Price changes over various periods
ath Float64 All-time high price
github_stars/forks/watchers UInt32 GitHub repository metrics
github_last_commit String Last commit timestamp
funding_rate Float64 Perpetual funding rate
open_interest Float64 Open interest (USD)
long_short_ratio Float64 Long/short ratio
liquidity_depth_2pct Float64 Orderbook depth ±2%
tvl Float64 Total value locked
mcap_tvl_ratio Float64 Market cap / TVL ratio

🏥 depin_health_profiles

Composite health scoring with Reality Gap™.

Column Type Description
health_score Float32 Composite health (0–100)
reality_gap Float64 On-chain vs physical divergence
data_completeness_pct Float32 Variable coverage
profile_json String Full profile (JSON blob)

🎓 depin_grades

Investment grading — growth, utility, risk, AI thesis. Letter grades (A+ through F).

Column Type Description
overall_grade String Letter grade (A+ to F)
health_score Float32 Health component
growth_score Float32 Growth component
investment_score Float32 Investment attractiveness
utility_score Float32 Real utility assessment
risk_score Float32 Risk assessment
expected_apy Float32 Expected annual yield
ai_thesis String AI-generated investment thesis
ai_risk_factors String AI-identified risk factors

Market Data Tables

📈 market_ticks

Real-time price and volume ticks across all exchanges. ~1500 TPS ingestion rate.

Column Type Description
timestamp DateTime64(3) Tick timestamp (ms precision)
symbol String Trading pair (e.g. BTCUSDT)
price Float64 Trade price
volume Float64 Trade volume
source String Exchange (binance, bybit, okx, etc.)
sector String Sector tag

📊 funding_rates

Column Type Description
symbol String Perpetual contract symbol
rate Float64 Funding rate
open_interest Float64 Open interest (USD)
predicted_rate Float64 Next predicted rate

🔗 cross_correlations

Crypto × physical sensor correlation matrices. Updated hourly.

Column Type Description
crypto_symbol String Crypto asset
sensor_category String Sensor type
correlation_1h/4h/24h/7d Float64 Correlation over timeframes
p_value Float64 Statistical significance
signal_strength String strong, moderate, weak, none

Sensor Network

🌐 sensor_readings

800,000+ global sensors — NOAA, EIA, maritime, aviation, environmental.

Column Type Description
sensor_id String Unique sensor ID
network String Sensor network (NOAA, EIA, AIS, etc.)
name String Station/sensor name
latitude Float64 Latitude
longitude Float64 Longitude
category String temperature, wind, solar, maritime, aviation
measurements String JSON measurement blob
country String ISO country code
region String Geographic region

🌍 global_pulse

Macro indicators — VIX, DXY, US10Y, Fear & Greed, Bitcoin dominance.

Column Type Description
metric String Indicator name
value Float64 Current value

Intelligence Tables

🧠 depin_ai_intel

AI-generated intelligence — investment theses, risk factors, conviction scores. LLM-powered analysis per project.

Column Type Description
investment_thesis String AI-generated thesis
conviction_score Float64 AI conviction (0–1)
sector_health_score Float64 Sector health assessment
sustainability_score Float64 Long-term sustainability
moat_score Float64 Competitive moat strength
risk_factors String Identified risk factors
anomaly_flags String Detected anomalies

📉 layer_scores

17-layer analytical engine output per asset.

Column Type Description
symbol String Asset symbol
scores String JSON — all 17 layer scores
regime String Detected market regime
signal_direction String LONG / SHORT / NEUTRAL
weighted_conf Float64 Weighted confidence (0–1)

Solana On-Chain

solana_transactions

Full Solana transaction stream — DEX trades, vote transactions, program invocations.

Column Type Description
signature String Transaction signature
slot UInt64 Block slot
fee UInt64 Transaction fee (lamports)
success Bool Transaction success
is_dex Bool DEX trade flag
dex_name String DEX name if applicable
program_ids Array(String) Invoked program IDs

🐋 solana_whale_alerts

Large Solana transfers and whale movements.

Column Type Description
from_wallet String Sender wallet
to_wallet String Receiver wallet
token String Token transferred
amount Float64 Token amount
usd_value Float64 USD value
is_known_whale Bool Known whale flag
whale_name String Whale identifier

Delivery Options

Method Tier Description
REST API Developer+ JSON responses, rate-limited, immediate access
WebSocket Observer+ Real-time streaming (3-min cadence)
Snowflake Analyst+ Private listing, query with SQL, no rate limits
Custom Export Enterprise Custom schemas, Parquet/CSV delivery, dedicated pipeline

Snowflake Marketplace

Analyst and Enterprise tier subscribers receive access to a private Snowflake listing. You can query all KAIROS tables directly with standard SQL — no API rate limits, no pagination.

SNOWFLAKE SQL-- All DePIN projects ranked by Reality Gap divergence
SELECT
    project_name,
    category,
    health_score,
    reality_gap,
    active_nodes,
    earnings_per_node
FROM kairos.depin_health_profiles
WHERE timestamp > DATEADD(hour, -1, CURRENT_TIMESTAMP())
ORDER BY reality_gap DESC
LIMIT 20;

-- Cross-correlations between crypto and physical sensors
SELECT
    crypto_symbol,
    sensor_category,
    correlation_24h,
    p_value,
    signal_strength
FROM kairos.cross_correlations
WHERE ABS(correlation_24h) > 0.5
  AND p_value < 0.05
ORDER BY ABS(correlation_24h) DESC;

Webhooks (Coming Soon)

Configure webhook endpoints to receive push notifications for Reality Gap™ alerts, regime changes, and whale movements. Available Q2 2026.

KAIROS Signal Labs · support@kairossignal.com · Home · Pricing

Data for informational and research purposes only. Not investment advice.