> ## 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.
# Latest Signals
> Current snapshot of all 27 market signals
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](mailto: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.
| Field | Description |
| ------------- | ----------------------------------------------------------------------- |
| `tier` | `NONE` / `TIER1` / `TIER2` / `TIER3` — tier of the active or next event |
| `event_name` | Name of the active or next high-impact event (`null` if none) |
| `hours_until` | Hours until that event (`0.0` when an event is active now) |
| `is_active` | `true` when a high-impact event is happening now |
| `status` | `CLEAR` / `WATCH` / `WARNING` / `BLACKOUT` — UI-ready summary |
A `BLACKOUT` status (TIER-1 event) means every council is paused for the day.
```bash curl theme={null}
curl https://api.aioka.io/v1/signals/latest \
-H "X-API-Key: aik_basic_your_key_here"
```
```json 200 theme={null}
{
"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
}
```
## OpenAPI
````yaml GET /v1/signals/latest
openapi: 3.1.0
info:
title: AIOKA Intelligence API
description: |
## AI-powered crypto market intelligence
AIOKA Intelligence API provides real-time access to our AI Council verdicts,
market signals, regime detection, and Ghost Trader entry signals.
### Tiers
- **Free**: 100 calls/day — Verdict + Regime
- **Basic** ($49/mo): 1,000 calls/day — + Signals
- **Pro** ($199/mo): 10,000 calls/day — + Council + Ghost
### Authentication
Pass your API key in the `X-API-Key` header:
```
X-API-Key: aik_free_xxxxxxxxxxxx
```
### Get your API key
`POST /v1/keys/generate` (free tier, no credit card)
contact:
name: AIOKA Support
url: https://docs.aioka.io/
email: api@aioka.io
license:
name: Commercial
url: https://aioka.io/terms
version: 1.0.0
servers:
- url: https://api.aioka.io
description: Production — AIOKA Intelligence API
security: []
paths:
/v1/signals/latest:
get:
tags:
- Signals
summary: Latest Signal Snapshot
description: |-
Returns the current snapshot of all 27 market signals.
AIOKA aggregates on-chain, macro, options, and liquidity data from
multiple providers into a unified signal feed.
**Tier:** Basic ($49/mo) 🔒
**Cache TTL:** 30 seconds
**Rate limit:** 1,000 calls/day, 30/minute
### Signal categories
- **On-chain**: SOPR, MVRV Z-Score, NUPL, Hash Ribbon, Exchange Flow
- **Macro**: US10Y, DXY, Gold, BTC-NASDAQ Correlation
- **Options**: Deribit Put/Call, DVOL, Options OI
- **Liquidity**: Stablecoin Mint, Whale Flow, Entity Pressure
- **Liquidation**: Directional Bias, Cascade Risk, Proximity Alert
operationId: get_signals_latest_v1_signals_latest_get
responses:
'200':
description: Signal snapshot
content:
application/json:
schema:
$ref: '#/components/schemas/SignalsLatestResponse'
'401':
description: Invalid or missing API key
'403':
description: Basic tier required
'429':
description: Rate limit exceeded
security:
- APIKeyHeader: []
components:
schemas:
SignalsLatestResponse:
properties:
signals:
items:
$ref: '#/components/schemas/SignalItem'
type: array
title: Signals
total_signals:
type: integer
title: Total Signals
live_count:
type: integer
title: Live Count
stale_count:
type: integer
title: Stale Count
dead_count:
type: integer
title: Dead Count
coverage_pct:
type: number
title: Coverage Pct
macro_calendar:
$ref: '#/components/schemas/MacroCalendarStatus'
timestamp:
type: string
format: date-time
title: Timestamp
cached:
type: boolean
title: Cached
cache_ttl_seconds:
type: integer
title: Cache Ttl Seconds
type: object
required:
- signals
- total_signals
- live_count
- stale_count
- dead_count
- coverage_pct
- timestamp
- cached
- cache_ttl_seconds
title: SignalsLatestResponse
SignalItem:
properties:
key:
type: string
title: Key
display_name:
type: string
title: Display Name
value:
anyOf:
- type: number
- type: 'null'
title: Value
status:
type: string
title: Status
last_updated:
anyOf:
- type: string
format: date-time
- type: 'null'
title: Last Updated
type: object
required:
- key
- display_name
- value
- status
- last_updated
title: SignalItem
MacroCalendarStatus:
properties:
tier:
type: string
title: Tier
default: NONE
event_name:
anyOf:
- type: string
- type: 'null'
title: Event Name
hours_until:
type: number
title: Hours Until
default: 0
is_active:
type: boolean
title: Is Active
default: false
status:
type: string
title: Status
default: CLEAR
type: object
title: MacroCalendarStatus
description: >-
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.
securitySchemes:
APIKeyHeader:
type: apiKey
description: 'Your AIOKA Intelligence API key (format: aik_{tier}_{random})'
in: header
name: X-API-Key
````