API Documentation
Programmatic access to SubnetAIQ's subnet intelligence. JSON endpoints for live data, signals, charts, and reports.
BASE URL · https://subnetaiq.io/api
🔐 Authentication
All API requests require an API key passed in the Authorization header:
curl -H "Authorization: Bearer YOUR_API_KEY" https://subnetaiq.io/api/live
API keys are provided with Pro ($19.99/mo), Institutional ($99/mo) and Enterprise ($299/mo) subscriptions.
⏱️ Rate Limits
| Tier | Requests / Minute | Requests / Day |
|---|
| Pro | 30 | 5,000 |
| Fund | 120 | 50,000 |
📡 Endpoints
Live data for all 128 subnets. Continuously updated.
Response Example
{
"timestamp": "2026-03-30T15:00:00",
"block": 7859224,
"subnet_count": 128,
"total_tao_in": 7346704,
"subnets": [
{
"netuid": 64,
"name": "Chutes",
"price": 0.086983,
"tao_in": 217158,
"description": "Breakthrough Serverless Compute..."
},
...
]
}
Latest institutional research report in markdown format.
Response Example
{
"report": "# SubnetAIQ Institutional Research Report\n\n**Report Date:** ...",
"generated": "2026-03-30T10:25:00"
}
Historical price, liquidity, and miner data for a specific subnet.
| Parameter | Type | Description |
|---|
netuid | integer | Subnet ID (1-128) |
Response Example
{
"netuid": 64,
"name": "Chutes",
"dates": ["2026-03-28", "2026-03-29", "2026-03-30"],
"prices": [0.0857, 0.0862, 0.0870],
"liquidity": [215542, 216340, 217158],
"miners": [36, 38, 36]
}
Deep subnet analysis — scoring, risk flags, network metrics, competitive position.
| Parameter | Type | Description |
|---|
netuid | integer | Subnet ID (1-128) |
Response Example
{
"netuid": 64,
"name": "Chutes",
"score": 81,
"signal": "STRONG CONVICTION",
"sector": "Compute & Infrastructure",
"market_position": "#1 Market Leader",
"price": 0.086983,
"tao_in": 217158,
"active_miners": 36,
"validators": 73,
"total_stake": 5241893,
"stake_concentration": 0.342,
"emission_gini": 0.74,
"risk_flags": ["MEDIUM: Concentrated stake"],
"competitive_advantages": ["Liquidity 126% above sector average"],
"competitive_weaknesses": []
}
Head-to-head comparison of two subnets with all metrics.
| Parameter | Type | Description |
|---|
netuid_a | integer | First subnet ID |
netuid_b | integer | Second subnet ID |
Recent alerts — price moves >10%, liquidity shifts, new/delisted subnets.
Response Example
{
"alerts": [
{
"timestamp": "2026-03-30T12:00:00",
"type": "PRICE_MOVE",
"severity": "HIGH",
"netuid": 58,
"name": "Handshake",
"message": "SN58 Handshake price surged 12.9%",
"change_pct": 12.9
}
]
}
Validator leaderboard for a specific subnet or global (netuid=0).
| Parameter | Type | Description |
|---|
netuid | integer | Subnet ID (0 for global) |
All sector classifications with member subnets.
🔧 SDKs & Integration
Python
import requests
headers = {"Authorization": "Bearer YOUR_API_KEY"}
response = requests.get("https://subnetaiq.io/api/live", headers=headers)
data = response.json()
for subnet in data["subnets"][:5]:
print(f"SN{subnet['netuid']} {subnet['name']}: {subnet['tao_in']:,.0f} TAO")
JavaScript
const response = await fetch("https://subnetaiq.io/api/live", {
headers: { "Authorization": "Bearer YOUR_API_KEY" }
});
const data = await response.json();
console.log(`${data.subnet_count} subnets, ${data.total_tao_in} TAO locked`);
cURL
curl -s https://subnetaiq.io/api/live \
-H "Authorization: Bearer YOUR_API_KEY" | jq '.subnets[:3]'
🪝 Webhook Alerts (Fund Tier)
Fund tier subscribers can configure webhook URLs to receive real-time alerts:
POST https://your-server.com/webhook
{
"event": "PRICE_MOVE",
"subnet": { "netuid": 64, "name": "Chutes" },
"change_pct": 15.2,
"message": "SN64 Chutes price surged 15.2%",
"timestamp": "2026-03-30T12:00:00Z"
}
Contact us to configure webhook endpoints for your account.