DWLF — 市場分析平台

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}	取得評估結果

代號啟用（建立後必要）

⚠️ 重要： 建立自訂事件或策略後，不會自動為任何代號啟用。建立之後，您必須詢問使用者要為哪些代號啟用，然後呼叫啟用端點。若未執行此步驟，事件/策略將不會觸發或產生訊號。

工作流程：自訂事件

1. 建立事件 → POST /custom-events
2. 編譯事件 → POST /custom-events/{id}/compile
3. 詢問使用者要為哪些代號啟用
4. 啟用代號 → POST /custom-event-symbols/{eventId}/enable-all，附帶 { "symbols": ["BTC-USD", "ETH-USD"] }

工作流程：策略

1. 建立策略 → POST /visual-strategies
2. 編譯策略 → POST /visual-strategies/{id}/compile
3. 詢問使用者要為哪些代號啟用
4. 啟用代號 → POST /strategy-symbols/{strategyId}/enable-all，附帶 { "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-all，附帶 { "symbols": [...] }
• 策略：POST /strategy-symbols/{strategyId}/disable-all，附帶 { "symbols": [...] }

回應格式

向使用者呈現資料時：

市場概覽： 顯示價格、百分比變化、關鍵支撐/阻力位以及任何近期事件。

訊號： 顯示代號、方向、進場點、停損點、信心分數、策略名稱。

支撐/阻力位： 按分數排序（最強優先），顯示位階和觸及次數。

回測： 顯示交易次數、勝率、總報酬率、夏普比率、最佳/最差交易。

可用指標

EMA（多個週期）、SMA、RSI、MACD、布林通道、DSS（雙重平滑隨機指標）、 隨機 RSI、ATR、ADX、OBV、成交量分佈、一目均衡表、費氏回撤、 支撐/阻力、趨勢線、K 線型態、SMC（訂單塊、FVGs、BOS/ChoCH）。

學院

DWLF 學院是託管於 CDN 的教育內容集合（15 個主題，60 多堂課程），涵蓋指標、事件、策略、圖表等。不需要驗證。

使用學院工具閱讀課程內容並了解 DWLF 概念：

• dwlf_list_academy_tracks — 瀏覽所有主題和課程
• dwlf_search_academy — 按關鍵字搜尋
• dwlf_get_academy_lesson — 閱讀特定課程 (markdown)

當使用者問「X 在 DWLF 中如何運作？」或「什麼是 DSS？」時，請先查閱學院 — 很可能有相關的課程說明。

詳細參考資料

• API 端點（參數、回應結構）：請閱讀 references/api-endpoints.md
• 策略建構器（節點類型、邊線連接、範例）：請閱讀 references/strategy-builder.md