Developers
EveryIntel API
A versioned REST API over the same records that power this site. Summary endpoints are open; history and raw observations require an API key.
| Method | Path | Description |
|---|---|---|
| GET | /api/v1/status | Service and data freshness status. Public. |
| GET | /api/v1/markets/cot | Latest positioning summary for all tracked futures markets. Public. |
| GET | /api/v1/markets/cot/{slug} | Latest 12 weeks for one market (public). Full history with a key holding scope cot:history. |
| GET | /api/v1/macro | Latest value for each tracked BLS series. Public. |
| GET | /api/v1/macro/{slug} | Series history including revision records. Requires scope macro:history. |
| GET | /api/v1/research | Published findings. Public. |
| GET | /api/v1/sources | Source catalog with licences and rights classification. Public. |
| GET | /api/v1/observations?series={key} | Raw observations with full provenance and all revisions. Requires scope observations:read. |
| GET | /api/v1/series?country={ISO2}®ion={key}¤cy={ISO4217} | Series catalogue with latest values, filtered by geography. Public (redistributable data only). |
| GET | /api/v1/sectors | Sectors with measured coverage status and live counts. Public. |
| GET | /api/v1/fx/ecb?currency={ISO4217} | Latest euro reference exchange rates (ECB). Public. |
| GET | /api/v1/reference/countries?region={key} | Countries (ISO 3166-1) with UN M49 region, ISO 4217 currency, IANA time zones and coverage. Public. |
| GET | /api/v1/reference/currencies | ISO 4217 currencies with minor units. Public. |
| GET | /api/v1/reference/venues?country={ISO2} | Trading venues (ISO 10383 MIC) with city, time zone and currencies. Public. |
Authentication
Send your key in the Authorization header: Authorization: Bearer ei_live_…. Keys are issued per organisation, scoped, and can be rotated or revoked at any time. EveryIntel stores only a hash of each key; a lost key cannot be recovered, only replaced.
Rate limits
Anonymous requests: 60 per minute per IP address. Keyed requests: the limit set on the key (default 60 per minute). Responses include X-RateLimit-Limit and X-RateLimit-Remaining; exceeding the limit returns 429 with Retry-After.
Response and error format
Successful responses return { "data": …, "meta": { … } }. Errors return:
{ "error": { "code": "rate_limited", "message": "Too many requests", "request_id": "…" } }Provenance fields
Observation responses include source_ref, observed_at, collector_version, verification_status, confidence, data_class, revision_number and supersedes_id — see the provenance standard. Pass as_of=YYYY-MM-DDTHH:MM:SSZ to reconstruct what EveryIntel knew at that time.
Example
curl https://everyintel.com/api/v1/markets/cot
Access
API keys are currently issued by arrangement. Contact us with your use case.