Run TAO Council

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

{
  "success": true,
  "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.",
    "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
    },
    "createdAt": "2026-05-06T08:30:00+00:00"
  },
  "detail": "Latest verdict returned. Out-of-band trigger via /tao_council Telegram command on the internal service."
}

{
  "success": false,
  "verdict": null,
  "detail": "No verdict yet -- TAO council auto-refreshes every 30 minutes. First verdict expected within 2 minutes of deploy."
}

{
  "error": "tao_council_unavailable",
  "message": "TAO council read failed; retry in a moment."
}

POST

tao

council

run

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

{
  "success": true,
  "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.",
    "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
    },
    "createdAt": "2026-05-06T08:30:00+00:00"
  },
  "detail": "Latest verdict returned. Out-of-band trigger via /tao_council Telegram command on the internal service."
}

{
  "success": false,
  "verdict": null,
  "detail": "No verdict yet -- TAO council auto-refreshes every 30 minutes. First verdict expected within 2 minutes of deploy."
}

{
  "error": "tao_council_unavailable",
  "message": "TAO council read failed; retry in a moment."
}

Pro tier endpoint — requires a valid Pro API key. Rate-limited to 5/min per tier (council deliberation is Anthropic API-cost heavy).

Tier: Pro ($199/mo) Rate limit: 5/min Cache: None

How It Works

The TAO council auto-refreshes every 30 minutes via an internal background loop running inside the AIOKA core service. This endpoint allows a manual out-of-band refresh when you need a verdict before the next scheduled run.

Implementation note: Due to A-1 service isolation (the public API cannot import from the internal service), this endpoint returns the latest verdict from the database. The actual Anthropic API call to deliberate is triggered via the internal /tao_council Telegram command or by the 30-minute auto-refresh loop. If no new verdict has been produced in the last 2 minutes, the response reflects the last known verdict with success: true and a detail message explaining the trigger mechanism.

Request

No request body required — POST with your API key is sufficient.

Response Fields

Field	Type	Meaning
`success`	bool	`true` if a verdict was returned. `false` if no verdict exists yet (first 30 minutes after deploy).
`verdict`	object \| null	The latest persisted TAO council verdict. Same structure as `GET /v1/tao/council`.
`verdict.id`	string	UUID
`verdict.ruling`	string	`STRONG_BUY` / `BUY` / `ACCUMULATE` / `HOLD` / `REDUCE` / `SELL` / `STRONG_SELL` / `AVOID`
`verdict.confidence`	number	0.0 — 1.0
`verdict.agentVotes`	object	Per-agent breakdown from all 6 TAO specialist agents
`verdict.riskFlags`	array	Active risk flags
`verdict.chiefRationale`	string \| null	Chief Judge plain-language rationale
`verdict.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.
`verdict.snapshotSignals`	object	Signal readings at deliberation time
`verdict.createdAt`	string	ISO 8601 timestamp
`detail`	string \| null	Human-readable note on trigger status or error context

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

{
  "success": true,
  "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.",
    "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
    },
    "createdAt": "2026-05-06T08:30:00+00:00"
  },
  "detail": "Latest verdict returned. Out-of-band trigger via /tao_council Telegram command on the internal service."
}

{
  "success": false,
  "verdict": null,
  "detail": "No verdict yet -- TAO council auto-refreshes every 30 minutes. First verdict expected within 2 minutes of deploy."
}

{
  "error": "tao_council_unavailable",
  "message": "TAO council read failed; retry in a moment."
}

Authorizations

X-API-Key

string

header

required

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

Response

Council run result

success

boolean

required

verdict

TAOCouncilVerdict · object | null

Show child attributes

detail

string | null

Public

Free Tier

Basic Tier ($49/mo)

Webhooks (Basic+)

Pro Tier ($199/mo)

API Keys

How It Works

Request

Response Fields

Authorizations

Response

​How It Works

​Request

​Response Fields

Authorizations

Response

How It Works

Request

Response Fields