# Prometheus

> Prometheus is an audit-grade financial data terminal. SEC 10-K / 10-Q / 8-K
> filings are parsed from XBRL into standardized statements where every number
> links back to the exact source fact and filing; earnings calls become
> verified observations and guidance scorecards; macro data is stored
> point-in-time (what was known, when); and a validated causal claim graph
> connects companies, themes and macro factors. Nothing here is investment
> advice.

## Using Prometheus

- [Terminal](https://www.prometheus.services/terminal): the product — companies, macro, events, people, intelligence
- [Documentation](https://doc.prometheus.services): guides + interactive API reference (in-app fallback: https://www.prometheus.services/docs)
- [OpenAPI](https://www.prometheus.services/openapi.json): the full HTTP API contract (OpenAPI 3.1)
- [CLI](https://doc.prometheus.services/cli): `npm i -g prometheus-terminal` — every endpoint as a `prom` command, `--json` for verbatim payloads, citations under every number
- [Doomsday Clock](https://www.prometheus.services/doomsday-clock): a public risk dashboard
- [Terms](https://www.prometheus.services/terms) · [Privacy](https://www.prometheus.services/privacy)

## API quick reference

All data endpoints live under https://www.prometheus.services/api/v1 and
return JSON. `id` is a ticker (NVDA) or a numeric SEC CIK.

- GET /api/v1/landing/stats — coverage numbers, no auth
- GET /api/v1/search?q=nvidia — companies, macro series, countries
- GET /api/v1/companies/{id} — profile, latest filing, quote, key metrics
- GET /api/v1/companies/{id}/financials?period_type=quarterly — standardized statements
- GET /api/v1/companies/{id}/fact-source?statement=income_statement&key=revenue&end_date=2025-01-26 — the XBRL fact behind a number
- GET /api/v1/companies/{id}/filings · /events · /transcripts · /ownership · /management
- GET /api/v1/companies/{id}/earnings/promises — guidance commitments extracted from calls
- GET /api/v1/countries/{iso}/series?key=UNRATE — point-in-time macro history
- GET /api/v1/events/wire?q=acquisition&family=mna — 8-K headline wire
- GET /api/v1/intelligence/graph · POST /api/v1/intelligence/simulate — claim graph and scenario propagation

Authentication: `public` endpoints need nothing. Everything else takes an
API key — create one on the Developers page
(https://www.prometheus.services/developers) and send it as
`X-API-KEY: pk_live_...` (or `Authorization: Bearer pk_live_...`).

Plans and limits (fixed UTC windows): Free — 30 req/min, 250 req/day, no card.
Build ($200/mo) — 300 req/min, 100,000 req/month. Scale — custom, contact
sales. Responses carry RateLimit-* and X-Quota-* headers; a 429 carries
`Retry-After` and code rate_limited or quota_exceeded.

## For agents

- In a terminal, prefer the CLI: `prom --json <command>` returns the same payloads with stable exit codes (0 ok · 2 usage · 3 auth · 5 not found · 6 rate limited · 7 server), and `prom transcript` / `prom event` resolve the transcript date and 8-K item for you. `prom llms --skill` prints skill.md.
- [agents.md](https://www.prometheus.services/agents.md): what an agent may do on this site, and the rules
- [skill.md](https://www.prometheus.services/skill.md): a playbook for answering financial questions with Prometheus data, with citations
- [mcp.json](https://www.prometheus.services/.well-known/mcp.json): MCP discovery manifest (server status inside)

## Data provenance

Company financials come from SEC EDGAR XBRL, reconciled against the SEC
companyfacts API and gated by per-company invariant batteries before they are
served. Macro data is FRED/ALFRED with full revision vintages. Transcripts
come from licensed providers. Every served number can be traced to a filing
and fact id through the API.