REST & WebSocket
Market Data API
Pull historical candles, pre-aggregated volume footprint, TPO profiles, and streaming L2 order books across crypto, FX, equities, and CFDs. Authenticated via a single x-api-key header.
Order Flow Native
Stream real-time candles and footprints over WebSocket, or historical candles, footprints, and TPO profiles via REST. No tick firehose to ingest, bucket, and reconcile before you test an idea.
One Key, REST & WebSocket
The same x-api-key header authenticates REST endpoints and WebSocket upgrades. No OAuth round-trips, secondary credentials, or heavyweight client SDKs required.
String Decimals
Prices and volumes return as trimmed decimal strings. Eliminate floating-point rounding errors between the matching engine and your execution model.
# History over REST
curl -G "https://public-api.takeprofit.com/api/v1/marketdata/footprint" \
-H "x-api-key: $TAKEPROFIT_API_KEY" \
--data-urlencode "exchange=CXBNCE" \
--data-urlencode "symbol=BTC/USDT" \
--data-urlencode "timeframe=1h"
# Live over WebSocket — same key, sent on the handshake
websocat -H "x-api-key: $TAKEPROFIT_API_KEY" \
"wss://public-api.takeprofit.com/api/v1/marketdata/orderbook/stream\
?exchange=CXBNCE&symbol=BTC%2FUSDT"
Footprint, TPO, Candles &
Order Books
Four datasets on one key. Query deep historical archives via REST or subscribe to low-latency streaming updates over WebSocket.
Volume Footprint
- Bid/ask volume aggregated per price level
- Custom tick size in quote-currency units
- Up to 1,000 profiles/call
TPO Market Profile
- Pre-calculated POC, Value Area, and Initial Balance
- Split sessions by type via mergeSessions=GROUP_BY_TYPE
- Up to 400 periods per call without per-timeframe limits
Live Order Book
- Full initial snapshot followed by incremental delta updates
- Direct data source driving TakeProfit’s Liquidity Heatmap
- Up to 20 concurrent depth streams per account quota
Historical Candles
- Standard, 1-second, and custom tick-interval bars
- Up to 10,000 candles per query with live candle-forming.
- Multi-year historical archives across crypto, equities, and FX
From Zero to Live Data
Four steps, no sales call, no application form, no approval queue.
01. Create Account
Sign up with your email. Subscribe to the All-In plan, or connect an exchange to unlock it through trading.
02. Generate Token
Navigate to Settings → Login & Security → Personal API Tokens to generate and copy your read-only tpk_live_ key.
03. Lookup Symbols
Run a single search call to map trading pairs and internal exchange identifiers across all supported assets.
04. Pull & Stream
Fetch historical footprints via REST, or connect your WebSocket client to stream live market flow.
Prefer using AI
Instead of writing code?
All of these endpoints are available through our MCP integration.
Explore MCP ↗API Roadmap
Have Questions
Before You Build?
No proprietary SDK is required. Any HTTP/WebSocket client works natively:
- • cURL & Shell
- • Python (requests, websockets, aiohttp)
- • Go (net/http, gorilla/websocket)
- • Node.js / TypeScript