行业板块行情

来源同步：/Users/mac/Projects/chatgpt-codex/doc/api_Boards.md

所属接口集：板块行情

请求 URL

GET /v1/api/boards/industry

认证方式

Bearer Token（详见 认证与签名）

接口概述

返回行业板块实时指标。互补主源：industry→akshare，concept→push2（本接口固定行业，主源 akshare）；主源失败自动尝试 push2，均不可用时回退数据库快照。接口不接受 source 查询参数。

请求参数

参数	类型	必填	说明
sort	string	否	排序字段：pct（默认）、main_net、amount、turnover
order	string	否	排序方向：desc（默认）、asc
top	int	否	返回前 N 条记录，范围 1~MAX_TOP（默认 200），不传则返回全部
min_amount	float	否	成交额下限（元）
min_turnover	float	否	换手率下限（%）
min_main_net	float	否	主力净流入下限（元）
excode	string	否	逗号分隔的板块代码列表，将这些代码从结果中排除（不区分大小写）
code / board_code	string	否	逗号分隔的板块代码，精确匹配筛选
name / board_name	string	否	板块名称关键词，不区分大小写子串匹配

接口说明

• 所有过滤器在排序和截断前生效。
• 数据源互补：行业用 akshare，概念用 push2；全局 BOARDS_DATA_SOURCE 已废弃，不再用于选型。
• 主源请求失败时自动尝试另一源；若均失败则回退到数据库 boards_boardsnapshot 快照，并尝试用实时源补齐快照缺失的指标。
• 若快照也无数据，返回 HTTP 503。
• 结果使用 TTLCache 缓存 3 秒。

响应格式示例

{
  "ts": 1739571000,
  "type": "industry",
  "source": "akshare",
  "items": [
    {
      "code": "BK1035",
      "name": "半导体",
      "pct": 0.0234,
      "amount": 123456789.0,
      "main_net": 2345678.0,
      "turnover": 3.21,
      "float_mv": 560000000000.0,
      "total_mv": 780000000000.0
    }
  ]
}

返回状态

状态码	说明
200	成功
400	参数错误
401	未认证
403	无权限
503	所有数据源均不可用

---