Skip to main content
GET
/
v1
/
agents
/
performance
AI Council Agent Accuracy
curl --request GET \
  --url https://api.aioka.io/v1/agents/performance \
  --header 'X-API-Key: <api-key>'
{
  "agents": [
    {
      "accuracy_pct": 77.8,
      "agent_name": "CHAIN ORACLE",
      "correct_calls": 14,
      "last_updated": "2026-05-20T14:32:00Z",
      "total_calls": 18
    },
    {
      "accuracy_pct": 64.7,
      "agent_name": "TECH HAWK",
      "correct_calls": 11,
      "last_updated": "2026-05-20T14:32:00Z",
      "total_calls": 17
    }
  ],
  "asset": "BTC",
  "cache_ttl_seconds": 3600,
  "cached": true,
  "trades_analyzed": 18
}
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 historical accuracy of each AI Council agent. For every closed BTC Ghost Trader trade, AIOKA locates the council verdict that triggered it and checks which agents voted in the direction that actually paid off. The result is each agent’s hit rate across all graded trades. Asset: BTC only — the only asset with a live closed-trade record. Tier: Free ✅ Cache TTL: 3600 seconds (1 hour)

​
How accuracy is graded

Each closed trade’s outcome direction is derived from its result and direction:
TradeOutcomeCorrect vote
LONG winprice roseBULLISH
LONG lossprice fellBEARISH
SHORT winprice fellBEARISH
SHORT lossprice roseBULLISH
Only directional votes (BULLISH / BEARISH) are graded. NEUTRAL votes and non-directional rulings (e.g. RISK SHIELD’s PROCEED / REDUCE / WAIT / AVOID) carry no directional claim, so they are excluded from the denominator rather than counted as wrong. An agent with no directional history is omitted from the response.

​
Response Fields

FieldTypeDescription
assetstringAlways "BTC".
trades_analyzednumberCount of closed BTC trades matched to a council verdict.
agentsarrayPer-agent accuracy entries (see below). May be empty.
agents[].agent_namestringDisplay name, e.g. "CHAIN ORACLE".
agents[].correct_callsnumberDirectional votes that matched the outcome.
agents[].total_callsnumberDirectional votes graded for this agent.
agents[].accuracy_pctnumbercorrect_calls / total_calls × 100, 1 decimal.
agents[].last_updatedstring | nullISO timestamp of the most recent graded trade.
cachedbooleanWhether this response was served from cache.
cache_ttl_secondsnumberCache lifetime in seconds (3600).
Accuracy is computed only from BTC trades because BTC is the only asset with a validated, closed-trade record. Other asset councils (ETH, SOL, etc.) do not yet expose accuracy stats.

Authorizations

​
X-API-Key
string
header
required

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

Response

Per-agent accuracy stats

/v1/agents/performance — per-agent accuracy across closed BTC trades.

​
asset
string
required
​
trades_analyzed
integer
required
​
agents
AgentPerformanceItem · object[]
required
​
cached
boolean
required
​
cache_ttl_seconds
integer
required