공개 API
읽기 전용 시장·트레이더 데이터로, 이 사이트의 공개 페이지가 쓰는 엔드포인트와 같습니다. HTTPS로 JSON을 반환하며 키가 필요 없습니다.
| 엔드포인트 | 쿼리 파라미터 | 반환 |
|---|---|---|
| GET /api/market/metas | limit (≤500), minVolume | 모든 무기한 선물: 마크·중간·오라클 가격, 펀딩비, 미결제약정, 24시간 거래대금, 최대 레버리지. |
| GET /api/market/ohlcv | symbol, timeframe (1m…1w), limit | 한 마켓의 캔들. |
| GET /api/market/positions | symbol, limit (≤100) | 추적 중인 대형 포지션(마켓별 선택 가능). |
| GET /api/market/liquidation-clusters | symbol, bins (5–80), rangePct (1–90) | 마크 가격 주변 추적 포지션의 예상 청산 가격대. |
| GET /api/traders | timeframe (24h|7d|30d|all), sortBy (pnl|winrate|trades|sharpe|equity), sortOrder, limit (≤100), offset, minPnl, minWinrate, minTrades, minEquity, isActive | 기간별 손익, 승률, 샤프, 낙폭이 포함된 트레이더 리더보드. |
| GET /api/traders/{address} | — | 한 트레이더의 통계와 스타일. |
| GET /api/traders/{address}/positions | — | 한 트레이더의 보유 포지션. |
| GET /api/traders/{address}/trades | limit (≤100) | 한 트레이더의 최근 청산 거래. |
| GET /api/traders/cohorts | timeframe | 계정 규모와 손익으로 나눈 트레이더 그룹과 롱/숏 노출. |
예시:
curl 'https://hyperbase.trade/api/market/ohlcv?symbol=BTC&timeframe=1h&limit=3'
API가 버전 관리되기 전까지는 응답 형식이 예고 없이 바뀔 수 있습니다. 캐시를 사용하고 요청 빈도를 적당히 유지해 주세요. 각 수치의 정의는 「산출 방법」 페이지에 있습니다.