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.
https://kairossignal.com/api/v1Auth: API key via
X-API-Key headerFormat: 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 |
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 |
429 Too Many Requests response
with a Retry-After header. Upgrade your tier or batch your requests.
API Reference
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"
}
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.
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 |
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"
},
...
]
}
Current regime classifications (HMM-based) and distribution across all tracked assets.
Regimes: trending_bull, trending_bear, mean_reverting,
high_volatility, low_volatility, chaotic
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.
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.