DWLF — 시장 분석 플랫폼
API 기본 주소: https://api.dwlf.co.uk/v2
인증
API 키 인증을 사용합니다. 키는 TOOLS.md에서 확인하세요. 헤더:
Authorization: ApiKey dwlf_sk_...
도우미 스크립트: scripts/dwlf-api.sh
빠른 시작
# 일반 GET 요청
./scripts/dwlf-api.sh GET /market-data/BTC-USD
# 쿼리 파라미터 포함
./scripts/dwlf-api.sh GET "/events?symbol=BTC-USD&limit=10"
# POST 요청
./scripts/dwlf-api.sh POST /visual-backtests '{"strategyId":"...","symbol":"BTC-USD"}'
심볼 형식
- 암호화폐:
BTC-USD,ETH-USD,SOL-USD(항상-USD접미사 포함) - 주식/ETF:
TSLA,NVDA,META,MARA,RIOT - 외환:
GBP-USD,EUR-USD
사용자가 "BTC"라고 말하면 → BTC-USD를 사용하세요. "TSLA"라고 말하면 → TSLA를 사용하세요.
핵심 엔드포인트
시장 데이터
| 메서드 | 경로 | 설명 |
|---|---|---|
| GET | /market-data/{symbol}?interval=1d&limit=50 | OHLCV 캔들 데이터 |
| GET | /market-data/symbols | 추적 중인 모든 심볼 목록 |
| GET | /support-resistance/{symbol} | 점수가 포함된 지지/저항 레벨 |
| GET | /chart-indicators/{symbol}?interval=1d | 모든 지표 (RSI, EMA, MACD 등) |
| GET | /trendlines/{symbol} | 자동 감지된 추세선 |
| GET | /events?symbol={symbol}&limit=20 | 시스템 이벤트 (돌파 등) |
| GET | /events?type=custom_event&scope=user&symbol={symbol}&days=30 | 사용자 맞춤 이벤트 (wcl, dss, 반전 등) |
전략 및 신호
| 메서드 | 경로 | 설명 |
|---|---|---|
| GET | /visual-strategies | 사용자 전략 목록 |
| GET | /visual-strategies/{id} | 전략 상세 정보 |
| POST | /visual-strategies | 전략 생성 |
| PUT | /visual-strategies/{id} | 전략 업데이트 |
| GET | /user/trade-signals/active | 활성 거래 신호 |
| GET | /user/trade-signals/recent?limit=20 | 최근 신호 |
| GET | /user/trade-signals/stats | 신호 성능 통계 |
| GET | /user/trade-signals/symbol/{symbol} | 특정 심볼의 신호 |
백테스팅
| 메서드 | 경로 | 설명 |
|---|---|---|
| POST | /visual-backtests | 백테스트 트리거 (비동기) |
| GET | /visual-backtests/{id} | 백테스트 결과 조회 |
백테스트는 비동기로 실행됩니다 — POST로 트리거한 후 GET으로 완료될 때까지 폴링하세요.
포트폴리오 및 거래
| 메서드 | 경로 | 설명 |
|---|---|---|
| GET | /portfolios | 포트폴리오 목록 |
| GET | /portfolios/{id} | 포트폴리오 상세 + 보유 내역 |
| GET | /trades?status=open | 거래 목록 |
| POST | /trades | 새 거래 기록 |
| PUT | /trades/{id} | 거래 업데이트 |
| GET | /trade-plans | 거래 계획 목록 |
관심 목록
| 메서드 | 경로 | 설명 |
|---|---|---|
| GET | /watchlist | 관심 목록 조회 |
| POST | /watchlist | 심볼 추가 ({"symbol":"BTC-USD"}) |
| DELETE | /watchlist/{symbol} | 심볼 제거 |
맞춤 이벤트
| 메서드 | 경로 | 설명 |
|---|---|---|
| GET | /custom-events | 맞춤 이벤트 목록 |
| POST | /custom-events | 맞춤 이벤트 생성 |
| GET | /custom-events/{id} | 이벤트 상세 정보 |
맞춤 이벤트 심볼 활성화
| 메서드 | 경로 | 설명 |
|---|---|---|
| POST | /custom-event-symbols/:eventId/enable-all | 이벤트에 심볼 일괄 활성화 |
| POST | /custom-event-symbols/:eventId/disable-all | 이벤트에 심볼 일괄 비활성화 |
| GET | /custom-event-symbols/event/:eventId | 이벤트에 활성화된 심볼 조회 |
| GET | /custom-event-symbols | 모든 이벤트-심볼 연결 목록 |
전략 심볼 활성화
| 메서드 | 경로 | 설명 |
|---|---|---|
| POST | /strategy-symbols/:strategyId/enable-all | 전략에 심볼 일괄 활성화 |
| POST | /strategy-symbols/:strategyId/disable-all | 전략에 심볼 일괄 비활성화 |
| GET | /strategy-symbols/strategy/:strategyId | 전략에 활성화된 심볼 조회 |
| GET | /strategy-symbols | 모든 전략-심볼 연결 목록 |
평가
| 메서드 | 경로 | 설명 |
|---|---|---|
| POST | /evaluations | 평가 실행 트리거 |
| GET | /evaluations/{id} | 평가 결과 조회 |
심볼 활성화 (생성 후 필수)
⚠️ 중요: 맞춤 이벤트 또는 전략을 생성해도 자동으로 심볼이 활성화되지는 않습니다. 생성 후에는 반드시 사용자에게 활성화할 심볼을 물어본 후 enable 엔드포인트를 호출해야 합니다. 이 단계를 수행하지 않으면 이벤트/전략이 트리거되거나 신호를 생성하지 않습니다.
워크플로: 맞춤 이벤트
- 이벤트 생성 →
POST /custom-events - 이벤트 컴파일 →
POST /custom-events/{id}/compile - 사용자에게 활성화할 심볼을 물어보기
- 심볼 활성화 →
POST /custom-event-symbols/{eventId}/enable-allwith{ "symbols": ["BTC-USD", "ETH-USD"] }
워크플로: 전략
- 전략 생성 →
POST /visual-strategies - 전략 컴파일 →
POST /visual-strategies/{id}/compile - 사용자에게 활성화할 심볼을 물어보기
- 심볼 활성화 →
POST /strategy-symbols/{strategyId}/enable-allwith{ "symbols": ["BTC-USD", "ETH-USD"] }
활성화된 심볼 확인
- 이벤트 심볼:
GET /custom-event-symbols/event/{eventId} - 전략 심볼:
GET /strategy-symbols/strategy/{strategyId} - 전체 활성화 목록:
GET /custom-event-symbols및GET /strategy-symbols(쿼리:?activeOnly=true)
심볼 비활성화
- 이벤트:
POST /custom-event-symbols/{eventId}/disable-allwith{ "symbols": [...] } - 전략:
POST /strategy-symbols/{strategyId}/disable-allwith{ "symbols": [...] }
응답 형식 지정
사용자에게 데이터를 제시할 때:
시장 개요: 가격, 변동률, 주요 지지/저항 레벨, 최근 이벤트를 표시합니다.
신호: 심볼, 방향, 진입가, 손절가, 신뢰도 점수, 전략 이름을 표시합니다.
지지/저항 레벨: 점수순으로 정렬(가장 강한 레벨 우선), 레벨과 접촉 횟수를 표시합니다.
백테스트: 거래 횟수, 승률, 총 수익률, 샤프 비율, 최고/최저 거래를 표시합니다.
사용 가능한 지표
EMA (다중 기간), SMA, RSI, MACD, 볼린저 밴드, DSS (이중 평활 확률론), 스토캐스틱 RSI, ATR, ADX, OBV, 거래량 프로파일, 일목균형표, 피보나치 되돌림, 지지/저항, 추세선, 캔들스틱 패턴, SMC (오더 블록, FVG, BOS/ChoCH).
아카데미
DWLF 아카데미는 CDN에 호스팅된 교육 콘텐츠 모음입니다 (15개 트랙, 60개 이상의 강의). 지표, 이벤트, 전략, 차트 작성 등 다양한 주제를 다룹니다. 인증이 필요하지 않습니다.
아카데미 도구를 사용하여 강의 내용을 읽고 DWLF 개념을 이해하세요:
dwlf_list_academy_tracks— 모든 트랙과 강의 탐색dwlf_search_academy— 키워드로 검색dwlf_get_academy_lesson— 특정 강의 읽기 (마크다운)
사용자가 "DWLF에서 X는 어떻게 작동하나요?" 또는 "DSS가 무엇인가요?"라고 물으면 먼저 아카데미를 확인하세요 — 해당 내용을 설명하는 강의가 있을 가능성이 높습니다.
상세 참고 자료
- API 엔드포인트 (파라미터, 응답 형식):
references/api-endpoints.md파일 참조 - 전략 빌더 (노드 유형, 엣지 연결, 예제):
references/strategy-builder.md파일 참조