미라클 API 문서
빠르고 안정적인 선물 시장 데이터 액세스를 위한 강력한 API
API 개요
미라클 API 서비스는 개발자가 국내외 선물 시장 데이터에 쉽게 접근할 수 있도록 다양한 엔드포인트를 제공합니다. 우리의 API는 RESTful 아키텍처 원칙을 따르며, 실시간 데이터를 위한 WebSocket 연결도 지원합니다.
기본 URL
https://api.miracle-api.com/v1
인증
모든 API 요청은 API 키를 필요로 합니다. API 키는 요청 헤더의
X-API-Key 필드에 포함되어야 합니다.
curl -X GET "https://api.miracle-api.com/v1/symbols" \ -H
"X-API-Key: YOUR_API_KEY"
주요 엔드포인트
GET
/symbols
사용 가능한 모든 선물 종목 목록을 반환합니다.
응답 예시
{ "symbols": [ { "symbol": "ESM3", "name": "S&P 500 E-mini
Futures", "exchange": "CME", "category": "INDEX",
"expiry_date": "2023-06-16", "currency": "USD", "tick_size":
0.25, "contract_size": 50 }, { "symbol": "GCM3", "name": "Gold
Futures", "exchange": "COMEX", "category": "COMMODITY",
"expiry_date": "2023-06-28", "currency": "USD", "tick_size":
0.1, "contract_size": 100 } ] }
GET
/charts/{symbol}
특정 종목의 차트 데이터를 반환합니다.
파라미터
| 이름 | 필수 | 설명 |
|---|---|---|
| symbol | 필수 | 조회할 종목 코드 |
| interval | 필수 | 차트 간격 (1m, 5m, 15m, 30m, 1h, 4h, 1d, 1w, 1M) |
| from | 옵션 | 시작 타임스탬프 (Unix 시간) |
| to | 옵션 | 종료 타임스탬프 (Unix 시간) |
| limit | 옵션 | 반환할 최대 데이터 수 (기본값: 300, 최대: 1000) |
응답 예시
{ "symbol": "ESM3", "interval": "1h", "data": [ { "time":
1620734400000, "open": 4186.25, "high": 4188.75, "low":
4183.50, "close": 4187.75, "volume": 45621 }, { "time":
1620738000000, "open": 4187.75, "high": 4190.25, "low":
4185.00, "close": 4189.50, "volume": 38762 } ] }
WebSocket
/ws/quotes
선물 종목의 실시간 시세 데이터를 WebSocket을 통해 구독합니다.
구독 메시지 예시
{ "action": "subscribe", "symbols": ["ESM3", "GCM3"],
"apiKey": "YOUR_API_KEY" }
응답 메시지 예시
{ "type": "quote", "symbol": "ESM3", "data": { "time":
1620745823456, "price": 4189.25, "open": 4186.25, "high":
4192.50, "low": 4183.50, "volume": 128937, "change": 3.00,
"change_percent": 0.07 } }