---
title: 跟党走 API 快速开始
description: 鉴权探测、能力发现、业务查询、版本控制和错误处理的最短调用流程。
pageClass: gendangzou-doc
---

# 快速开始

## 1. 探测鉴权

```bash
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` |

```http
Authorization: Bearer mq_xxx
```

## 2. 发现能力

按业务域查询能力索引：

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

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

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

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

## 3. 查询材料

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

```bash
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. 查询板块信号

```bash
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. 解析公司名称

```bash
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`：

```bash
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. 固定数据版本

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

```bash
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`。