---
title: "异动 / 偏离值（监管异动体系）"
method: GET
path: "/v1/abnormal"
tags: ["pro"]
---

# 异动 / 偏离值（监管异动体系）

`GET /v1/abnormal`

## Request

- Base URL: `https://api.ashareapi.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.ashareapi.com/v1/abnormal`
- Auth: none declared

**短线监管异动 / 偏离值**：触发「严重异动」、「10日100% 偏离」、异动盯盘名单、严重异动提醒。这是**短线风控的关键信号**（个股因连续大涨/大跌被交易所或数据方标记异动）。

`mode` 取值：
· `deviation` **偏离值热门榜**（今日实时）—— 触发偏离阈值的个股，含 `reason` 规则 / `pct` 涨幅 / `turnover` 换手 / `board_desc` 连板 / `concepts` 概念 / `window` 窗口
· `deviation_hist` **偏离值热门榜（历史）**—— 需 `date`（YYYY-MM-DD，真实交易日）
· `deviation_plan` **偏离值（今日 + 明日两组）**—— 返回行数组，每行含 `group`（`today`/`tomorrow`）区分
· `abnormal` **异动频率（含异动原因）**—— 需 `date`；⭐ 每日全量（常见 500+ 条），含 `reason` 规则 / `status` 异动状态 / `abn_start` 异动起始日；顶层附 `total` 当日总条数
· `watch` **异动盯盘名单（今日）**—— 监控中的个股 + `watch_start`/`watch_end`
· `watch_hist` **异动盯盘名单（历史）**—— 需 `date`
· `alert` **严重异动提醒（今日）**—— ⭐ 短线重点：`reason` 为**人读提醒原因**（如「10日内3次异动个股」「10日内偏离值临近100%」）+ `price` 现价

**字段口径**（各 mode 按需返回下列子集）：
`code` 代码 · `name` 名称 · `reason` 触发/提醒原因 · `pct` 涨跌幅% · `board_desc` 连板描述 · `concepts` 概念（顿号分隔）· `turnover` 换手%（偏离榜）· `window` 偏离窗口（如 `10日`）· `rule2` 第二条规则 · `trigger_pct` 触发严重异动阈值% · `limit_price` 参考价 · `status` 异动状态（如「未触发异动」）· `date` 数据日期 · `price` 现价 · `abn_start` 异动起始日（未触发为 `0000-00-00`）· `group` 分组（仅 plan）· `watch_start`/`watch_end` 监控起止（仅 watch）。

⚠️ 历史类 mode（`deviation_hist`/`abnormal`/`watch_hist`）的 `date` 须为**真实交易日**（非交易日返回空）；缺省用今天。
⚠️ `abnormal` 默认返回当日**全量**（`limit` 可调，默认 600，足以覆盖）。
⚠️ `data` 恒为**行数组**（可直接落 DataFrame）；`abnormal` 的当日总条数在顶层 `total`。

## Query parameters

- `mode` string: deviation / deviation_hist / deviation_plan / abnormal / watch / watch_hist / alert
- `date` string: 历史类 mode 需要的日期（YYYY-MM-DD）；空=今天
- `limit` integer: 仅 mode=abnormal/alert 生效：单次返回上限（默认 600）

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/ashareapi/apis/a-api.md) · [All operations](https://skmtc.dev/ashareapi/apis/a-api/llms.txt) · [OpenAPI document](https://skmtc.dev/ashareapi/apis/a-api/revisions/fc57bdcb13d5?raw)
