Skip to main content
GET
/
v1
/
tao
/
signals
curl https://api.aioka.io/v1/tao/signals \
  -H "X-API-Key: aik_pro_your_key_here"

{
  "signals": [
    {
      "key": "SUBNET_COUNT_GROWTH",
      "value": 0.034,
      "direction": "BULLISH",
      "source": "taostats.io",
      "detail": "Active subnets grew 3.4% in the past 30 days (64 -> 66)",
      "fetchedAt": "2026-05-06T08:00:00+00:00"
    },
    {
      "key": "TAO_STAKING_RATIO",
      "value": 0.621,
      "direction": "BULLISH",
      "source": "taostats.io",
      "detail": "62.1% of supply staked -- above 60% threshold",
      "fetchedAt": "2026-05-06T08:00:00+00:00"
    },
    {
      "key": "TAO_EMISSION_RATE",
      "value": 0.512,
      "direction": "BULLISH",
      "source": "taostats.io",
      "detail": "Post-halving compression: emission at 51.2% of pre-halving rate. 157 days since 2025-12-01 halving.",
      "fetchedAt": "2026-05-06T08:00:00+00:00"
    },
    {
      "key": "VALIDATOR_NAKAMOTO_COEFFICIENT",
      "value": 12.0,
      "direction": "NEUTRAL",
      "source": "taostats.io",
      "detail": "12 validators control 51% of stake (unchanged vs last week)",
      "fetchedAt": "2026-05-06T08:00:00+00:00"
    },
    {
      "key": "TAO_BTC_RATIO_TREND",
      "value": 0.0048,
      "direction": "BULLISH",
      "source": "kraken",
      "detail": "TAO/BTC ratio up 0.48% over 7 days -- TAO outperforming BTC",
      "fetchedAt": "2026-05-06T10:28:00+00:00"
    },
    {
      "key": "BITTENSOR_GITHUB_ACTIVITY",
      "value": 1.4,
      "direction": "BULLISH",
      "source": "github",
      "detail": "Weekly commit count z-score +1.4 vs 90-day baseline (above average dev activity)",
      "fetchedAt": "2026-05-06T08:00:00+00:00"
    },
    {
      "key": "AI_SECTOR_SENTIMENT",
      "value": 0.62,
      "direction": "BULLISH",
      "source": "yahoo_finance",
      "detail": "NVDA +2.1% (5d), BOTZ +0.8% (5d), IRBO +1.2% (5d) -- composite bullish",
      "fetchedAt": "2026-05-06T10:25:00+00:00"
    },
    {
      "key": "SUBNET_REVENUE",
      "value": 142500.0,
      "direction": "NEUTRAL",
      "source": "defi_llama",
      "detail": "7-day subnet revenue $142,500 -- stable vs prior week",
      "fetchedAt": "2026-05-06T08:00:00+00:00"
    },
    {
      "key": "INSTITUTIONAL_POSITIONING",
      "value": null,
      "direction": "UNKNOWN",
      "source": "sec_edgar",
      "detail": "Outside 13F filing window -- next data expected Q3 2026",
      "fetchedAt": "2026-05-06T08:00:00+00:00"
    }
  ],
  "liquidityStatus": "SUFFICIENT",
  "liquidityDepthUsd": 82500.0,
  "generatedAt": "2026-05-06T10:30:00+00:00"
}

Documentation Index

Fetch the complete documentation index at: https://docs.aioka.io/llms.txt

Use this file to discover all available pages before exploring further.

Pro tier endpoint — requires a valid Pro API key. Fetches fresh signal readings on every request (expect 1 — 3 seconds response time).
Tier: Pro ($199/mo) Cache: None — fetches fresh on every request Rate limit: 30/min (per tier) Read-only: No writes.

​
Response Fields

​
Top-level

FieldTypeMeaning
signalsarrayLatest readings for each TAO signal, one entry per signal key
liquidityStatusstringGate 0 result: "SUFFICIENT" / "INSUFFICIENT" / "UNKNOWN"
liquidityDepthUsdnumber | nullKraken order-book depth (USD) within ±0.5% of mid-price. null when probe fails.
generatedAtstringResponse timestamp (ISO 8601)

​
Per-signal (signals array)

FieldTypeMeaning
keystringSignal identifier (see signal catalog below)
valuenumber | nullLatest numeric reading. null when the source is temporarily unavailable.
directionstring"BULLISH" / "BEARISH" / "NEUTRAL" / "UNKNOWN"
sourcestringData source identifier (e.g. "taostats.io", "github", "defi_llama")
detailstringHuman-readable description of the current reading
fetchedAtstringISO 8601 timestamp of when this reading was captured

​
TAO Signal Catalog

All 9 TAO-specific signals are listed below. Signals feed the specialist agent deliberation every 30 minutes and are written to tao_signal_history.
Signal KeyDescriptionSourceAgent
SUBNET_COUNT_GROWTH30-day growth rate of active Bittensor subnets (%)taostats.ioSUBNET_ORACLE
TAO_STAKING_RATIO% of total TAO supply currently staked to validatorstaostats.ioSUBNET_ORACLE
TAO_EMISSION_RATECurrent block emission rate relative to pre-halving baseline. < 1.0 = post-halving compression.taostats.ioSUBNET_ORACLE
VALIDATOR_NAKAMOTO_COEFFICIENTNakamoto coefficient of the validator set — minimum validators needed for 51% stake control. Higher = more decentralized.taostats.ioSUBNET_ORACLE
TAO_BTC_RATIO_TRENDTAO/BTC ratio 7-day trend direction (positive = TAO outperforming BTC)Internal (Kraken)MOMENTUM_HUNTER
BITTENSOR_GITHUB_ACTIVITYWeekly commit count on opentensor/bittensor repo (normalized z-score vs 90-day baseline)GitHub APIAI_NARRATIVE
AI_SECTOR_SENTIMENTComposite AI sector sentiment from NVDA 5-day momentum, BOTZ ETF flow, and IRBO ETF flowYahoo FinanceAI_NARRATIVE
SUBNET_REVENUEEstimated 7-day subnet revenue (USD) across top Bittensor subnets — proxy for network economic activityDeFiLlamaSUBNET_ORACLE
INSTITUTIONAL_POSITIONING13F filing signal — net change in institutional TAO exposure vs prior quarter. null outside filing windows (45-day lag).SEC/EDGARRISK_WARDEN

​
Notes

  • Signals sourced from taostats.io are polled every 30 minutes during the council refresh cycle. Individual signal age is visible in fetchedAt.
  • INSTITUTIONAL_POSITIONING is only populated during SEC 13F filing windows (quarterly, with a 45-day lag). It returns null between filing periods.
  • AI_SECTOR_SENTIMENT is a composite — a single score derived from three underlying components (NVDA, BOTZ, IRBO). Detail is exposed in the detail string of each entry.
  • The liquidityStatus and liquidityDepthUsd fields in the top-level response are always fresh (60s probe cache) — they are NOT pulled from tao_signal_history.
curl https://api.aioka.io/v1/tao/signals \
  -H "X-API-Key: aik_pro_your_key_here"

{
  "signals": [
    {
      "key": "SUBNET_COUNT_GROWTH",
      "value": 0.034,
      "direction": "BULLISH",
      "source": "taostats.io",
      "detail": "Active subnets grew 3.4% in the past 30 days (64 -> 66)",
      "fetchedAt": "2026-05-06T08:00:00+00:00"
    },
    {
      "key": "TAO_STAKING_RATIO",
      "value": 0.621,
      "direction": "BULLISH",
      "source": "taostats.io",
      "detail": "62.1% of supply staked -- above 60% threshold",
      "fetchedAt": "2026-05-06T08:00:00+00:00"
    },
    {
      "key": "TAO_EMISSION_RATE",
      "value": 0.512,
      "direction": "BULLISH",
      "source": "taostats.io",
      "detail": "Post-halving compression: emission at 51.2% of pre-halving rate. 157 days since 2025-12-01 halving.",
      "fetchedAt": "2026-05-06T08:00:00+00:00"
    },
    {
      "key": "VALIDATOR_NAKAMOTO_COEFFICIENT",
      "value": 12.0,
      "direction": "NEUTRAL",
      "source": "taostats.io",
      "detail": "12 validators control 51% of stake (unchanged vs last week)",
      "fetchedAt": "2026-05-06T08:00:00+00:00"
    },
    {
      "key": "TAO_BTC_RATIO_TREND",
      "value": 0.0048,
      "direction": "BULLISH",
      "source": "kraken",
      "detail": "TAO/BTC ratio up 0.48% over 7 days -- TAO outperforming BTC",
      "fetchedAt": "2026-05-06T10:28:00+00:00"
    },
    {
      "key": "BITTENSOR_GITHUB_ACTIVITY",
      "value": 1.4,
      "direction": "BULLISH",
      "source": "github",
      "detail": "Weekly commit count z-score +1.4 vs 90-day baseline (above average dev activity)",
      "fetchedAt": "2026-05-06T08:00:00+00:00"
    },
    {
      "key": "AI_SECTOR_SENTIMENT",
      "value": 0.62,
      "direction": "BULLISH",
      "source": "yahoo_finance",
      "detail": "NVDA +2.1% (5d), BOTZ +0.8% (5d), IRBO +1.2% (5d) -- composite bullish",
      "fetchedAt": "2026-05-06T10:25:00+00:00"
    },
    {
      "key": "SUBNET_REVENUE",
      "value": 142500.0,
      "direction": "NEUTRAL",
      "source": "defi_llama",
      "detail": "7-day subnet revenue $142,500 -- stable vs prior week",
      "fetchedAt": "2026-05-06T08:00:00+00:00"
    },
    {
      "key": "INSTITUTIONAL_POSITIONING",
      "value": null,
      "direction": "UNKNOWN",
      "source": "sec_edgar",
      "detail": "Outside 13F filing window -- next data expected Q3 2026",
      "fetchedAt": "2026-05-06T08:00:00+00:00"
    }
  ],
  "liquidityStatus": "SUFFICIENT",
  "liquidityDepthUsd": 82500.0,
  "generatedAt": "2026-05-06T10:30:00+00:00"
}

Authorizations

​
X-API-Key
string
header
required

Your AIOKA Intelligence API key (format: aik_{tier}_{random})

Response

TAO signals snapshot

​
signals
TAOSignalEntry · object[]
required
​
generatedAt
string<date-time>
required
​
liquidityStatus
string
default:UNKNOWN
​
liquidityDepthUsd
number | null