Skip to main content
GET
/
v1
/
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

FieldTypeMeaning
verdictobject | nullLatest TAO council verdict. null if no verdict has been produced yet (first 30 minutes after deploy).
nextRefreshMinutesintMinutes until the next scheduled council auto-refresh. Always 30.

​
verdict fields

FieldTypeMeaning
idstringUUID of this verdict record
rulingstringSTRONG_BUY / BUY / ACCUMULATE / HOLD / REDUCE / SELL / STRONG_SELL / AVOID
confidencenumber0.0 — 1.0. TAO entry threshold is confidence ≥ 0.72.
agentVotesobjectPer-agent breakdown from all 6 TAO specialist agents
agentVotes.<AGENT>objectEach agent entry has ruling (string) and confidence (number)
riskFlagsarrayActive 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
chiefRationalestring | nullChief Judge’s plain-language explanation of the ruling and why agent disagreements were resolved as they were
plainExplanationstring | nullPlain-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.
snapshotSignalsobjectRaw signal readings at the time of council deliberation (key-value pairs)
createdAtstringISO 8601 timestamp of verdict

​
Specialist Agents

The TAO council replaces the generic BTC/ETH agent personas with 6 specialists calibrated for Bittensor-specific intelligence:
AgentDomain
SUBNET_ORACLEOn-chain Bittensor: subnet count, staking ratio, emission rate, validator Nakamoto coefficient
MACRO_SAGEGlobal macro environment: DXY, US10Y, risk-on/off regime, Fed tone
AI_NARRATIVEAI sector sentiment: NVDA, BOTZ/IRBO ETF flows, GitHub commit velocity
MOMENTUM_HUNTERPrice momentum: TAO/BTC ratio trend, RSI, EMA proximity, 4H/1D bias
LIQUIDITY_GUARDIANOrder-book and on-chain liquidity: Kraken depth, volume surge, stablecoin flows
RISK_WARDENTail-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.
FlagTrigger
LIQUIDITY_RISKGate 0 liquidity probe returns INSUFFICIENT
MANIPULATION_RISKVolume spike without matching price or depth confirmation
INSUFFICIENT_DATAOne or more critical signals unavailable (e.g. taostats.io timeout)
ETF_EVENT_WINDOWUpcoming BTC or crypto ETF event within ±48h (macro contagion risk)
CENTRALIZED_AI_OVERHANGMajor centralized AI model release within ±72h (TAO narrative headwind)
INSTITUTIONAL_REBAL13F 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
​
nextRefreshMinutes
integer
default:30