Public API
Read-only market and trader data, the same endpoints this site's public pages use. JSON over HTTPS, no key required.
| Endpoint | Query parameters | Returns |
|---|---|---|
| GET /api/market/metas | limit (≤500), minVolume | Every perpetual: mark, mid and oracle price, funding, open interest, 24h volume, max leverage. |
| GET /api/market/ohlcv | symbol, timeframe (1m…1w), limit | Candles for one market. |
| GET /api/market/positions | symbol, limit (≤100) | Largest tracked open positions, optionally for one market. |
| GET /api/market/liquidation-clusters | symbol, bins (5–80), rangePct (1–90) | Projected liquidation levels of tracked positions around the mark. |
| GET /api/traders | timeframe (24h|7d|30d|all), sortBy (pnl|winrate|trades|sharpe|equity), sortOrder, limit (≤100), offset, minPnl, minWinrate, minTrades, minEquity, isActive | The trader leaderboard with PnL windows, win rate, Sharpe and drawdown. |
| GET /api/traders/{address} | — | One trader's statistics and style. |
| GET /api/traders/{address}/positions | — | One trader's open positions. |
| GET /api/traders/{address}/trades | limit (≤100) | One trader's recent closed trades. |
| GET /api/traders/cohorts | timeframe | Traders grouped by account size and by PnL, with long/short exposure. |
Example:
curl 'https://hyperbase.trade/api/market/ohlcv?symbol=BTC&timeframe=1h&limit=3'
Responses can change without notice while the API is unversioned; please cache and keep request rates modest. Definitions of every figure are on the Methodology page.