--- title: Skill 运行时查询指南 description: MobiusQuant Skill(嵌在 Claude Code / Codex / OpenClaw / Hermes 里)在运行时该如何查询指标和行情品种信息。 --- # Skill 运行时查询指南 > 受众:跑在 AI Agent 工具(Claude Code、Codex、OpenClaw、Hermes 等)里的 **MobiusQuant Skill**。本页告诉 Skill **遇到什么类型的用户问题该查哪里、按什么顺序查**。 > > 推荐用法:把本页链接放进你的 `SKILL.md`(让 LLM 在需要时读),不要把内容内联拷贝(链接能拿到我们的更新)。 --- ## 一图速查 | 用户问什么 | 最佳来源 | 为什么 | | --- | --- | --- | | "你支持哪些指标?" | `GET /llms-full.txt`(本站) | 25KB 一次 fetch 拿到全部 56 个英文索引 | | "X 指标有什么参数?" | `GET /indicators/.md`(本站) | 英文结构化数据,无 narrative 噪声 | | "X 指标的信号怎么解读?" | `GET /zh/indicators/.md`(本站) | 中文 narrative,含解读重点 / 信号 / 注意事项 | | "`<别名>` 对应什么 canonical?" | `GET /api/symbols/search?q=<别名>`(引擎) | 实时模糊查,中英文别名都认 | | "`` 上有 `` 吗?" | `GET /api/markets///symbols`(引擎) | 权威实时列表 | | "BTC 现在 5m K 线是什么?" | `POST /api/klines` 或 `/api/indicators`(引擎) | 实时数据,**永远调 API,不要引用 docs 缓存** | | **"这指标数值怎么解读?"** | **`POST /api/indicators?explain=true`**(引擎) | **响应自带 `knowledge.summary_focus` / `signals` / `caveats` —— 原样传给 LLM,不要让它自己猜解读规则** | **铁律**:静态参考信息 → 从 `docs.mobiusquant.ai` 取。实时数据 → 调 `api.mobiusquant.ai`。**指标解读 rubric → 永远带 `?explain=true`,把 knowledge 块转发给 LLM。** --- ## 静态参考(docs.mobiusquant.ai) 公开站点、CORS 全开、**无需 token**。可放心 fetch 和缓存。 ### 起步:一次 fetch 拿全 reference ```http GET https://docs.mobiusquant.ai/llms-full.txt ``` 返回 ~25KB 结构化英文,覆盖:Token 申请规则、11 个 venue、56 个指标(含默认参数 + 输出列)、Skill 接入、AI Agent 引导。 **推荐**:Skill 启动时(或用户首次问到数据/指标时)fetch 一次,session 内缓存。 ### 单指标详情 ```http GET https://docs.mobiusquant.ai/indicators/.md # 英文结构化 GET https://docs.mobiusquant.ai/zh/indicators/.md # 中文 narrative(含解读) ``` `` 是小写 canonical ID。完整 56 个: ``` accelerator_oscillator awesome_oscillator cci chande_mo connors_rsi coppock_curve dpo kst macd momentum ppo roc smi_ergodic stoch_rsi trix tsi ultimate_oscillator williams_r # 动量(18) fisher_transform rci_ribbon rsi rvi # 振荡器(4) alligator alma ema hma lsma mcginley_dynamic mobius_trend parabolic_sar supertrend tema vwma williams_stops # 趋势(12) adx aroon_oscillator choppiness_index vortex # 趋势强度(4) atr bollinger chande_kroll_stop donchian_channels fibonacci_bollinger_bands historical_volatility keltner_channels linear_regression_channel mass_index stdev # 波动率(10) chaikin_oscillator cmf cvd kvo obv pvo vwap # 成交量(7) price # 基础(1) ``` **莫比乌斯实验室(自研)**:`mobius_trend`。MobiusQuant 自创,非公开经典指标。 ### 总览 / 导航 | URL | 何时用 | | --- | --- | | `/llms.txt` | 2KB 站点索引(英文)—— 大致定位 | | `/llms-full.txt` | 25KB 全英文参考 —— **推荐第一个 fetch** | | `/indicators/index.md` | 英文指标总览 | | `/zh/indicators/index.md` | 中文指标总览 | | `/markets.md` | 英文 venue + canonical 规则 | | `/zh/markets.md` | 中文 venue + **完整品种枚举**(全部 512 个,A 股港股带中文名) | | `/token.md` | Token 申请 + Bearer 鉴权 + 限速 | | `/agents.md` | 通用 AI Agent 操作手册 | 所有 HTML 页同路径都有 `.md` 版本。`.md` 和 `.txt` 全部 CORS `*`。 --- ## 实时数据(api.mobiusquant.ai) **可选**带 `Authorization: Bearer mq_<43chars>`。不带也能调,只是限到 10 req/min per IP;带 token 提到 60 req/min。Token 免费申请:(7 天匿名)或 (登录永久)。 限速:匿名 10 req/min per IP · token 60 req/min。 ### Discovery 端点(实时、权威) ```bash # 所有 venue + WS 健康 curl -H "Authorization: Bearer mq_xxx" https://api.mobiusquant.ai/api/markets # 单 venue 的全品种 curl -H "Authorization: Bearer mq_xxx" \ https://api.mobiusquant.ai/api/markets/binance/perp/symbols # 实时指标 registry(参数 + 输出列) curl -H "Authorization: Bearer mq_xxx" https://api.mobiusquant.ai/api/indicators/registry # 可绘图子集 + 绘图协议 curl -H "Authorization: Bearer mq_xxx" https://api.mobiusquant.ai/api/indicators/catalog # 周期支持矩阵 curl -H "Authorization: Bearer mq_xxx" https://api.mobiusquant.ai/api/intervals ``` ### 自然语言 → canonical 用户说"BTC"、"比特币"、"Tencent"、"茅台",让引擎解析: ```bash curl -H "Authorization: Bearer mq_xxx" \ "https://api.mobiusquant.ai/api/symbols/search?q=比特币" # → [{"canonical": "BTCUSDT", "exchange": "binance", "market": "perp", ...}] ``` 或一次拉完整映射表: ```bash curl -H "Authorization: Bearer mq_xxx" https://api.mobiusquant.ai/api/symbols/builtin ``` ### 计算 / 数据端点 ```bash # 原始 OHLCV GET https://api.mobiusquant.ai/api/klines?exchange=binance&market=perp&symbol=BTCUSDT&interval=5m&limit=100 # K 线上跑指标 POST https://api.mobiusquant.ai/api/indicators body: { "exchange":"binance","market":"perp","symbol":"BTCUSDT", "interval":"5m","limit":100, "calc":[{"name":"rsi","params":{"period":14}}] } # 同上 + 绘图协议 POST https://api.mobiusquant.ai/api/chart # 自带 OHLCV 算指标(回测 / 自定义数据源) POST https://api.mobiusquant.ai/api/indicators/compute body: { "klines": [[1735689600000, 95000, 95500, 94800, 95200, 1234.5], ...], "interval": "1h", "calc": [{"name":"rsi","params":{"period":14}}] } # ≤ 2000 根,无 warmup buffer(用户自带 history) ``` --- ## Canonical 符号规则(直接背,不用 fetch) | 类别 | 形式 | 示例 | | --- | --- | --- | | 加密 | `{BASE}{QUOTE}` 全大写无分隔 | `BTCUSDT`、`BTCUSDC`、`1000PEPEUSDT` | | A 股(`stock:cn`)| 6 位裸代码(无 `sh`/`sz` 前缀,无 `.SS` 后缀)| `600519`、`300750` | | 港股(`stock:hk`)| 5 位带前导零 | `00700`、`09988` | | 美股(`stock:us`)| 裸 ticker | `AAPL`、`NVDA` | | 外汇(`forex:spot`)| 6 字母 `{BASE}{QUOTE}` | `EURUSD`、`USDJPY` | 引擎会自动把 native 格式翻译成 canonical。你不用手动把 `BTC-USDT-SWAP` 转成 `BTCUSDT`。但**给用户的引用和 prompt 里始终用 canonical 形式**。 --- ## 决策树 用户问到数据相关时: ``` ┌─ 用户在问 LIVE 数据(当前价、当前指标值)吗? │ └─ 是 → 调 api.mobiusquant.ai(带 Bearer token) │ - /api/klines 原始 OHLCV │ - /api/indicators 计算指标 │ - /api/chart K 线 + 绘图协议 │ ├─ 用户在问 AVAILABLE(有哪些指标 / venue)吗? │ └─ 本 session fetch 过 /llms-full.txt 没? │ ├─ 是 → 从缓存答 │ └─ 否 → 先 fetch /llms-full.txt 一次,缓存后再答 │ ├─ 用户在问指标的"怎么解读"吗? │ └─ fetch /zh/indicators/.md(中文,有完整解读 + 信号 + 注意事项) │ ├─ 用户在问某个 SYMBOL 的存在性 / canonical 形式吗? │ └─ 调 /api/symbols/search?q=<用户原话>(引擎认中英别名) │ └─ 用户在问指标的参数 / 输出列吗? └─ fetch /indicators/.md(英文结构化)或 /api/indicators/registry(live) ``` --- ## 缓存建议 - `/llms-full.txt`、`/indicators/.md`、`/markets.md` —— 内容更新**很慢**(新指标或 venue 调整才动)。整个 Skill session 内缓存即可,session 重启后再 refresh。 - `/api/markets`、`/api/indicators/registry` —— live,但分钟级几乎不变。5-10 分钟缓存安全。 - `/api/klines`、`/api/indicators`(计算)—— **永远 live**,不缓存。 --- ## 例子:用户说"看下 BTC 1 小时 MACD" 1. Skill 识别意图:在 live 数据上跑指标 2. 解析 symbol:用户说"BTC" → 从 `/llms-full.txt` 缓存 或调 `/api/symbols/search?q=BTC` → canonical `BTCUSDT` 在 `binance:perp` 3. 解析指标:用户说"MACD" → 缓存里查到:`macd`,默认参数 `{fast:12, slow:26, signal:9}` 4. 调 live: ```bash curl -X POST -H "Authorization: Bearer $MOBIUS_TOKEN" \ -H "Content-Type: application/json" \ -d '{"exchange":"binance","market":"perp","symbol":"BTCUSDT", "interval":"1h","limit":100, "calc":[{"name":"macd","params":{"fast":12,"slow":26,"signal":9}}]}' \ https://api.mobiusquant.ai/api/indicators ``` 5. (可选)用户进一步问"柱状线啥意思",这时 fetch `/zh/indicators/macd.md` 拿解读。 --- ## 引用规范 引用本站内容给用户时: - 始终带上原文 URL,方便用户深入。 - `.md` URL 优先于 `.html`。 - 如果引用的是中文专属页(如 `/zh/...`),明确说明是中文资料(英文 context 用户可能需要翻译)。 --- _本页是 Skill 运行时数据查询的唯一权威来源。Skill 维护者:从你的 `SKILL.md` 链接到本页,不要内联拷贝(链接能让你自动拿到我们的更新)。_