curl https://api.aioka.io/v1/verdict/latest \
  -H "X-API-Key: aik_free_your_key_here"

import httpx

resp = httpx.get(
    "https://api.aioka.io/v1/verdict/latest",
    headers={"X-API-Key": "aik_free_your_key_here"},
)
data = resp.json()
print(data["ruling"], data["confidence"])

# Access individual agent votes
if data.get("agents"):
    for agent in data["agents"]:
        print(f"  {agent['name']}: {agent['vote']} ({agent['confidence']:.0%})")

{
  "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
}

{
  "detail": {
    "error": "missing_api_key",
    "message": "Provide your API key in the X-API-Key header."
  }
}

{
  "detail": {
    "error": "daily_limit_exceeded",
    "message": "Daily limit of 100 calls reached for free tier.",
    "calls_today": 100,
    "limit": 100,
    "reset_at": "2026-04-04T00:00:00Z",
    "upgrade_url": "https://aioka.io/pricing"
  }
}