Developers
A read-only JSON API for indicators, countries, macro-health and before-consensus signals. Authenticated with an API key; CORS-enabled for browser and server use.
Auth
Create a key on your account page (Pro plan). Pass it on every request as a bearer token or the x-api-key header.
curl https://predictonomy.com/api/v1/signals \ -H "Authorization: Bearer pk_live_your_key_here"
Keys are shown once at creation. Missing/invalid keys return 401. Keep keys server-side.
Limits
Requests are limited per key (default 120 / minute). Every response includes X-RateLimit-Limit, X-RateLimit-Remaining and X-RateLimit-Reset. Over the limit returns 429 with a Retry-After header.
Each key has a tier (Standard / Pro / Enterprise) with its own per-minute limit, and can carry a custom override. Your key's effective limit is shown on your account page.
Need a higher tier or a custom limit? Get in touch.
Spec
The full v1 surface is described by a machine-readable OpenAPI 3.1 document — generate a client, or import it into Postman / Swagger UI. It embeds the response-envelope JSON Schema, so every shape is typed.
Reference
| Method | Path | Auth | Description |
|---|---|---|---|
| GET | /api/v1/indicators | API key | List all live-backed indicators. |
| GET | /api/v1/indicators/{key} | API key | Global history + forecast for one indicator. |
| GET | /api/v1/countries | API key | List countries with headline metrics. |
| GET | /api/v1/countries/{code} | API key | Country profile + macro-pressure score. |
| GET | /api/v1/signals | API key | The before-consensus signal feed. |
| Method | Path | Auth | Description |
|---|---|---|---|
| GET | /api/v1/resolve | Open | Resolve a ticker symbol to its macro subject. |
| GET | /api/v1/resolve/batch | Open | Resolve many ticker symbols in one call. |
| GET | /api/v1/sentiment/{domain}/{id} | Open | Derived macro-sentiment composite. |
| GET | /api/v1/sentiment/{domain}/{id}/history | Open | Derived macro-sentiment trajectory (history). |
| GET | /api/v1/sentiment/{domain}/{id}/survey | Open | Observed survey sentiment (OECD consumer confidence). |
| GET | /api/v1/sentiment/{domain}/{id}/divergence | Open | Soft-vs-hard sentiment divergence. |
| GET | /api/v1/sentiment/countries | Open | Batch macro-sentiment for many countries. |
| GET | /api/v1/screener/sentiment | Open | Rank the covered universe by macro stress. |
| GET | /api/v1/screener/regime | Open | Rank the covered universe by business-cycle phase. |
| GET | /api/v1/regime/country/{iso3} | Open | Macro regime & turning-point detection. |
| GET | /api/v1/regime/countries | Open | Batch macro regime for many countries. |
| GET | /api/v1/brief/country/{iso3} | Open | Country intelligence brief (one call). |
| GET | /api/v1/forecast/country/{iso3} | Open | Forward macro projections for one country. |
| GET | /api/v1/forecast/reliability | Open | Forecast reliability leaderboard (realized track record). |
| GET | /api/v1/correlation/country/{iso3} | Open | Lead-lag correlation between two indicators (one country). |
| GET | /api/v1/correlation/cross | Open | Cross-country lead-lag correlation. |
| GET | /api/v1/nowcast/country/{iso3} | Open | Leading-indicator nowcast of one macro indicator. |
| Method | Path | Auth | Description |
|---|---|---|---|
| GET | /api/v1/markets/latest | Open | Latest markets values (FX). |
| GET | /api/v1/markets/series | Open | Full history for one markets indicator. |
| Method | Path | Auth | Description |
|---|---|---|---|
| GET | /api/v1/data | Open | Bulk multi-series slice: indicators × countries × year range in one call. |
| Method | Path | Auth | Description |
|---|---|---|---|
| GET | /api/v1/schema/envelope | Open | The v1 response envelope JSON Schema. |
| GET | /api/v1/openapi.json | Open | This OpenAPI 3.1 specification. |
Example
GET https://predictonomy.com/api/v1/countries/US
{
"code": "US",
"name": "United States",
"macroPressure": { "score": 38, "level": "watch" },
"indicators": [ { "id": "gdp_growth_real", "latest": 2.8, "latestYear": 2025 } ]
}The API is read-only and rate-limited fairly per key. Data is research and analysis only — not investment advice. Need higher limits or a custom scope? Get in touch.