介绍
# DWLF — Market Analysis Platform
API 基础地址：`https://api.dwlf.co.uk/v2`
## 认证
使用 API Key 认证。请查看 `TOOLS.md` 获取密钥。请求头： ``` Authorization: ApiKey dwlf_sk_... ```
辅助脚本：`scripts/dwlf-api.sh`
## 快速开始
```bash # 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"}' ```
## 标注示例
```bash # 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" } }' ```
## 交易计划与仓位管理示例
```bash # 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` - 外汇：`GBP-USD`, `EUR-USD`
如果用户说“BTC” → 使用 `BTC-USD`。如果是“TSLA” → 使用 `TSLA`。
## 核心端点
### 市场数据 | 方法 | 路径 | 描述 | |--------|------|-------------| | GET | `/market-data/{symbol}?interval=1d&limit=50` | OHLCV K线 | | 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 | `/annotations?symbol={symbol}&timeframe={tf}` | 列出标注 | | POST | `/annotations` | 创建标注（水平线、文本、趋势线、矩形、通道） | | PUT | `/annotations/{annotationId}` | 更新标注（合并数据字段） | | DELETE | `/annotations/{annotationId}` | 删除标注 | | POST | `/annotations/bulk` | 批量创建标注 |
### 交易计划 | 方法 | 路径 | 描述 | |--------|------|-------------| | GET | `/trade-plans` | 列出交易计划 | | GET | `/trade-plans/{planId}` | 获取交易计划 | | POST | `/trade-plans` | 创建交易计划 | | PUT | `/trade-plans/{planId}` | 更新交易计划 | | DELETE | `/trade-plans/{planId}` | 删除交易计划 | | POST | `/trade-plans/{planId}/duplicate` | 复制交易计划 |
### 仓位管理 | 方法 | 路径 | 描述 | |--------|------|-------------| | POST | `/tools/position-size` | 根据风险参数计算仓位大小 |
### 用户设置 | 方法 | 路径 | 描述 | |--------|------|-------------| | GET | `/user/settings` | 获取用户设置 | | PUT | `/user/settings` | 更新用户设置 | | DELETE | `/user/settings/{settingKey}` | 删除设置项 |
### 策略与信号 | 方法 | 路径 | 描述 | |--------|------|-------------| | 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 | `/backtests` | 触发回测（异步） | | GET | `/backtests` | 列出回测 | | GET | `/backtests/summary` | 回测摘要 | | GET | `/backtests/{requestId}` | 获取回测状态 | | GET | `/backtests/{requestId}/results` | 获取回测结果 | | DELETE | `/backtests/{requestId}` | 删除回测 |
回测是异步的 —— POST 触发，然后轮询 GET 直到 `status: "completed"`。 - Body: `{ strategyId, symbols: ["BTC-USD"], startDate: "2025-01-01", endDate: "2026-01-30" }` - 注意：`symbols` 是一个**数组**，不是 `symbol`（单数）。
### 投资组合与交易 | 方法 | 路径 | 描述 | |--------|------|-------------| | 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` | 列出所有策略-代码关联 |
### AI 摘要 | 方法 | 路径 | 描述 | |--------|------|-------------| | GET | `/ai/dashboard` | 完整账户概览：观察列表、信号、交易、投资组合、策略、事件 | | GET | `/ai/symbol-brief/{symbol}` | 单一代码快照：价格、K线、指标、支撑/阻力、事件、信号 | | GET | `/ai/strategy-performance` | 所有策略及其信号统计、胜率、盈亏细分 |
> 💡 **优先使用这些端点！** AI 摘要端点已预先聚合，专为 AI 消费设计。当用户问“BTC 怎么样？”或“最近发生了什么？”时，先调用这些端点，再发起多个单独调用。
### 评估 | 方法 | 路径 | 描述 | |--------|------|-------------| | 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"] }`
### 编辑事件或策略
> ⚠️ **对自定义事件或策略的任何更新都需要重新编译！** > 评估器运行的是**编译后**的输出，而不是可视化图表。如果您更新了节点、边、条件或参数而没有重新编译，更改将**不会生效**。
- 编辑事件后：`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（订单块、FVG、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`