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.
Reference
| Method | Path | Description |
|---|---|---|
| GET | /api/v1/indicators | List all live-backed indicators. |
| GET | /api/v1/indicators/{id} | Global history + forecast for one indicator. |
| GET | /api/v1/countries | List countries with headline metrics. |
| GET | /api/v1/countries/{code} | Country profile + macro-pressure score. |
| GET | /api/v1/signals | The before-consensus signal feed. |
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.