> ## Documentation Index > Fetch the complete documentation index at: https://takeprofit.com/docs/llms.txt > Use this file to discover all available pages before exploring further. # Platform API > The TakeProfit Platform API: historical candles, volume footprint and TPO profiles and the security catalog over REST, live candles, footprint and order book streams over WebSocket, with one API key. Platform API The data behind our charts Request historical candles, volume footprint and TPO profiles and the security catalog over REST, and subscribe to live candles, footprint profiles and order books over WebSocket. One key in one header works for both. [Make your first request](https://takeprofit.com/docs/platform-api/quickstart.md) [Get an API key](https://takeprofit.com/docs/platform-api/authentication.md) ## What you can request > **[Candles](https://takeprofit.com/docs/platform-api/rest/overview)** > > Historical candles for any supported timeframe, plus the list of timeframes. Over WebSocket, the latest candle and then live updates of the forming one. > **[Volume footprint](https://takeprofit.com/docs/platform-api/websocket/footprint.md)** > > Buy and sell volume per price row, with the row size scale a settings UI can offer. Live profiles arrive as complete replacements. > **[TPO profiles](https://takeprofit.com/docs/platform-api/rest/overview)** > > Market Profile data for day, week and month timeframes, with point of control, initial balance and time blocks. > **[Order book](https://takeprofit.com/docs/platform-api/websocket/orderbook.md)** > > One snapshot of the top levels per side, then incremental updates. Available over WebSocket. > **[Securities](https://takeprofit.com/docs/platform-api/rest/overview)** > > Search by name, ticker or ISIN, list exchanges and their securities, and read a security specification with tick size and precision. > **[One key for both](https://takeprofit.com/docs/platform-api/authentication.md)** > > A personal API token from your TakeProfit settings, sent in the `x-api-key` header on every request and on the WebSocket handshake. ## Two ways in > **[REST API](https://takeprofit.com/docs/platform-api/rest/overview)** > > `https://public-api.takeprofit.com/api/v1/marketdata` > > History and reference data. Every endpoint answers `GET` only, and unknown query parameters are rejected. > **[WebSocket API](https://takeprofit.com/docs/platform-api/websocket/overview)** > > `wss://public-api.takeprofit.com/api/v1/marketdata` > > Live streams. Subscription parameters go in the query string; the client sends nothing after the handshake. Both sections open with an overview of the shared parameters, and their endpoint pages are generated from our OpenAPI and AsyncAPI specifications, so every parameter and response field matches the running API. The three streams are [candles](https://takeprofit.com/docs/platform-api/websocket/candles.md), [volume footprint](https://takeprofit.com/docs/platform-api/websocket/footprint.md) and [order book](https://takeprofit.com/docs/platform-api/websocket/orderbook.md). ## From key to live data
  1. Step 1 of 4 Create an API key In Settings, create a personal API token on a paid plan and copy it once: the full key is shown a single time.
  2. Step 2 of 4 Find the security Search by name, ticker or ISIN and take the exchange and symbol pair from the hit. Every other endpoint speaks that pair.
  3. Step 3 of 4 Load history Ask for candles, footprint or TPO profiles over a range. Prices and volumes come as decimal strings, so nothing is rounded on the way.
  4. Step 4 of 4 Go live Open a WebSocket connection with the same key in the handshake header and keep the picture up to date as the market moves.
## Good to know * **One header, both protocols.** `x-api-key` authenticates REST requests and the WebSocket upgrade alike. Exactly one value is accepted. * **Securities are identified by exchange and symbol.** Take them from the Securities endpoints; ISINs work in search only. * **Unknown query parameters are rejected** with `400`, so a typo fails loudly instead of being ignored. * **Personal, non-commercial use only.** Redistribution or resale of the data is not permitted, and commercial licensing is not available at this time. See [Usage terms](https://takeprofit.com/docs/platform-api/limits.md#usage-terms). * **Usage is metered in credits, per account.** REST gets 100,000 credits per 60 seconds, shared by all your keys, and every request costs at least 1,000, so up to 100 requests a minute. Streams draw on a separate 1,000 credits per 300 seconds. Prices and limits are in [Credits and limits](https://takeprofit.com/docs/platform-api/limits.md). ## Request a feature > **[Post a feature request](https://takeprofit.featureos.app/)** > > Tell us where to take the API next. An MCP server for it? More market data sources? Share the idea or vote for one. > **[Discuss on Discord](https://discord.gg/takeprofit)** > > Talk it through with the team and other developers before or after you post. Need help? A question about the API, a bug or unsure about the setup? Our team and other developers answer you directly on Discord. [Join our Discord](https://discord.gg/takeprofit) [https://discord.gg/takeprofit](https://discord.gg/takeprofit) `discord.gg/takeprofit` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.