# Stock Data API

**Version:** 1.0.0

Real-time and historical stock market data API with Bearer token authentication

**Base URL:** `https://api.prixe.io`

## Authentication

- **traditional**: Bearer token required in Authorization header for /api/* endpoints

## Rate Limiting

Rate limits are enforced both per-user and per-IP address to ensure fair usage

**Tip:** Pass include_limits=true on any /api/ endpoint to see your current usage and plan limits in the response. For POST requests, include it in the JSON body; for GET requests, use it as a query parameter.

## Available Endpoints

| Endpoint | Method | Description | Docs |
|---|---|---|---|
| `/api/price` | POST | Get historical price data for a specified stock ticker and time range. Supports ... | [/mcp/price](/mcp/price) |
| `/api/splits` | POST | Get the stock split calendar for a ticker. Returns every split with its effectiv... | [/mcp/splits](/mcp/splits) |
| `/api/nasdaq/snapshot` | GET | Top-of-book bid/ask, last trade, OHL, 52-week high/low, and reference data (mark... | [/mcp/snapshot](/mcp/snapshot) |
| `/api/nasdaq/quotes` | GET | Top-of-book bid and ask levels (price + size) for a single ticker, sourced from ... | [/mcp/quotes](/mcp/quotes) |
| `/api/nasdaq/tick` | GET | Most recent N trade prints (time, price, volume, side) — per-print trade tape so... | [/mcp/tick](/mcp/tick) |
| `/api/nasdaq/bars` | GET | Historical OHLCV bars for one ticker. **Pro+ Feature**. | [/mcp/bars](/mcp/bars) |
| `/api/nasdaq/batch_bars` | POST | Historical OHLCV bars for multiple tickers in one call. Same fields as /api/nasd... | [/mcp/batch_bars](/mcp/batch_bars) |
| `/api/crypto` | POST | Crypto market data for one or more pairs. Single endpoint with a `type` field th... | [/mcp/crypto_post](/mcp/crypto_post) |
| `/api/crypto/list` | GET | List every crypto pair supported by `/api/crypto`. Returns `ticker`, `name`, and... | [/mcp/list_get](/mcp/list_get) |
| `/api/ipo_calendar` | POST | Monthly IPO calendar from Nasdaq: deals that priced, were newly filed, or were w... | [/mcp/ipo_calendar](/mcp/ipo_calendar) |
| `wss://ws.prixe.io/nasdaq` | WebSocket | Real-time market-data stream for US stocks and ETFs (top-of-book snapshots, Best... | [/mcp/nasdaq](/mcp/nasdaq) |
| `wss://ws.prixe.io/crypto` | WebSocket | Real-time crypto market-data stream. Public frame protocol matches REST `/api/cr... | [/mcp/crypto_websocket](/mcp/crypto_websocket) |
| `wss://ws.prixe.io/order_book` | WebSocket | Real-time Level 2 order book depth for crypto. Receive an initial full-book snap... | [/mcp/order_book](/mcp/order_book) |
| `/api/news, /api/forms, /api/board_members` | POST | Optional AI-powered summarization available on supported endpoints. When enabled... | [/mcp/ai_summary](/mcp/ai_summary) |
| `/api/news` | POST | Fetches news data based on a search text. This endpoint communicates with a sepa... | [/mcp/news](/mcp/news) |
| `/api/forms` | GET | Get a list of available SEC form types for a stock ticker. Returns unique form t... | [/mcp/forms_get](/mcp/forms_get) |
| `/api/forms` | POST | Get SEC filing data for a stock ticker. Returns filings within a date range (las... | [/mcp/forms_post](/mcp/forms_post) |
| `/api/forms/financials` | POST | Standardized financial fundamentals for a stock ticker, sourced from SEC XBRL fi... | [/mcp/financials](/mcp/financials) |
| `/api/dividends_calendar` | POST | Dividends calendar for a single day: companies whose ex-dividend date falls on t... | [/mcp/dividends_calendar](/mcp/dividends_calendar) |
| `/api/earnings_calendar` | POST | Earnings calendar for a single day: companies reporting earnings on the requeste... | [/mcp/earnings_calendar](/mcp/earnings_calendar) |
| `/api/economic_calendar` | POST | Economic events calendar for a single day: scheduled macroeconomic releases by c... | [/mcp/economic_calendar](/mcp/economic_calendar) |
| `/api/board_members` | POST | Get board members and company officers for a stock ticker. Returns all board mem... | [/mcp/board_members](/mcp/board_members) |
| `/api/search` | POST | Search for tickers, company names, or CUSIPs | [/mcp/search](/mcp/search) |
| `/api/stats` | POST | Get market statistics including top gainers, losers, most active stocks, and top... | [/mcp/stats](/mcp/stats) |
| `/api/politicians` | POST | Returns U.S. Congressional stock transactions (purchases and sales) for both the... | [/mcp/politicians](/mcp/politicians) |
| `/api/politicians/list` | POST | Returns the set of politicians (House Representatives and U.S. Senators) that fi... | [/mcp/list_post](/mcp/list_post) |
| `/api/politicians/holdings` | POST | Returns per-ticker NET DISCLOSED TRADING ACTIVITY for a specific politician (Hou... | [/mcp/holdings](/mcp/holdings) |
| `/api/politicians/executive_disclosures` | POST | Returns OGE Form 278e annual public financial disclosures for senior White House... | [/mcp/executive_disclosures](/mcp/executive_disclosures) |
| `wss://ws.prixe.io/ws` | WEBSOCKET | WebSocket connection for receiving real-time price updates for a specified stock... | [/mcp/ws](/mcp/ws) |
| `/api/last_sold` | POST | Get the last sold price data for a specified stock ticker including bid/ask pric... | [/mcp/last_sold](/mcp/last_sold) |
| `/api/iex/bars, /api/sip/bars` | POST | OHLCV price bars for one or many tickers. The `/api/iex/*` path returns real-tim... | [/mcp/historical_&_latest_bars_(iex_/_sip)](/mcp/historical_&_latest_bars_(iex_/_sip)) |
| `/api/iex/quotes, /api/sip/quotes` | POST | Best bid/ask (NBBO) quotes for one or many tickers. `/api/iex/*` = real-time IEX... | [/mcp/historical_&_latest_quotes_(iex_/_sip)](/mcp/historical_&_latest_quotes_(iex_/_sip)) |
| `/api/iex/trades, /api/sip/trades` | POST | Individual trade prints (time & sales) for one or many tickers. `/api/iex/*` = r... | [/mcp/historical_&_latest_trades_(iex_/_sip)](/mcp/historical_&_latest_trades_(iex_/_sip)) |
| `/api/iex/snapshot, /api/sip/snapshot` | POST | A consolidated snapshot per ticker: the latest trade, latest quote, the current ... | [/mcp/snapshot_(iex_/_sip)](/mcp/snapshot_(iex_/_sip)) |
| `/api/sip/movers` | GET | Top gaining and losing stocks for the current session, ranked by percent change ... | [/mcp/movers](/mcp/movers) |
| `/api/sip/most_actives` | GET | The most active stocks for the current session, ranked by volume or trade count ... | [/mcp/most_actives](/mcp/most_actives) |
| `/api/corporate_actions` | POST | Corporate action events for one or many tickers: cash dividends, forward and rev... | [/mcp/corporate_actions](/mcp/corporate_actions) |
| `/api/options` | POST | Options market data. The default `type: "chain"` returns the option chain for an... | [/mcp/options](/mcp/options) |

## Data Logging & Privacy

By using this API, you acknowledge that the above data will be collected and stored as described.

- **IP Addresses**: We log the IP address of each API request for security and rate limiting purposes. We support proxy headers (X-Forwarded-For, X-Real-IP, CF-Connecting-IP, True-Client-IP) to capture the real client IP when behind proxies or load balancers.
- **Request/Response Details**: We log the endpoint accessed, HTTP method, request body, response status code, and response time for each API call.
- **API Key Usage**: We track which API key was used for each request to enforce rate limits and monitor usage patterns.
- **Timestamps**: We record the exact time of each API request for audit trails and debugging.