Skip to main content
GET
/
v1
/
verdict
/
latest
curl https://api.aioka.io/v1/verdict/latest \
  -H "X-API-Key: aik_free_your_key_here"
{
  "ruling": "ACCUMULATE",
  "confidence": 0.782,
  "score": 0.438,
  "btc_price": 67124.0,
  "timestamp": "2026-04-03T10:22:00Z",
  "council_ruling": "BUY",
  "council_confidence": 0.72,
  "council_consensus": "MODERATE",
  "council_explanation": "The council leaned bullish because on-chain demand is strengthening while broader market conditions stay supportive. Short-term momentum is soft, so the stance is a measured buy rather than aggressive.",
  "agents": [
    {"name": "CHAIN ORACLE", "vote": "BUY", "confidence": 0.81, "reasoning": "Exchange net flows turned sharply negative as long-term holders accumulate. SOPR above 1 confirms profitable holders are not capitulating."},
    {"name": "MACRO SAGE", "vote": "ACCUMULATE", "confidence": 0.65, "reasoning": "A weakening dollar and easing real yields create a supportive backdrop for risk assets and hard-money narratives."},
    {"name": "SENTIMENT MONK", "vote": "BUY", "confidence": 0.74, "reasoning": "Fear & Greed sits in neutral territory, leaving room for upside without the froth that precedes local tops."},
    {"name": "TECH HAWK", "vote": "HOLD", "confidence": 0.58, "reasoning": "Price is consolidating around the 200 EMA with RSI near 50, an indecisive posture that warrants patience."},
    {"name": "LIQUIDITY GUARDIAN", "vote": "BUY", "confidence": 0.77, "reasoning": "Order book depth is balanced and stablecoin reserves on exchanges are rising, signalling dry powder ready to deploy."},
    {"name": "RISK SHIELD", "vote": "ACCUMULATE", "confidence": 0.69, "reasoning": "No major macro event is imminent and volatility is contained, so a measured scale-in is acceptable."}
  ],
  "council_mode": "council",
  "macro_context": {
    "assessment": "BULLISH",
    "key_driver": "Dollar weakening + Nasdaq ATH",
    "primary_risk": "DXY reversal could create headwind"
  },
  "cached": true,
  "cache_ttl_seconds": 45
}

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.

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 seconds

Ruling Values

RulingMeaningAction
STRONG_BUYHigh-conviction bullishStrong entry signal
BUYModerate bullishConsider entry
ACCUMULATECautiously bullishScale in gradually
HOLDNeutralWait for confirmation
REDUCECautiously bearishReduce exposure
SELLModerate bearishExit positions
STRONG_SELLHigh-conviction bearishEmergency exit

Council Fields

The response includes optional AI Council data when available:
FieldTypeDescription
council_rulingstring | nullChief Judge’s ruling (same scale as ruling)
council_confidencenumber | nullChief Judge’s confidence (0.0–1.0)
council_consensusstring | nullConsensus level (e.g. "STRONG", "MODERATE", "SPLIT")
council_explanationstring | nullPlain-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_modestring | nullOperating mode: "council" (full AI Council active) or "judiciary" (fallback — Anthropic API unavailable). null if no council data exists yet.
agentsarray | nullIndividual agent votes (see below)
macro_contextobject | nullMacro 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 the agents array:
FieldTypeDescription
namestringAgent display name (e.g. "CHAIN ORACLE", "MACRO SAGE")
votestringAgent’s ruling (same scale as ruling)
confidencenumberAgent’s confidence (0.0–1.0)
reasoningstring | nullThe agent’s own 2-3 sentence rationale for its vote. null on historical verdicts persisted before per-agent reasoning was exposed.
6 Agents: CHAIN ORACLE, MACRO SAGE, SENTIMENT MONK, TECH HAWK, LIQUIDITY GUARDIAN, RISK SHIELD
curl https://api.aioka.io/v1/verdict/latest \
  -H "X-API-Key: aik_free_your_key_here"
{
  "ruling": "ACCUMULATE",
  "confidence": 0.782,
  "score": 0.438,
  "btc_price": 67124.0,
  "timestamp": "2026-04-03T10:22:00Z",
  "council_ruling": "BUY",
  "council_confidence": 0.72,
  "council_consensus": "MODERATE",
  "council_explanation": "The council leaned bullish because on-chain demand is strengthening while broader market conditions stay supportive. Short-term momentum is soft, so the stance is a measured buy rather than aggressive.",
  "agents": [
    {"name": "CHAIN ORACLE", "vote": "BUY", "confidence": 0.81, "reasoning": "Exchange net flows turned sharply negative as long-term holders accumulate. SOPR above 1 confirms profitable holders are not capitulating."},
    {"name": "MACRO SAGE", "vote": "ACCUMULATE", "confidence": 0.65, "reasoning": "A weakening dollar and easing real yields create a supportive backdrop for risk assets and hard-money narratives."},
    {"name": "SENTIMENT MONK", "vote": "BUY", "confidence": 0.74, "reasoning": "Fear & Greed sits in neutral territory, leaving room for upside without the froth that precedes local tops."},
    {"name": "TECH HAWK", "vote": "HOLD", "confidence": 0.58, "reasoning": "Price is consolidating around the 200 EMA with RSI near 50, an indecisive posture that warrants patience."},
    {"name": "LIQUIDITY GUARDIAN", "vote": "BUY", "confidence": 0.77, "reasoning": "Order book depth is balanced and stablecoin reserves on exchanges are rising, signalling dry powder ready to deploy."},
    {"name": "RISK SHIELD", "vote": "ACCUMULATE", "confidence": 0.69, "reasoning": "No major macro event is imminent and volatility is contained, so a measured scale-in is acceptable."}
  ],
  "council_mode": "council",
  "macro_context": {
    "assessment": "BULLISH",
    "key_driver": "Dollar weakening + Nasdaq ATH",
    "primary_risk": "DXY reversal could create headwind"
  },
  "cached": true,
  "cache_ttl_seconds": 45
}

Authorizations

X-API-Key
string
header
required

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

Response

Latest verdict

ruling
string
required
confidence
number
required
score
number
required
btc_price
number | null
required
timestamp
string<date-time>
required
cached
boolean
required
cache_ttl_seconds
integer
required
council_ruling
string | null
council_confidence
number | null
council_consensus
string | null
council_explanation
string | null
agents
AgentVerdictItem · object[] | null
council_mode
string | null
macro_context
MacroContextItem · object

Lightweight macro environment context embedded in verdict response — Sprint 201.