# MLQ Financial Data API

> Agent-native, provenance-first SEC & US-markets data. Every value names the
> exact SEC filing it came from (accession + URL). Point-in-time (`as_of`)
> built in — no look-ahead bias. Statements use standard camelCase field names.

Base URL: https://mlq.ai/api/v1
Auth: `Authorization: Bearer <key>` or `X-API-Key: <key>` — get a key at https://mlq.ai/api/ (free tier: 100 req/day).
MCP (recommended for agents): https://mlq.ai/mcp — streamable HTTP; send the same Authorization header. Install page: https://mlq.ai/api/mcp/
Envelope: list endpoints return {count (total), returned, offset, results}; statement endpoints return bare arrays.
Accuracy & methodology: https://mlq.ai/api/accuracy/ · https://mlq.ai/api/methodology/

## Endpoints

### GET /companies/
Search the tracked universe by ticker or name.
Params: q, limit, offset

### GET /companies/{ticker}/income-statement/
Income statement, standard camelCase field names, newest first. Each period carries a `source` block.
Params: ticker*, period, limit, as_of

### GET /companies/{ticker}/balance-sheet/
Balance sheet, standard camelCase field names. Each period carries a `source` block.
Params: ticker*, period, limit, as_of

### GET /companies/{ticker}/cash-flow/
Cash flow, standard camelCase field names (capex negative). Each period carries a `source` block.
Params: ticker*, period, limit, as_of

### GET /companies/{ticker}/metrics/
Margins, returns, liquidity, leverage, per-share — computed from the same point-in-time facts.
Params: ticker*, period, as_of, fiscal_year

### GET /companies/{ticker}/facts/
Every normalized concept for a company — provenance on each value.
Params: ticker*, period, as_of

### GET /companies/{ticker}/filings/
A company's SEC filing index with deep links.
Params: ticker*, form, limit, offset

### GET /companies/{ticker}/insider-trades/
Form 4 insider buys/sells for a company, newest first. Each row carries a `source` block.
Params: ticker*, limit, offset

### GET /companies/{ticker}/institutional-ownership/
Funds holding this ticker as of the latest 13F period, one row per fund (multi-manager rows summed), largest first. Equity rows only by default — `include_options=true` adds put/call/note rows, labeled via `putCall`/`sharesType` (option-underlying shares and note principal are never mixed into equity share counts).
Params: ticker*, limit, include_options, offset

### GET /funds/{cik}/holdings/
A 13F filer's portfolio as of its latest filing, one row per security (multi-manager rows summed), largest position first. Equity, puts, calls, and notes are separate rows labeled via `putCall`/`sharesType`.
Params: cik*, limit, offset

### GET /feed/
The EDGAR firehose, materiality-scored. Filter by tier/category/form/ticker/min_score/since; tracked=true limits to companies in our universe.
Params: tier, category, form, ticker, tracked, min_score, since, sort, limit, offset

### GET /congress-trades/
Every disclosed buy/sell by a member of Congress (STOCK Act), newest first, with the source filing. Filter by ticker / member / chamber / type / state / since.
Params: ticker, member, chamber, type, state, owner, since, limit, offset

### GET /interconnection-queue/
Generation / storage / large-load interconnection requests across the 7 US ISOs, largest capacity first. Each row carries its source.
Params: iso, state, fuel, status, load_type, operator, data_center, min_mw, limit, offset

### GET /interconnection-queue/changes/
Status / capacity / timeline / fuel transitions in the queue, newest first — the 'what changed' stream.
Params: iso, change, since, limit, offset

### GET /operating-generators/
The as-built US generator fleet (EIA-860, every plant >= 1 MW), largest capacity first. Defaults to operating; pass status= or all=1 for the full lifecycle. The operating counterpart to the interconnection queue (planned).
Params: state, fuel, status, utility, operator, ba, near_dc, min_mw, all, limit, offset

### GET /permits/
Data-center construction + air permits across 150+ US jurisdictions, newest first.
Params: state, county, jurisdiction, operator, category, status, since, q, limit, offset