Skill 运行时查询指南

受众:跑在 AI Agent 工具(Claude Code、Codex、OpenClaw、Hermes 等)里的 MobiusQuant Skill。本页告诉 Skill 遇到什么类型的用户问题该查哪里、按什么顺序查。
推荐用法:把本页链接放进你的 SKILL.md(让 LLM 在需要时读),不要把内容内联拷贝(链接能拿到我们的更新)。

一图速查

用户问什么	最佳来源	为什么
"你支持哪些指标?"	`GET /llms-full.txt`(本站)	25KB 一次 fetch 拿到全部 56 个英文索引
"X 指标有什么参数?"	`GET /indicators/<id>.md`(本站)	英文结构化数据,无 narrative 噪声
"X 指标的信号怎么解读?"	`GET /zh/indicators/<id>.md`(本站)	中文 narrative,含解读重点 / 信号 / 注意事项
"`<别名>` 对应什么 canonical?"	`GET /api/symbols/search?q=<别名>`(引擎)	实时模糊查,中英文别名都认
"`<venue>` 上有 `<symbol>` 吗?"	`GET /api/markets/<exchange>/<market>/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/<id>.md         # 英文结构化
GET https://docs.mobiusquant.ai/zh/indicators/<id>.md      # 中文 narrative(含解读)

<id> 是小写 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 免费申请:https://www.mobiusquant.ai/zh/apply-token(7 天匿名)或 https://www.mobiusquant.ai/zh/account(登录永久)。

限速:匿名 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/<id>.md(中文,有完整解读 + 信号 + 注意事项)
│
├─ 用户在问某个 SYMBOL 的存在性 / canonical 形式吗?
│   └─ 调 /api/symbols/search?q=<用户原话>(引擎认中英别名)
│
└─ 用户在问指标的参数 / 输出列吗?
    └─ fetch /indicators/<id>.md(英文结构化)或 /api/indicators/registry(live)

缓存建议

/llms-full.txt、/indicators/<id>.md、/markets.md —— 内容更新很慢(新指标或 venue 调整才动)。整个 Skill session 内缓存即可,session 重启后再 refresh。
/api/markets、/api/indicators/registry —— live,但分钟级几乎不变。5-10 分钟缓存安全。
/api/klines、/api/indicators(计算)—— 永远 live,不缓存。

例子:用户说"看下 BTC 1 小时 MACD"

Skill 识别意图:在 live 数据上跑指标
解析 symbol:用户说"BTC" → 从 /llms-full.txt 缓存或调 /api/symbols/search?q=BTC → canonical BTCUSDT 在 binance:perp
解析指标:用户说"MACD" → 缓存里查到:macd,默认参数 {fast:12, slow:26, signal:9}

调 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

(可选)用户进一步问"柱状线啥意思",这时 fetch /zh/indicators/macd.md 拿解读。

引用规范

引用本站内容给用户时:

始终带上原文 URL,方便用户深入。
.md URL 优先于 .html。
如果引用的是中文专属页(如 /zh/...),明确说明是中文资料(英文 context 用户可能需要翻译)。

本页是 Skill 运行时数据查询的唯一权威来源。Skill 维护者:从你的 SKILL.md 链接到本页,不要内联拷贝(链接能让你自动拿到我们的更新)。

Skill 运行时查询指南 ​

一图速查 ​

静态参考(docs.mobiusquant.ai) ​

起步:一次 fetch 拿全 reference ​

单指标详情 ​

总览 / 导航 ​

实时数据(api.mobiusquant.ai) ​

Discovery 端点(实时、权威) ​

自然语言 → canonical ​

计算 / 数据端点 ​

Canonical 符号规则(直接背,不用 fetch) ​

决策树 ​

缓存建议 ​

例子:用户说"看下 BTC 1 小时 MACD" ​

引用规范 ​

Skill 运行时查询指南

一图速查

静态参考(docs.mobiusquant.ai)

起步:一次 fetch 拿全 reference

单指标详情

总览 / 导航

实时数据(api.mobiusquant.ai)

Discovery 端点(实时、权威)

自然语言 → canonical

计算 / 数据端点

Canonical 符号规则(直接背,不用 fetch)

决策树

缓存建议

例子:用户说"看下 BTC 1 小时 MACD"

引用规范