Skip to main content
GET
/
v1
/
eth
/
council
curl https://api.aioka.io/v1/eth/council \
  -H "X-API-Key: aik_pro_your_key_here"

{
  "verdict": {
    "id": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
    "ruling": "ACCUMULATE",
    "confidence": 0.72,
    "agentVotes": {
      "VALIDATOR_ORACLE": {"ruling": "BUY", "confidence": 0.76},
      "MACRO_SAGE": {"ruling": "ACCUMULATE", "confidence": 0.68},
      "GAS_FEE_ANALYST": {"ruling": "BUY", "confidence": 0.74},
      "MOMENTUM_HUNTER": {"ruling": "BUY", "confidence": 0.79},
      "DEFI_LIQUIDITY_WARDEN": {"ruling": "ACCUMULATE", "confidence": 0.65},
      "RISK_WARDEN": {"ruling": "HOLD", "confidence": 0.58}
    },
    "chiefRationale": "Validator network healthy, gas fees rising, momentum aligned. RISK_WARDEN's HOLD dissent reflects elevated ETH/BTC spread uncertainty. Confidence trimmed to 0.72.",
    "plainExplanation": "The council leaned moderately bullish because Ethereum's network activity and staking health are strengthening while macro conditions stay supportive. Momentum is firm but not extreme, so the stance is a measured accumulate rather than an aggressive buy.",
    "snapshotSignals": {
      "eth_price": 3265.0,
      "rsi_1h": 52.4,
      "ema_200": 3210.5,
      "fear_greed": 58,
      "staking_apy": 3.82
    },
    "createdAt": "2026-05-06T08:30:00+00:00"
  },
  "nextRefreshMinutes": 30
}
Pro tier endpoint — requires a valid Pro API key. The ETH council runs 6 specialist agents tuned to Ethereum-specific intelligence (Sprint ETH Phase 2).
Tier: Pro ($199/mo) Cache: None Rate limit: 30/min (per tier) Read-only: Never writes to any trading table.

​
Response Fields

​
Top-level

FieldTypeMeaning
verdictobject | nullLatest ETH council verdict. null if no verdict has been produced yet (first 30 minutes after deploy).
nextRefreshMinutesintMinutes until the next scheduled council auto-refresh. Always 30.

​
verdict fields

FieldTypeMeaning
idstringUUID of this verdict record
rulingstringSTRONG_BUY / BUY / ACCUMULATE / HOLD / REDUCE / AVOID
confidencenumber0.0 — 1.0. ETH entry threshold is confidence >= 0.65.
agentVotesobjectPer-agent breakdown from all 6 ETH specialist agents
agentVotes.<AGENT>objectEach agent entry has ruling (string) and confidence (number)
chiefRationalestring | nullChief Judge’s plain-language explanation of the ruling and why agent disagreements were resolved as they were
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.
snapshotSignalsobjectRaw signal readings at the time of council deliberation (key-value pairs)
createdAtstringISO 8601 timestamp of verdict

​
Specialist Agents

The ETH council replaces the generic BTC agent personas with 6 specialists calibrated for Ethereum-specific intelligence. Each agent produces an independent ruling and confidence score. The Chief Judge aggregates all 6 votes into the final verdict.
AgentWeightVetoDomain
VALIDATOR_ORACLE0.20NoPoS network health, staking APY, ETH/BTC ratio
MACRO_SAGE0.15NoDXY, US10Y, BTC dominance, Fear & Greed, ETH ETF flows
GAS_FEE_ANALYST0.20NoEIP-1559 burn, DeFi TVL, L2 activity proxy
MOMENTUM_HUNTER0.20NoRSI 1H/4H, MACD, EMA distance, funding rate
DEFI_LIQUIDITY_WARDEN0.10YesDeFi exit risk, funding squeeze, liquidations
RISK_WARDEN0.15YesTail risks, F&G extremes, ETH ETF outflow reversals
The agentVotes object in every verdict response maps each agent name to its individual ruling and confidence. Disagreement between agents is reflected in the final confidence score — unanimous verdicts carry the highest confidence.

​
Veto Rules

DEFI_LIQUIDITY_WARDEN and RISK_WARDEN carry veto power. When either returns AVOID with confidence > 0.7, the council ruling becomes AVOID regardless of what the other four agents vote. Vetoes are enforced deterministically in Python — never trusted to LLM compliance.
Veto AgentTriggerEffect
DEFI_LIQUIDITY_WARDENAVOID + confidence > 0.7Council ruling forced to AVOID
RISK_WARDENAVOID + confidence > 0.7Council ruling forced to AVOID
curl https://api.aioka.io/v1/eth/council \
  -H "X-API-Key: aik_pro_your_key_here"

{
  "verdict": {
    "id": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
    "ruling": "ACCUMULATE",
    "confidence": 0.72,
    "agentVotes": {
      "VALIDATOR_ORACLE": {"ruling": "BUY", "confidence": 0.76},
      "MACRO_SAGE": {"ruling": "ACCUMULATE", "confidence": 0.68},
      "GAS_FEE_ANALYST": {"ruling": "BUY", "confidence": 0.74},
      "MOMENTUM_HUNTER": {"ruling": "BUY", "confidence": 0.79},
      "DEFI_LIQUIDITY_WARDEN": {"ruling": "ACCUMULATE", "confidence": 0.65},
      "RISK_WARDEN": {"ruling": "HOLD", "confidence": 0.58}
    },
    "chiefRationale": "Validator network healthy, gas fees rising, momentum aligned. RISK_WARDEN's HOLD dissent reflects elevated ETH/BTC spread uncertainty. Confidence trimmed to 0.72.",
    "plainExplanation": "The council leaned moderately bullish because Ethereum's network activity and staking health are strengthening while macro conditions stay supportive. Momentum is firm but not extreme, so the stance is a measured accumulate rather than an aggressive buy.",
    "snapshotSignals": {
      "eth_price": 3265.0,
      "rsi_1h": 52.4,
      "ema_200": 3210.5,
      "fear_greed": 58,
      "staking_apy": 3.82
    },
    "createdAt": "2026-05-06T08:30:00+00:00"
  },
  "nextRefreshMinutes": 30
}

Authorizations

​
X-API-Key
string
header
required

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

Response

ETH council verdict

​
verdict
ETHCouncilVerdict · object
​
nextRefreshMinutes
integer
default:30