공개 시세와 Feed
이 페이지의 API는 API 키가 필요 없습니다. 모든 REST 요청의 기본 주소는 https://api.btxpro.co.kr입니다. 상세 필드와 응답 모델은 전체 엔드포인트와 레퍼런스를 확인하세요.
시스템과 마켓
| 메서드 | 경로 | 용도 |
|---|---|---|
| GET | /health |
프로세스 liveness. 정상 시 본문 없는 200 |
| GET | /ready |
의존성과 거래 서비스 준비 여부. 미준비 시 503 |
| GET | /v1/time |
서버 시간과 서명 시간 차이 확인 |
| GET | /v1/currencies |
통화 메타데이터 |
| GET | /v1/markets |
마켓 목록 |
| GET | /v1/markets/{symbol} |
마켓 상세 |
/health가 정상이어도 거래 준비를 보장하지는 않습니다. 클라이언트는 실제 API의 오류 응답도 처리해야 합니다.
시세 조회
| 경로 | 주요 파라미터 | 설명 |
|---|---|---|
/v1/market/ticker |
symbol 선택 |
생략하면 전체 마켓 시세 |
/v1/market/orderbook |
symbol 필수, tick, limit |
tick 0~4, 기본 0. 기본 100개, 최대 1000개 |
/v1/market/trades |
symbol 필수, limit |
최근 체결. 기본 100개, 최대 1000개 |
/v1/market/candles |
symbol 필수, interval, limit, startTime, endTime |
interval 기본 1h, 기본 500개, 최대 1000개 |
모두 GET입니다. 캔들 조회의 시작 시각은 포함, 종료 시각은 미포함입니다. 허용되는 캔들 interval 값은 파라미터 명세에서 확인합니다.
curl 'https://api.btxpro.co.kr/v1/market/orderbook?symbol=BTC-USDT&tick=0&limit=20'
curl 'https://api.btxpro.co.kr/v1/market/candles?symbol=BTC-USDT&interval=1h&limit=24'
실시간으로 제공되는 공개 채널은 현재 ticker 하나입니다. 호가·체결·캔들의 실시간 WS 채널은 현재 제공하지 않으므로 위 REST API로 조회합니다.
Feed
| 메서드 | 경로 | 용도 |
|---|---|---|
| GET | /v1/feed/home |
추천·최신·인기 등 Feed 홈 구성 |
| GET | /v1/feed/categories |
활성 카테고리 목록 |
| GET | /v1/feed/articles |
공개 글 목록·검색·정렬·cursor 조회 |
| GET | /v1/feed/articles/{feedArticleId} |
글 상세와 Markdown 본문 |
| POST | /v1/feed/articles/{feedArticleId}/view |
공개 글 조회수 증가 |
curl 'https://api.btxpro.co.kr/v1/feed/categories'
curl 'https://api.btxpro.co.kr/v1/feed/articles?limit=20'
글 상세의 식별자는 feedArticleId입니다. URL slug를 ID 대신 전달하지 마세요. 글 목록의 q 검색어는 2~80자 범위이며 sort·cursor와 함께 보낼 수 없습니다. 검색은 모든 유효 검색어를 포함하는 글을 찾고, 제목 → 요약 → 본문 일치 순으로 정렬합니다. 조회수 증가 요청은 공개 API지만 데이터를 변경합니다. 단순 목록 조회를 위해 호출하지 마세요.