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 — requires an API key (free tier: 100 calls/day; standard and above: no daily quota). 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 | API key | Resolve a ticker symbol to its macro subject. |
| GET | /api/v1/resolve/batch | API key | Resolve many ticker symbols in one call. |
| GET | /api/v1/sentiment/{domain}/{id} | API key | Derived macro-sentiment composite. |
| GET | /api/v1/sentiment/{domain}/{id}/history | API key | Derived macro-sentiment trajectory (history). |
| GET | /api/v1/sentiment/{domain}/{id}/survey | API key | Observed survey sentiment (OECD consumer confidence). |
| GET | /api/v1/sentiment/{domain}/{id}/divergence | API key | Soft-vs-hard sentiment divergence. |
| GET | /api/v1/sentiment/countries | API key | Batch macro-sentiment for many countries. |
| GET | /api/v1/trading/regime | API key | Risk-on/risk-off trading-regime gauge for many countries, instruments, or FX pairs. |
| GET | /api/v1/trading/regime/history | API key | Monthly trading-regime history for one country. |
| GET | /api/v1/trading/regime/changes | API key | Trading-regime stance-change feed across every covered country. |
| GET | /api/v1/policy/path | API key | Policy-rate path per central bank (last change, next decision, recent history). |
| GET | /api/v1/calendar | API key | Release calendar — upcoming/recent tier-1/2 macro release instants, for widening or narrowing risk around them. |
| GET | /api/v1/sectors/sensitivity | API key | Curated sector-to-macro-driver sensitivity map. |
| GET | /api/v1/screener/sentiment | API key | Rank the covered universe by macro stress. |
| GET | /api/v1/screener/regime | API key | Rank the covered universe by business-cycle phase. |
| GET | /api/v1/regime/country/{iso3} | API key | Macro regime & turning-point detection. |
| GET | /api/v1/regime/countries | API key | Batch macro regime for many countries. |
| GET | /api/v1/brief/country/{iso3} | API key | Country intelligence brief (one call). |
| GET | /api/v1/forecast/country/{iso3} | API key | Forward macro projections for one country. |
| GET | /api/v1/forecast/reliability | API key | Forecast reliability leaderboard (realized track record). |
| GET | /api/v1/correlation/country/{iso3} | API key | Lead-lag correlation between two indicators (one country). |
| GET | /api/v1/correlation/cross | API key | Cross-country lead-lag correlation. |
| GET | /api/v1/nowcast/country/{iso3} | API key | Leading-indicator nowcast of one macro indicator. |
| Method | Path | Auth | Description |
|---|---|---|---|
| GET | /api/v1/markets/latest | API key | Latest markets values (FX). |
| GET | /api/v1/markets/series | API key | Full history for one markets indicator. |
| Method | Path | Auth | Description |
|---|---|---|---|
| GET | /api/v1/data | API key | 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.