Skip to main content
POST
/
v1
/
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."
}
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

FieldTypeMeaning
successbooltrue if a verdict was returned. false if no verdict exists yet (first 30 minutes after deploy).
verdictobject | nullThe latest persisted TAO council verdict. Same structure as GET /v1/tao/council.
verdict.idstringUUID
verdict.rulingstringSTRONG_BUY / BUY / ACCUMULATE / HOLD / REDUCE / SELL / STRONG_SELL / AVOID
verdict.confidencenumber0.0 — 1.0
verdict.agentVotesobjectPer-agent breakdown from all 6 TAO specialist agents
verdict.riskFlagsarrayActive risk flags
verdict.chiefRationalestring | nullChief Judge plain-language rationale
verdict.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.
verdict.snapshotSignalsobjectSignal readings at deliberation time
verdict.createdAtstringISO 8601 timestamp
detailstring | nullHuman-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."
}

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
​
detail
string | null