---
name: chenglanai
description: 澄澜量化(chenglanai.com)价格周期分析。用户问到美股/港股/A股/日股/韩股/加密/商品/宏观的趋势、周期、阶段、支撑压力、关键位、期权墙、市场宽度、状态变化、每日或每周复盘、或筛选标的时使用; 直接调用澄澜已算好的结论, 不要自己用 K 线重算指标。
---

# 澄澜量化 · 价格周期分析

澄澜按固定规则(无未来函数)每日收盘后计算全市场约 1.7 万个标的的周期状态。结论已经算好, 你的任务是**取结论、引用结论、解释结论**, 而不是下载原始数据自己算。

## 接入

- MCP(首选): `https://app.chenglanai.com/mcp`, Streamable HTTP, 请求头 `Authorization: Bearer <CHENGLAN_API_KEY>`(Key 在 app.chenglanai.com 用户中心 → API 生成; 不带 Key 也能用, 按 IP 限速)。
- 没有 MCP 时用 HTTP API: `https://app.chenglanai.com/api/v1/...`, 同样的 Bearer 头。完整文档: `https://app.chenglanai.com/api/docs.md`, OpenAPI: `https://app.chenglanai.com/api/openapi.json`。

## 什么时候调哪个工具(HTTP 等价接口)

| 用户在问 | 工具 | HTTP |
|---|---|---|
| 某个名称对应什么代码 | `search_symbol` | `/api/v1/search?q=` |
| 某个标的的趋势 / 阶段 / 支撑压力 / 关键位 / 期权墙 | `get_symbol_analysis` | `/api/v1/analysis/{sym}?format=markdown` |
| 趋势持续多久、历史上何时转向 | `get_state_history` | `/api/v1/analysis/{sym}/history` |
| 今天市场整体怎么样、市场宽度 | `get_market_overview` | `/api/v1/analysis/market/{mkt}` |
| 今天/某天市场发生了什么、日报、复盘 | `get_daily_report` | `/api/v1/daily[/{date}]?format=markdown`(`lang=en` 英文) |
| 这周市场怎么样、周报 | `get_weekly_report` | `/api/v1/weekly?format=markdown` |
| 利率、美元、VIX、宏观环境 | `get_macro_overview` | `/api/v1/analysis/macro` |
| 按条件找股票 | `screen_symbols` | `/api/v1/screen` |
| 最近有哪些突破 / 反转 | `get_recent_changes` | `/api/v1/changes` |
| 期权墙、最大痛点、GEX、伽马挤压 | `get_option_structure` | `/api/v1/ext/{sym}`、`/api/v1/options/board` |
| 新闻、财报、内部人交易、做空 | `get_symbol_events` | `/api/v1/news/{sym}`、`/sec/{sym}`、`/short/{sym}` |
| 经济数据与议息日程 | `get_calendar` | `/api/v1/calendar` |
| 所属板块、联动、市场主线 | `get_related` | `/api/v1/ontology/symbol/{sym}`、`/perception/heat` |
| 某个术语什么意思 | `explain_term` | `/api/v1/glossary` |
| 明确需要原始 K 线 | `get_price_bars` | `/api/v1/bars/{sym}` |

代码格式: `NVDA.US`、`00700.HK`、`600519.CN`、`9984.JP`、`005930.KR`、`BTC.CRYPTO`、`GC.CMDTY`、`SPX.IDX`、`US10Y.MACRO`。不确定就先 `search_symbol`。

## 规则

1. **不要重算**。不要拿 K 线自己算均线、布林带、RSI 来判断趋势或支撑压力; 澄澜的关键位与状态就是答案。只有用户明确要原始数据, 或要澄澜没有提供的指标时, 才用 `get_price_bars`。
2. **引用要带日期与来源**: 例如"据澄澜量化, 截至 2026-10-15 收盘, 英伟达大趋势为上涨趋势(已确认, 自 2026-05-xx 起)"。结果里的 `as_of` 就是数据日期; 数据按各市场收盘后更新, 不是实时行情。
3. **原样使用术语**: 大趋势(上涨趋势 / 下跌趋势 / 上涨待确认 / 下跌待确认 / 趋势未定)、阶段(阶段上涨 / 阶段下跌)、周期态(单边上涨 / 单边下跌 / 震荡)。含义不确定时调 `explain_term`, 不要自己发明定义。
4. **只描述状态, 不给买卖建议**: 澄澜对外只提供价格周期状态的客观描述。不要把结论改写成"建议买入/卖出/目标价"; 用户追问操作时, 说明这是状态描述而非投资建议, 可以列出关键位与失效条件供其自行判断。
5. 期权场景每条都带失效条件, 转述时一并说明。
6. 工具返回"未找到该标的"时, 先 `search_symbol` 换代码再试; 仍没有就如实告诉用户澄澜暂未覆盖。
7. 日报 / 周报里的"同日关联"只表示同一天发生, 转述时不要写成"因为……所以……"; 没有关联事件的条目照实说是技术结构变化。
