DWLF — 市场分析平台

API基础地址：https://api.dwlf.co.uk/v2

认证

使用API密钥认证。请查阅TOOLS.md文件获取密钥。请求头：

Authorization: ApiKey dwlf_sk_...

辅助脚本：scripts/dwlf-api.sh

快速入门

# Generic GET request
./scripts/dwlf-api.sh GET /market-data/BTC-USD

# With query params
./scripts/dwlf-api.sh GET "/events?symbol=BTC-USD&limit=10"

# POST request
./scripts/dwlf-api.sh POST /visual-backtests '{"strategyId":"...","symbol":"BTC-USD"}'

注释示例

# Create a horizontal line annotation at a key support level
./scripts/dwlf-api.sh POST /annotations '{
  "symbol": "BTC-USD",
  "timeframe": "1d",
  "type": "hline",
  "data": { "price": 95000, "color": "#00ff00", "label": "Key Support", "lineStyle": "solid", "lineWidth": 2, "showPrice": true },
  "origin": "ai"
}'

# Create a text annotation on chart
./scripts/dwlf-api.sh POST /annotations '{
  "symbol": "ETH-USD",
  "timeframe": "4h",
  "type": "text",
  "data": { "text": "Breakout zone", "price": 3800, "time": "2025-06-01T00:00:00Z", "color": "#ffaa00", "fontSize": 14 },
  "origin": "ai"
}'

# Bulk create multiple annotations
./scripts/dwlf-api.sh POST /annotations/bulk '{
  "annotations": [
    { "symbol": "BTC-USD", "timeframe": "1d", "type": "hline", "data": { "price": 100000, "color": "#ff0000", "label": "Resistance" }, "origin": "ai" },
    { "symbol": "BTC-USD", "timeframe": "1d", "type": "hline", "data": { "price": 92000, "color": "#00ff00", "label": "Support" }, "origin": "ai" }
  ]
}'

# List annotations for a symbol
./scripts/dwlf-api.sh GET "/annotations?symbol=BTC-USD&timeframe=1d"

# Update an annotation (merges data — only changes specified fields)
./scripts/dwlf-api.sh PUT /annotations/abc123 '{ "data": { "color": "#ff0000" } }'

交易计划与头寸规模示例

# Calculate position size
./scripts/dwlf-api.sh POST /tools/position-size '{
  "accountSize": 10000,
  "riskPercent": 2,
  "entryPrice": 95000,
  "stopLoss": 93000,
  "symbol": "BTC-USD"
}'

# Create a trade plan
./scripts/dwlf-api.sh POST /trade-plans '{
  "symbol": "BTC-USD",
  "direction": "long",
  "entryPrice": 95000,
  "stopLoss": 93000,
  "takeProfit": 100000,
  "notes": "Bounce off key support with RSI divergence"
}'

代码格式

• 加密货币：BTC-USD、ETH-USD、SOL-USD（始终带有-USD后缀）
• 股票/ETF：TSLA、NVDA,META,MARA,RIOT
• 外汇:英镑-美元,欧元-美元

如果用户说"BTC" → 使用BTC-美元. 如果"TSLA" → 使用TSLA.

核心端点

市场数据

图表标注

交易计划

仓位规模

用户设置

策略与信号

回测

回测是异步的——先通过 POST 触发，然后轮询 GET 直到状态变为："completed"。

• 请求体：{ strategyId, symbols: ["BTC-USD"], startDate: "2025-01-01", endDate: "2026-01-30" }
• 注意：symbols是一个数组，不是单个 symbol（单数形式）。

投资组合与交易

观察列表

自定义事件

自定义事件符号激活

策略符号激活

AI 摘要

💡优先使用这些！这些AI摘要端点已为AI消费预聚合。当用户询问"BTC怎么样？"或"现在什么情况？"时，先调用这些端点，再进行多个单独的调用。

评估

符号激活（创建后必需）

⚠️重要提示：创建自定义事件或策略不会自动为任何符号激活它。创建后，您必须询问用户要为其激活哪些符号，然后调用启用端点。如果没有此步骤，事件/策略将不会触发或生成信号。

工作流程：自定义事件

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"] }

编辑事件或策略

⚠️任何对自定义事件或策略的更新都需要重新编译！评估器运行的是编译后的输出，而非可视化图。如果你更新了节点、边、条件或参数而未重新编译，这些更改将无效。

• 编辑事件后：POST /custom-events/{id}/compile
• 编辑策略后：POST /visual-strategies/{id}/compile

在任何PUT更新调用后立即重新编译。

检查活跃符号

• 事件符号：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（订单块、公允价值缺口、突破/结构变化）。

学院

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