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.",
    "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
}

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. 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
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.",
    "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