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.