# US Company Financials & Fundamentals API
> Live fundamental financials for US public companies straight from the SEC's official XBRL data — no key, nothing stored. The "what does the balance sheet and income statement say" view of a company: the actual reported revenue, earnings, assets and equity pulled from its SEC filings, distinct from the quote, analyst, insider and SEC-filings (EDGAR) APIs in the catalogue. The financials endpoint returns the latest annual key figures: revenue, gross profit, operating income, net income, total assets, total liabilities, shareholders' equity, cash, diluted EPS and the computed net margin. The concept endpoint returns the multi-year time series for a single metric — revenue history, net-income history and more — so you can chart how a company has grown. The company endpoint resolves a ticker to its SEC company (CIK and legal name). Build stock-screeners, valuation models, fundamentals dashboards and research tools on top of authoritative SEC data. Look up any US public company by its ticker; figures are the latest annual (10-K) values reported to the SEC in USD.

## Authentication
All requests require your oanor API key in the `x-oanor-key` header. Get one at https://www.oanor.com/developer/keys.

```bash
curl -H "x-oanor-key: oanor_live_…" "https://api.oanor.com/financials-api/..."
```

## Pricing
- **Free** (Free) — 12,800 calls/Mo, 3 req/s
- **Starter** ($9/Mo) — 195,000 calls/Mo, 10 req/s
- **Pro** ($25/Mo) — 805,000 calls/Mo, 28 req/s
- **Scale** ($57/Mo) — 2,900,000 calls/Mo, 60 req/s

## Endpoints

### Financials

#### `GET /v1/financials` — Latest annual key financials for a company

**Parameters:**
- `ticker` (query, required, string) — Stock ticker Example: `AAPL`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/financials-api/v1/financials?ticker=AAPL"
```

### Concept

#### `GET /v1/concept` — Multi-year time series for one metric

**Parameters:**
- `ticker` (query, required, string) — Stock ticker Example: `AAPL`
- `metric` (query, optional, string) — revenue, net_income, assets, equity, eps_diluted… (default revenue) Example: `revenue`
- `limit` (query, optional, string) — Years (default 10, max 30) Example: `10`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/financials-api/v1/concept?ticker=AAPL&metric=revenue&limit=10"
```

### Company

#### `GET /v1/company` — Resolve a ticker to its SEC company

**Parameters:**
- `ticker` (query, required, string) — Stock ticker Example: `AAPL`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/financials-api/v1/company?ticker=AAPL"
```

### Meta

#### `GET /v1/meta` — Service metadata

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/financials-api/v1/meta"
```


---
Marketplace page: https://www.oanor.com/api/financials-api
OpenAPI spec: https://www.oanor.com/api/financials-api/openapi.json