1
Create an API key
Sign in at prometheus.services (the Free plan needs no
card), open prometheus.services/developers, and create a key. It is shown once — store
it immediately.
2
Make a request
Send the key as
X-API-KEY on every call:3
Pull real data
Standardized quarterly financials — every statement, every line, up to 200 periods in one call:And the exact XBRL fact and filing behind one cell (the line key is
std:revenue, the
column is its period end):Identifiers
{id} accepts three forms:
Resolve names with
GET /api/v1/search?q=almarai, or browse a market with
GET /api/v1/companies?country=SA. Details and the full market list are on the
Coverage page.
Watch the headers
Every response tells you where you stand:Where next
- Financial statements — the payload shape, period columns, bases and vintages.
- Data catalog — every dataset with its endpoint,
promcommand and MCP tool. - Guide: trace a number to its filing — the citation loop, end to end.