Skip to main content
GET
/
v1
/
signals
/
latest
curl https://api.aioka.io/v1/signals/latest \
  -H "X-API-Key: aik_basic_your_key_here"

{
  "signals": [
    {
      "key": "BTC_RSI",
      "display_name": "BTC RSI (14)",
      "value": 42.3,
      "status": "LIVE",
      "last_updated": "2026-04-03T10:20:00Z"
    },
    {
      "key": "FEAR_GREED_INDEX",
      "display_name": "Fear & Greed Index",
      "value": 38.0,
      "status": "LIVE",
      "last_updated": "2026-04-03T10:00:00Z"
    }
  ],
  "total_signals": 27,
  "live_count": 24,
  "stale_count": 2,
  "dead_count": 1,
  "coverage_pct": 88.9,
  "macro_calendar": {
    "tier": "NONE",
    "event_name": "Core CPI m/m",
    "hours_until": 19.4,
    "is_active": false,
    "status": "CLEAR"
  },
  "timestamp": "2026-04-03T10:22:00Z",
  "cached": false,
  "cache_ttl_seconds": 30
}

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. Requires BASIC tier key ($49/mo). Contact info@aioka.io to upgrade.
Tier: Basic ($49/mo) 🔒 Cache TTL: 30 seconds

​
Signal Categories

  • On-chain: SOPR, MVRV Z-Score, NUPL, Hash Ribbon, Exchange Flow
  • Macro: US10Y, DXY, Gold, BTC-NASDAQ Correlation
  • Options: Put/Call Ratio, DVOL, Options OI
  • Liquidity: Stablecoin Mint, Whale Flow, Entity Pressure
  • Liquidation: Directional Bias, Cascade Risk, Proximity Alert

​
Macro Calendar

The macro_calendar object reports the current ForexFactory economic-calendar status — FOMC, Non-Farm Payrolls, and CPI awareness shared across all AIOKA councils.
FieldDescription
tierNONE / TIER1 / TIER2 / TIER3 — tier of the active or next event
event_nameName of the active or next high-impact event (null if none)
hours_untilHours until that event (0.0 when an event is active now)
is_activetrue when a high-impact event is happening now
statusCLEAR / WATCH / WARNING / BLACKOUT — UI-ready summary
A BLACKOUT status (TIER-1 event) means every council is paused for the day. 
curl https://api.aioka.io/v1/signals/latest \
  -H "X-API-Key: aik_basic_your_key_here"

{
  "signals": [
    {
      "key": "BTC_RSI",
      "display_name": "BTC RSI (14)",
      "value": 42.3,
      "status": "LIVE",
      "last_updated": "2026-04-03T10:20:00Z"
    },
    {
      "key": "FEAR_GREED_INDEX",
      "display_name": "Fear & Greed Index",
      "value": 38.0,
      "status": "LIVE",
      "last_updated": "2026-04-03T10:00:00Z"
    }
  ],
  "total_signals": 27,
  "live_count": 24,
  "stale_count": 2,
  "dead_count": 1,
  "coverage_pct": 88.9,
  "macro_calendar": {
    "tier": "NONE",
    "event_name": "Core CPI m/m",
    "hours_until": 19.4,
    "is_active": false,
    "status": "CLEAR"
  },
  "timestamp": "2026-04-03T10:22:00Z",
  "cached": false,
  "cache_ttl_seconds": 30
}

Authorizations

​
X-API-Key
string
header
required

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

Response

Signal snapshot

​
signals
SignalItem · object[]
required
​
total_signals
integer
required
​
live_count
integer
required
​
stale_count
integer
required
​
dead_count
integer
required
​
coverage_pct
number
required
​
timestamp
string<date-time>
required
​
cached
boolean
required
​
cache_ttl_seconds
integer
required
​
macro_calendar
MacroCalendarStatus · object

Sprint 343 — current macro economic calendar status.

Surfaced on GET /v1/signals/latest so SSR consumers (the aioka.io live page) can render a FOMC/NFP/CPI awareness indicator without parsing the raw MACRO_CAL_* signals. Backed by the Sprint 341 MacroCalendarProvider.