> ## Documentation Index
> Fetch the complete documentation index at: https://doc.prometheus.services/llms.txt
> Use this file to discover all available pages before exploring further.

# Quickstart

> First request in under a minute.

<Steps>
  <Step title="Create an API key">
    Sign in at [prometheus.services](https://www.prometheus.services) (the Free plan needs no
    card), open [prometheus.services/developers](https://www.prometheus.services/developers), and create a key. It is shown **once** — store
    it immediately.
  </Step>

  <Step title="Make a request">
    Send the key as `X-API-KEY` on every call:

    ```bash theme={null}
    curl "https://www.prometheus.services/api/v1/companies/NVDA" \
      -H "X-API-KEY: pk_live_YOUR_KEY"
    ```
  </Step>

  <Step title="Pull real data">
    Standardized quarterly financials, every line traceable to its filing:

    ```bash theme={null}
    curl "https://www.prometheus.services/api/v1/companies/NVDA/financials?period_type=quarterly" \
      -H "X-API-KEY: pk_live_YOUR_KEY"
    ```

    And the exact XBRL fact behind a number:

    ```bash theme={null}
    curl "https://www.prometheus.services/api/v1/companies/NVDA/fact-source?statement=income_statement&key=revenue&end_date=2025-01-26&period_type=quarterly" \
      -H "X-API-KEY: pk_live_YOUR_KEY"
    ```
  </Step>
</Steps>

## Identifiers

`{id}` accepts a ticker symbol (`NVDA`) or a numeric SEC CIK (`1045810`). The CIK is the
stable choice when a company has changed symbols. Resolve names with
`GET /api/v1/search?q=nvidia`.

## Watch the headers

Every response tells you where you stand:

| Header                                                        | Meaning                              |
| ------------------------------------------------------------- | ------------------------------------ |
| `RateLimit-Limit` / `RateLimit-Remaining` / `RateLimit-Reset` | Per-minute window                    |
| `X-Quota-Limit` / `X-Quota-Remaining` / `X-Quota-Reset`       | Monthly quota (quota-carrying plans) |
| `Retry-After`                                                 | On a 429 — wait this many seconds    |