ETH Council Verdict

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
}

GET

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

Field	Type	Meaning
`verdict`	object \| null	Latest ETH council verdict. `null` if no verdict has been produced yet (first 30 minutes after deploy).
`nextRefreshMinutes`	int	Minutes until the next scheduled council auto-refresh. Always `30`.

verdict fields

Field	Type	Meaning
`id`	string	UUID of this verdict record
`ruling`	string	`STRONG_BUY` / `BUY` / `ACCUMULATE` / `HOLD` / `REDUCE` / `AVOID`
`confidence`	number	0.0 — 1.0. ETH entry threshold is confidence >= 0.65.
`agentVotes`	object	Per-agent breakdown from all 6 ETH specialist agents
`agentVotes.<AGENT>`	object	Each agent entry has `ruling` (string) and `confidence` (number)
`chiefRationale`	string \| null	Chief Judge’s plain-language explanation of the ruling and why agent disagreements were resolved as they were
`plainExplanation`	string \| null	Plain-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.
`snapshotSignals`	object	Raw signal readings at the time of council deliberation (key-value pairs)
`createdAt`	string	ISO 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.

Agent	Weight	Veto	Domain
`VALIDATOR_ORACLE`	0.20	No	PoS network health, staking APY, ETH/BTC ratio
`MACRO_SAGE`	0.15	No	DXY, US10Y, BTC dominance, Fear & Greed, ETH ETF flows
`GAS_FEE_ANALYST`	0.20	No	EIP-1559 burn, DeFi TVL, L2 activity proxy
`MOMENTUM_HUNTER`	0.20	No	RSI 1H/4H, MACD, EMA distance, funding rate
`DEFI_LIQUIDITY_WARDEN`	0.10	Yes	DeFi exit risk, funding squeeze, liquidations
`RISK_WARDEN`	0.15	Yes	Tail 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 Agent	Trigger	Effect
`DEFI_LIQUIDITY_WARDEN`	AVOID + confidence > 0.7	Council ruling forced to AVOID
`RISK_WARDEN`	AVOID + confidence > 0.7	Council 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 | null

Show child attributes

nextRefreshMinutes

integer

default:30

Public

Free Tier

Basic Tier ($49/mo)

Webhooks (Basic+)

Pro Tier ($199/mo)

API Keys

Response Fields

Top-level

verdict fields

Specialist Agents

Veto Rules

Authorizations

Response

​Response Fields

​Top-level

​verdict fields

​Specialist Agents

​Veto Rules

Authorizations

Response

Response Fields

Top-level

verdict fields

Specialist Agents

Veto Rules