Public market data
PrivateCex API
The public API is keyless and read-only. Anyone can query prices, tickers, trades, order books, candles, and snapshots without creating an account.
Base URL
https://privatecex.com
Authentication
No API key required
Caching
Results refresh every 1 to 30 seconds
Response format
Successful responses use a consistent JSON envelope:
{
"success": true,
"data": {
"prices": []
}
}
Errors return a JSON envelope with an HTTP status code:
{
"success": false,
"error": {
"message": "Market not found.",
"code": 404
}
}
Endpoints
| Method | Endpoint | Description | Parameters |
|---|---|---|---|
| GET | /api/v1/time |
Current server time in ISO-8601 and Unix timestamp format. | None |
| GET | /api/v1/markets |
All active public trading markets and currency metadata. | None |
| GET | /api/v1/prices |
Latest price for every active market. | None |
| GET | /api/v1/prices/{symbol} |
Latest price for one market symbol. | symbol, for example BTC-USDT |
| GET | /api/v1/tickers |
Exchange-wide ticker feed with best bid, best ask, 24h stats, and last trade. | None |
| GET | /api/v1/tickers/{symbol} |
Ticker details for one market. | symbol, for example XMR-BTC |
| GET | /api/v1/trades |
Latest trades across all active markets. | limit, default 50, max 500 |
| GET | /api/v1/markets/{symbol}/order-book |
Aggregated public order book levels. | depth, default 50, max 500 |
| GET | /api/v1/markets/{symbol}/trades |
Latest trades for one market. | limit, default 50, max 500 |
| GET | /api/v1/markets/{symbol}/open-orders |
Anonymized public open limit orders for one market. | limit, default 100, max 1000 |
| GET | /api/v1/markets/{symbol}/candles |
OHLC candle data from internal trades. | interval and limit. Common intervals include 1m, 5m, 15m, 1h, 4h, and 1d. Limit default 100, max 1000 |
| GET | /api/v1/markets/{symbol}/snapshot |
Combined market, ticker, order book, recent trades, and candles payload. | depth, trades, interval, candles |
Examples
Latest prices
curl https://privatecex.com/api/v1/prices
BTC-USDT order book
curl "https://privatecex.com/api/v1/markets/BTC-USDT/order-book?depth=25"
Market trades
curl "https://privatecex.com/api/v1/markets/XMR-BTC/trades?limit=50"
Market snapshot
curl "https://privatecex.com/api/v1/markets/BTC-USDT/snapshot?depth=25&trades=25&interval=5m&candles=100"
Notes
- All public API endpoints return JSON and support cross-origin reads.
- API results are cached and refreshed every few seconds, depending on the endpoint.
- Public open orders are anonymized and never include user IDs, reserved balances, or account details.
- Private account APIs are not exposed yet. Balance, deposit, withdrawal, and order submission features remain website-only.