Free Tier
Latest Verdict
Returns the most recent AI Council verdict with individual agent votes
GET
To use the playground, enter your API key in the X-API-Key field above.
Don’t have a key? Get one free →
Overview
Returns the most recent ruling from AIOKA’s Judiciary Engine alongside the AI Council verdict. 6 specialized agents analyze 27 live market signals and vote on BTC market conditions. The Chief Judge synthesizes all votes into a final ruling. Individual agent votes are included in the response. Tier: Free ✅ Cache TTL: 60 secondsRuling Values
| Ruling | Meaning | Action |
|---|---|---|
STRONG_BUY | High-conviction bullish | Strong entry signal |
BUY | Moderate bullish | Consider entry |
ACCUMULATE | Cautiously bullish | Scale in gradually |
HOLD | Neutral | Wait for confirmation |
REDUCE | Cautiously bearish | Reduce exposure |
SELL | Moderate bearish | Exit positions |
STRONG_SELL | High-conviction bearish | Emergency exit |
Council Fields
The response includes optional AI Council data when available:| Field | Type | Description |
|---|---|---|
council_ruling | string | null | Chief Judge’s ruling (same scale as ruling) |
council_confidence | number | null | Chief Judge’s confidence (0.0–1.0) |
council_consensus | string | null | Consensus level (e.g. "STRONG", "MODERATE", "SPLIT") |
council_explanation | string | null | Plain-English, jargon-free 2-3 sentence summary of WHY the council reached its ruling, synthesized by the Chief Judge. null if no recent council verdict exists. |
council_mode | string | null | Operating mode: "council" (full AI Council active) or "judiciary" (fallback — Anthropic API unavailable). null if no council data exists yet. |
agents | array | null | Individual agent votes (see below) |
macro_context | object | null | Macro environment context (Sprint 201). Present for all tiers. |
council_mode explained: When the Anthropic API is unavailable, AIOKA’s AI Council
automatically falls back to the Judiciary Engine alone. council_mode: "judiciary" means
the verdict was produced with reduced AI consensus (~47% confidence baseline). Normal operation
resumes automatically when the Anthropic API recovers. The council_mode field reflects
the state at the time the response was generated, inferred from council verdict freshness.macro_context is available to all tiers including Free.
For the full cross-asset breakdown with all 5 signals,
use GET /v1/macro/correlation
(Basic tier required).Agent Vote Object
Each item in theagents array:
| Field | Type | Description |
|---|---|---|
name | string | Agent display name (e.g. "CHAIN ORACLE", "MACRO SAGE") |
vote | string | Agent’s ruling (same scale as ruling) |
confidence | number | Agent’s confidence (0.0–1.0) |
reasoning | string | null | The agent’s own 2-3 sentence rationale for its vote. null on historical verdicts persisted before per-agent reasoning was exposed. |
Authorizations
Your AIOKA Intelligence API key (format: aik_{tier}_{random})
Response
Latest verdict
Lightweight macro environment context embedded in verdict response — Sprint 201.