> ## 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.
# TAO Council Verdict
> Latest TAO AI Council verdict with 6 specialist agent votes, risk flags, chief rationale, and signal snapshot
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.` | 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 |
```bash curl theme={null}
curl https://api.aioka.io/v1/tao/council \
-H "X-API-Key: aik_pro_your_key_here"
```
```json 200 theme={null}
{
"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
}
```
## OpenAPI
````yaml GET /v1/tao/council
openapi: 3.1.0
info:
title: AIOKA Intelligence API
description: |
## AI-powered crypto market intelligence
AIOKA Intelligence API provides real-time access to our AI Council verdicts,
market signals, regime detection, and Ghost Trader entry signals.
### Tiers
- **Free**: 100 calls/day — Verdict + Regime
- **Basic** ($49/mo): 1,000 calls/day — + Signals
- **Pro** ($199/mo): 10,000 calls/day — + Council + Ghost
### Authentication
Pass your API key in the `X-API-Key` header:
```
X-API-Key: aik_free_xxxxxxxxxxxx
```
### Get your API key
`POST /v1/keys/generate` (free tier, no credit card)
contact:
name: AIOKA Support
url: https://docs.aioka.io/
email: api@aioka.io
license:
name: Commercial
url: https://aioka.io/terms
version: 1.0.0
servers:
- url: https://api.aioka.io
description: Production — AIOKA Intelligence API
security: []
paths:
/v1/tao/council:
get:
tags:
- TAO Ghost Trader
summary: Latest TAO Council Verdict
description: |-
Latest TAO Council verdict with full agent breakdown, risk flags,
chief rationale, and signal snapshot at convene time.
**Tier:** Pro
**Cache:** None
**Rate limit:** 30/min (per tier)
operationId: get_tao_council_v1_tao_council_get
responses:
'200':
description: TAO council verdict
content:
application/json:
schema:
$ref: '#/components/schemas/TAOCouncilResponse'
'401':
description: Missing or invalid API key
'403':
description: Tier insufficient
security:
- APIKeyHeader: []
components:
schemas:
TAOCouncilResponse:
properties:
verdict:
anyOf:
- $ref: '#/components/schemas/TAOCouncilVerdict'
- type: 'null'
nextRefreshMinutes:
type: integer
title: Nextrefreshminutes
default: 30
type: object
title: TAOCouncilResponse
TAOCouncilVerdict:
properties:
id:
type: string
title: Id
ruling:
type: string
title: Ruling
confidence:
type: number
title: Confidence
agentVotes:
type: object
title: Agentvotes
riskFlags:
items:
type: string
type: array
title: Riskflags
chiefRationale:
anyOf:
- type: string
- type: 'null'
title: Chiefrationale
snapshotSignals:
type: object
title: Snapshotsignals
createdAt:
type: string
format: date-time
title: Createdat
plainExplanation:
anyOf:
- type: string
- type: 'null'
title: Plainexplanation
type: object
required:
- id
- ruling
- confidence
- createdAt
title: TAOCouncilVerdict
securitySchemes:
APIKeyHeader:
type: apiKey
description: 'Your AIOKA Intelligence API key (format: aik_{tier}_{random})'
in: header
name: X-API-Key
````