API v1

LucidAgent API

Access global intelligence data programmatically. 14 endpoints covering world events, markets, conflicts, health, and analytics.

Authentication

Authenticate via header or query parameter:

Authorization: Bearer {api_key}
# or
GET /api/v1/world-pulse?api_key={api_key}

Pro tier: 1,000 requests/day

Suite tier: 10,000 requests/day

View pricing →

Endpoints

GET/api/v1/world-pulsePro

Global risk snapshot for all countries

Params: region, min_risk, limit

GET/api/v1/indicesPro

LucidAgent composite index values (LGSI, LMSI, LCEI, LCPI, LUOI)

Params: history=true

GET/api/v1/anomaliesPro

Statistical anomalies detected across all data streams

Params: severity, active, category, limit

GET/api/v1/eventsPro

Global events feed from GDELT

Params: country, category, limit

GET/api/v1/conflictsPro

Armed conflict events from ACLED

Params: country, min_fatalities, limit

GET/api/v1/marketsPro

Market snapshot — crypto, forex, equities

Params: type (crypto|forex|equity)

GET/api/v1/healthPro

Global health status — outbreaks, disease tracking

Params: outbreak_only, country

GET/api/v1/forecastsPro

Economic forecasts with confidence intervals

Params: series, horizon

GET/api/v1/correlationsPro

Precomputed statistical correlations between indicators

Params: min_r, category, limit

GET/api/v1/rankings/{type}Pro

Global and domestic rankings

Params: limit, offset

GET/api/v1/time-series/{id}Pro

Historical time series for any indicator

Params: from, to, interval

GET/api/v1/company/{id}Suite

Full company intelligence profile with AI brief

GET/api/v1/country/{code}Pro

Full country intelligence with AI brief

GET/api/v1/world-pulse/{code}Pro

Single country detail

Code Examples

curl -H "Authorization: Bearer YOUR_API_KEY" \
  "https://lucidagent.ai/api/v1/world-pulse?region=europe&min_risk=50"

Response Format

All endpoints return a consistent envelope:

{
  "data": [...],
  "meta": {
    "total": 195,
    "api_version": "1.0",
    "last_updated": "2026-04-10T12:00:00Z"
  }
}

Rate Limits

Tier	Price	Requests/Day	Concurrent	Features
Free	$0	0	-	No API access
Pro	$199/mo	1,000/day	5	All endpoints except company detail
Suite	$499/mo	10,000/day	20	All endpoints + webhooks