TAO Council Verdict

curl https://api.aioka.io/v1/tao/council \
  -H "X-API-Key: aik_pro_your_key_here"

{
  "verdict": {
    "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "ruling": "ACCUMULATE",
    "confidence": 0.74,
    "agentVotes": {
      "SUBNET_ORACLE": {"ruling": "BUY", "confidence": 0.78},
      "MACRO_SAGE": {"ruling": "ACCUMULATE", "confidence": 0.71},
      "AI_NARRATIVE": {"ruling": "BUY", "confidence": 0.82},
      "MOMENTUM_HUNTER": {"ruling": "ACCUMULATE", "confidence": 0.69},
      "LIQUIDITY_GUARDIAN": {"ruling": "ACCUMULATE", "confidence": 0.73},
      "RISK_WARDEN": {"ruling": "HOLD", "confidence": 0.61}
    },
    "riskFlags": [],
    "chiefRationale": "Subnet growth and AI narrative tailwinds support accumulation. RISK_WARDEN's HOLD dissent noted -- liquidity probe marginally above floor. Confidence trimmed to 0.74 to reflect uncertainty.",
    "plainExplanation": "The council leaned bullish on TAO because subnet activity and the AI narrative are gaining strength while liquidity conditions remain healthy. Momentum supports the move, so the stance is a measured buy.",
    "snapshotSignals": {
      "tao_price": 289.40,
      "rsi_1h": 54.2,
      "ema_200": 281.30,
      "subnet_count_growth": 0.034,
      "staking_ratio": 0.621
    },
    "createdAt": "2026-05-06T08:30:00+00:00"
  },
  "nextRefreshMinutes": 30
}

GET

tao

council

curl https://api.aioka.io/v1/tao/council \
  -H "X-API-Key: aik_pro_your_key_here"

{
  "verdict": {
    "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "ruling": "ACCUMULATE",
    "confidence": 0.74,
    "agentVotes": {
      "SUBNET_ORACLE": {"ruling": "BUY", "confidence": 0.78},
      "MACRO_SAGE": {"ruling": "ACCUMULATE", "confidence": 0.71},
      "AI_NARRATIVE": {"ruling": "BUY", "confidence": 0.82},
      "MOMENTUM_HUNTER": {"ruling": "ACCUMULATE", "confidence": 0.69},
      "LIQUIDITY_GUARDIAN": {"ruling": "ACCUMULATE", "confidence": 0.73},
      "RISK_WARDEN": {"ruling": "HOLD", "confidence": 0.61}
    },
    "riskFlags": [],
    "chiefRationale": "Subnet growth and AI narrative tailwinds support accumulation. RISK_WARDEN's HOLD dissent noted -- liquidity probe marginally above floor. Confidence trimmed to 0.74 to reflect uncertainty.",
    "plainExplanation": "The council leaned bullish on TAO because subnet activity and the AI narrative are gaining strength while liquidity conditions remain healthy. Momentum supports the move, so the stance is a measured buy.",
    "snapshotSignals": {
      "tao_price": 289.40,
      "rsi_1h": 54.2,
      "ema_200": 281.30,
      "subnet_count_growth": 0.034,
      "staking_ratio": 0.621
    },
    "createdAt": "2026-05-06T08:30:00+00:00"
  },
  "nextRefreshMinutes": 30
}

Pro tier endpoint — requires a valid Pro API key. The TAO council runs 6 specialist agents tuned to Bittensor-specific intelligence.

Tier: Pro ($199/mo) Cache: None Rate limit: 30/min (per tier) Read-only: Never writes to any trading table.

Response Fields

Top-level

Field	Type	Meaning
`verdict`	object \| null	Latest TAO council verdict. `null` if no verdict has been produced yet (first 30 minutes after deploy).
`nextRefreshMinutes`	int	Minutes until the next scheduled council auto-refresh. Always `30`.

verdict fields

Field	Type	Meaning
`id`	string	UUID of this verdict record
`ruling`	string	`STRONG_BUY` / `BUY` / `ACCUMULATE` / `HOLD` / `REDUCE` / `SELL` / `STRONG_SELL` / `AVOID`
`confidence`	number	0.0 — 1.0. TAO entry threshold is confidence ≥ 0.72.
`agentVotes`	object	Per-agent breakdown from all 6 TAO specialist agents
`agentVotes.<AGENT>`	object	Each agent entry has `ruling` (string) and `confidence` (number)
`riskFlags`	array	Active risk flags raised by RISK_WARDEN or LIQUIDITY_GUARDIAN. Possible values: `LIQUIDITY_RISK`, `MANIPULATION_RISK`, `INSUFFICIENT_DATA`, `ETF_EVENT_WINDOW`, `CENTRALIZED_AI_OVERHANG`, `INSTITUTIONAL_REBAL`
`chiefRationale`	string \| null	Chief Judge’s plain-language explanation of the ruling and why agent disagreements were resolved as they were
`plainExplanation`	string \| null	Plain-English, jargon-free 2-3 sentence summary of WHY the council reached its ruling, synthesized by the Chief Judge in the same call. `null` for historical verdicts recorded before this feature.
`snapshotSignals`	object	Raw signal readings at the time of council deliberation (key-value pairs)
`createdAt`	string	ISO 8601 timestamp of verdict

Specialist Agents

The TAO council replaces the generic BTC/ETH agent personas with 6 specialists calibrated for Bittensor-specific intelligence:

Agent	Domain
`SUBNET_ORACLE`	On-chain Bittensor: subnet count, staking ratio, emission rate, validator Nakamoto coefficient
`MACRO_SAGE`	Global macro environment: DXY, US10Y, risk-on/off regime, Fed tone
`AI_NARRATIVE`	AI sector sentiment: NVDA, BOTZ/IRBO ETF flows, GitHub commit velocity
`MOMENTUM_HUNTER`	Price momentum: TAO/BTC ratio trend, RSI, EMA proximity, 4H/1D bias
`LIQUIDITY_GUARDIAN`	Order-book and on-chain liquidity: Kraken depth, volume surge, stablecoin flows
`RISK_WARDEN`	Tail-event detection: manipulation flags, ETF event windows, institutional rebalancing

Risk Flags

Risk flags are raised by RISK_WARDEN and LIQUIDITY_GUARDIAN during deliberation. One or more flags in the response does not automatically block an entry — the Chief Judge weighs flags against confidence scores. However, LIQUIDITY_RISK in combination with a low liquidityDepthUsd typically results in an AVOID or HOLD ruling.

Flag	Trigger
`LIQUIDITY_RISK`	Gate 0 liquidity probe returns INSUFFICIENT
`MANIPULATION_RISK`	Volume spike without matching price or depth confirmation
`INSUFFICIENT_DATA`	One or more critical signals unavailable (e.g. taostats.io timeout)
`ETF_EVENT_WINDOW`	Upcoming BTC or crypto ETF event within ±48h (macro contagion risk)
`CENTRALIZED_AI_OVERHANG`	Major centralized AI model release within ±72h (TAO narrative headwind)
`INSTITUTIONAL_REBAL`	13F filing window or end-of-quarter rebalancing detected

curl https://api.aioka.io/v1/tao/council \
  -H "X-API-Key: aik_pro_your_key_here"

{
  "verdict": {
    "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "ruling": "ACCUMULATE",
    "confidence": 0.74,
    "agentVotes": {
      "SUBNET_ORACLE": {"ruling": "BUY", "confidence": 0.78},
      "MACRO_SAGE": {"ruling": "ACCUMULATE", "confidence": 0.71},
      "AI_NARRATIVE": {"ruling": "BUY", "confidence": 0.82},
      "MOMENTUM_HUNTER": {"ruling": "ACCUMULATE", "confidence": 0.69},
      "LIQUIDITY_GUARDIAN": {"ruling": "ACCUMULATE", "confidence": 0.73},
      "RISK_WARDEN": {"ruling": "HOLD", "confidence": 0.61}
    },
    "riskFlags": [],
    "chiefRationale": "Subnet growth and AI narrative tailwinds support accumulation. RISK_WARDEN's HOLD dissent noted -- liquidity probe marginally above floor. Confidence trimmed to 0.74 to reflect uncertainty.",
    "plainExplanation": "The council leaned bullish on TAO because subnet activity and the AI narrative are gaining strength while liquidity conditions remain healthy. Momentum supports the move, so the stance is a measured buy.",
    "snapshotSignals": {
      "tao_price": 289.40,
      "rsi_1h": 54.2,
      "ema_200": 281.30,
      "subnet_count_growth": 0.034,
      "staking_ratio": 0.621
    },
    "createdAt": "2026-05-06T08:30:00+00:00"
  },
  "nextRefreshMinutes": 30
}

Authorizations

X-API-Key

string

header

required

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

Response

TAO council verdict

verdict

TAOCouncilVerdict · object | null

Show child attributes

nextRefreshMinutes

integer

default:30

Public

Free Tier

Basic Tier ($49/mo)

Webhooks (Basic+)

Pro Tier ($199/mo)

API Keys

Response Fields

Top-level

verdict fields

Specialist Agents

Risk Flags

Authorizations

Response

​Response Fields

​Top-level

​verdict fields

​Specialist Agents

​Risk Flags

Authorizations

Response

Response Fields

Top-level

verdict fields

Specialist Agents

Risk Flags