All endpoints are `GET` requests under `https://api.equibles.com/v1` and mirror an [MCP tool](/docs/mcp/tools). See the [API guide](/docs/api) for auth, pagination, and the response envelope. Prefer to try them live? The [interactive Swagger docs](https://api.equibles.com/docs) document every parameter and response schema.

Each family page below lists its endpoints with their parameters and a **worked example** — a `curl` / Python / JavaScript request and the real JSON response (mostly for NVIDIA, ticker `NVDA`).

## Endpoint families

- [Prices](/docs/api/endpoints/prices) — daily OHLCV and the latest close/volume for many tickers.
- [Filings & documents](/docs/api/endpoints/filings) — list, search, and read filings and transcripts; fails-to-deliver; Form D.
- [Institutional holdings (13F)](/docs/api/endpoints/holdings) — holders, ownership, activity, leaderboards, and institution portfolios.
- [Funds & advisers](/docs/api/endpoints/funds) — fund holdings and operations, funds holding a stock, and Form ADV advisers.
- [Insider trading](/docs/api/endpoints/insider) — transactions, ownership, Form 144 proposed sales, and insider search.
- [Congressional trading](/docs/api/endpoints/congress) — trades, member search, net-worth, and market-wide aggregates.
- [Short data](/docs/api/endpoints/short) — short volume, short interest, off-exchange volume, and squeeze scores.
- [Government contracts](/docs/api/endpoints/government-contracts) — awards won by a company and the top contractors.
- [FDA catalysts](/docs/api/endpoints/fda) — scheduled FDA advisory-committee meetings.
- [Economic data (FRED)](/docs/api/endpoints/economic) — series search, observations, latest values, and the release calendar.
- [Futures positioning (CFTC)](/docs/api/endpoints/futures) — contract search, weekly COT positioning, and the latest snapshot.
- [Market sentiment (CBOE)](/docs/api/endpoints/sentiment) — put/call ratios and VIX.
- [Market status & calendar](/docs/api/endpoints/market) — whether the market is open now, and the holiday calendar.

## Conventions

- **Auth** — every request needs your API key as a `Bearer` token (or `?api_key=`). See [Authentication](/docs/authentication).
- **Paging** — list endpoints take `limit` and `offset` and wrap rows in `{ data, meta }`; `meta.hasMore` signals another page. Max `limit` is 500.
- **Wire format** — JSON with **camelCase** fields; dates are `YYYY-MM-DD`; ratios come over the wire as **fractions** (`0.112` = 11.2%).
- **Errors & limits** — non-2xx returns `{ "error": { "code", "message", "status" } }`; requests count against a daily limit shared with MCP. See [Rate limits & errors](/docs/rate-limits).