快速开始

1. 探测鉴权

curl --fail --silent --show-error \
  "https://api.mobiusquant.ai/api/gendangzou/bootstrap?client=my-agent&client_version=1.0.0&platform=codex"

读取 authentication.mode：

值	处理方式
none	不携带 Token
optional	Token 可选
required	使用 Bearer Token；缺少时读取 authentication.apply_url

Authorization: Bearer mq_xxx

2. 发现能力

按业务域查询能力索引：

curl --fail --silent --show-error \
  "https://api.mobiusquant.ai/api/gendangzou/capabilities?domain=sector"

按能力 ID 获取请求和响应契约：

curl --fail --silent --show-error \
  "https://api.mobiusquant.ai/api/gendangzou/capabilities/sector.detail"

能力发现接口支持 ETag。收到 304 时继续使用本地缓存。

3. 查询材料

省略 date 时使用当前北京时间日期：

curl --fail --silent --show-error \
  -H "Authorization: Bearer ${MOBIUSQUANT_TOKEN}" \
  "https://api.mobiusquant.ai/api/gendangzou/policy-materials?status=signal&page_size=10"

媒体材料路径为 /media-materials。status=signal 返回形成板块信号的材料； status=no_signal 返回已完成分析但未形成板块信号的材料。

4. 查询板块信号

curl --fail --silent --show-error \
  -H "Authorization: Bearer ${MOBIUSQUANT_TOKEN}" \
  "https://api.mobiusquant.ai/api/gendangzou/sector-heat?view=policy&detail=compact&page_size=10"

view 的可选值：

• policy
• market_attention
• market_trading

响应中的 snapshot.as_of、snapshot.published_at 和 snapshot.market_trade_date 分别表示版本业务日期、发布时间和资金实际交易日。

5. 解析公司名称

curl --fail --silent --show-error \
  -H "Authorization: Bearer ${MOBIUSQUANT_TOKEN}" \
  "https://api.mobiusquant.ai/api/gendangzou/companies?q=长鑫科技&detail=compact&page_size=10"

结果按精确匹配、前缀匹配和包含匹配排序。后续调用使用字符串形式的六位 stock_code，不要转换为整数。

6. 查询证据

从板块结果取得 sector_id：

curl --fail --silent --show-error \
  -H "Authorization: Bearer ${MOBIUSQUANT_TOKEN}" \
  "https://api.mobiusquant.ai/api/gendangzou/sectors/<sector_id>/evidence?presentation=material&detail=compact&page_size=10"

presentation=material 按原始材料归并；presentation=trace 保留逐条评分和观点。

7. 固定数据版本

需要跨接口使用同一版本或回看历史时：

curl --fail --silent --show-error \
  -H "Authorization: Bearer ${MOBIUSQUANT_TOKEN}" \
  "https://api.mobiusquant.ai/api/gendangzou/snapshots/latest?as_of=2026-07-24&detail=compact"

后续请求使用响应中的实际 snapshot_id。as_of 返回指定日期或此前最近的完整版本。

8. 分页与错误

分页从 page=1 开始，page_size 最大为 100。Agent 建议从 10 条开始，根据 pagination.pages 决定是否继续。

429 和 503 可以按照 Retry-After 重试；400、401、404 和 422 应修正请求。每次排障保留响应中的 request_id。