MODA Open API
주요 문서
샘플 코드를 참고하여 빠르게 연동할 수 있습니다.
빠르게 시작하기
온보딩 가이드를 따라 첫 API 호출을 경험해보고, API Key 발급 과정과 인증 구현을 따라해보세요.
API Key 발급
본격적인 연동을 위한 API Key 발급 안내입니다.
인증 헤더 만들기
JWT 토큰 생성 및 요청 헤더 구성 방법을 안내합니다.
요청 서명 만들기
주문 API용 HMAC-SHA512 서명 생성 방법을 안내합니다.
첫 API 호출하기
5분 안에 첫번째 200 OK 응답을 확인해보세요.
연동 가이드
REST API 연동
요청/응답 형식, 에러 처리 및 재시도 전략, Best Practice
WebSocket 연동
실시간 시세 스트리밍, 채널 구독, 연결 관리
API 요청 수 제한
Rate Limit 정책, API별 가중치, 대응 전략
기능별 주요 API
MODA Open API가 제공하는 기능을 확인하세요. 각 API의 상세 스펙은 API Reference에서 확인할 수 있습니다.
시세 조회
| API | 방식 | 경로 / 채널 |
|---|---|---|
| 5단계 호가 조회 | GET | /quotes/{stockCd}/order-book |
| 캔들 차트 조회 | GET | /quotes/candle-chart/{stockCd}/history |
| 틱 차트 조회 | GET | /quotes/tick-chart/{stockCd}/history |
| 일별 OHLC 조회 | GET | /quotes/ohlc/{stockCd} |
| 실시간 시세 | WebSocket | market.quote |
| 실시간 호가 (5단계) | WebSocket | market.orderbook |
| 호가 취소 이벤트 | WebSocket | market.orderbook.cancel |
| OHLC Ticker | WebSocket | market.ticker |
주문
| API | Method | 경로 |
|---|---|---|
| 신규주문 | POST | /orders |
| 청산주문 | POST | /orders/close-out |
| 정정주문 | POST | /orders/modify |
| 취소주문 | POST | /orders/cancel |
| TPSL주문 | POST | /orders/tpsl |
체결 내역
| API | Method | 경로 |
|---|---|---|
| 체결 내역 조회 | GET | /execution/history |
| 미체결 내역 조회 | GET | /execution/pending/history |
| 체결 합계 조회 | GET | /execution/summary |
계좌 · 자산
| API | Method | 경로 |
|---|---|---|
| 예수금/출금가능금액 | GET | /accounts/available/amount |
| 예탁자산 조회 | GET | /accounts/deposit-asset/{accountNo} |
| 보유 포지션 조회 | GET | /assets/positions |
| 포지션증거금 조회 | GET | /assets/position/deposits |
| 주문증거금 조회 | GET | /assets/order/deposits |
종목 · 거래
| API | Method | 경로 |
|---|---|---|
| 보유종목 조회 | GET | /stocks/possessions |
| 주문잔고 조회 | GET | /stocks/positions |
| 주문 정보 조회 | GET | /stocks/{stockCode}/order-info |
| 주문종목 조회 | GET | /stocks/orders |
| 스프레드 그룹 조회 | GET | /stocks/spread-groups |
| 청산손익 조회 | GET | /trades/close-out/profit-loss |
| 주문내역 조회 | GET | /trades/history |
| 청산 내역 조회 | GET | /trades/liquidation/history |
| WebSocket 토큰 발급 | POST | /auths/ws-token |
수정일 2026-03-26 04:38:23