> For the complete documentation index, see [llms.txt](https://docs.infoway.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.infoway.io/rest-api/basic-info/get-market-overview.md). # GET市场概况数据 市场温度、涨跌家数、总成交额（含昨日缩量/放量对比）、全球指数、领涨行业、大盘综述、涨跌幅榜单 ### 接口说明 该系列接口提供市场维度的概况数据，包括市场温度（估值/情绪）、涨跌家数分布、全球指数列表、领涨行业、大盘综述，以及涨幅榜/跌幅榜/热度榜等排行榜数据。 ### 请求频率 跟其他接口请求频率使用同一个频率限制。具体每秒请求次数根据套餐决定。可以参考 [接口限制说明](https://docs.infoway.io/getting-started/api-limitation) ### 错误码说明 参考 [HTTP错误码说明](https://docs.infoway.io/getting-started/error-codes/http) ### 请求头 | 参数 | 类型 | 必填 | 描述 | | -------- | ------ | -- | ------------ | | `apiKey` | String | 是 | 您套餐中的API Key | ### 多语言支持 (I18n) 本页所有接口均支持多语言返回，追加 Query 参数 `lang` 即可控制返回内容中名称类字段的语言： | 参数名 | 类型 | 必填 | 描述 | 示例值 | | ------ | ------ | -- | ---------------------------- | ------- | | `lang` | String | 否 | `en` 返回英文（默认）；`zh-CN` 返回简体中文 | `zh-CN` | 两种语言的缓存相互独立、互不影响。传入其他值时按默认值 `en` 处理，不会报错。 **受 `lang` 影响的字段举例** | 接口 | 字段 | `lang=zh-CN` | `lang=en` | | ---- | ---------------------------- | ------------------- | ---------------------------------------------------------- | | 全球指数 | `name` | 纳斯达克 | NASDAQ | | 领涨行业 | `data.lists[].lists[].name` | 系统软件 | Systems Software | | 领涨行业 | `leading_name` 龙头股名 | 中国信息科技 | CHINA INFO TECH | | 大盘综述 | `overview` | 香港恒指收盘持平，早盘高开后续回落…… | Hong Kong's HSI closed flat after fading a morning gap-up… | | 榜单目录 | `name` / `indicators[].name` | 全部 / 最新价 | All / Price | | 榜单数据 | `name`、`indicators.industry` | 辰兴发展 | CHEN XING | > \[!WARNING] **涨跌家数**接口只返回数字统计，没有可翻译的文本字段，传 `lang` 不会有任何差异。 ### 支持的市场代码 `HK`（港股）、`US`（美股）、`CN`（A股） *** ### 市场温度 获取市场估值温度和情绪温度（0-100），可用于判断市场冷热。 **接口地址** * 基本路径：`/common/v2/basic/market/temperature` * 完整路径：`https://data.infoway.io/common/v2/basic/market/temperature` **Request param入参说明** | 参数名 | 类型 | 必填 | 描述 | 示例值 | | -------- | ------ | -- | ---------------------- | ------- | | `market` | String | 否 | 市场代码，逗号分隔，默认`HK,US,CN` | `HK,US` | **返回示例** ```json { "markets": ["HK", "US"], "data": { "list": [ { "market": "HK", "temp": "69", "temp_intro": "温度适宜并逐渐上升中", "valuation": "80", "sentiment": "58" }, { "market": "US", "temp": "36", "valuation": "54", "sentiment": "18" } ] } } ``` | 字段名 | 类型 | 描述 | | ------------ | ------ | ---------------- | | `market` | String | 市场代码 | | `temp` | String | 综合温度（0-100，越高越热） | | `temp_intro` | String | 温度描述 | | `valuation` | String | 估值温度 | | `sentiment` | String | 情绪温度 | *** ### 涨跌家数 获取市场涨跌家数分布统计。 **接口地址** * 基本路径：`/common/v2/basic/market/breadth/{market}` * 完整路径：`https://data.infoway.io/common/v2/basic/market/breadth/{market}` **路径参数** | 参数名 | 类型 | 必填 | 描述 | 示例值 | | -------- | ------ | -- | ---- | ---- | | `market` | String | 是 | 市场代码 | `HK` | **返回示例** ```json { "market": "HK", "data": { "flatline": 928, "rise_less_than_three": 816, "rise_three_to_five": 200, "rise_five_to_seven": 110, "rise_more_than_seven": 128, "fall_less_than_three": 686, "fall_three_to_five": 154, "fall_five_to_seven": 69, "fall_more_than_seven": 88 } } ``` | 字段名 | 类型 | 描述 | | ---------------------- | ------- | --------- | | `flatline` | Integer | 平盘家数 | | `rise_less_than_three` | Integer | 涨幅<3%家数 | | `rise_three_to_five` | Integer | 涨幅3%-5%家数 | | `rise_five_to_seven` | Integer | 涨幅5%-7%家数 | | `rise_more_than_seven` | Integer | 涨幅>7%家数 | | `rise_halted` | Integer | 涨停家数 | | `fall_less_than_three` | Integer | 跌幅<3%家数 | | `fall_three_to_five` | Integer | 跌幅3%-5%家数 | | `fall_five_to_seven` | Integer | 跌幅5%-7%家数 | | `fall_more_than_seven` | Integer | 跌幅>7%家数 | | `fall_halted` | Integer | 跌停家数 | > \[!TIP] 上涨家数 = 5 个 `rise_*` 字段之和，下跌家数 = 5 个 `fall_*` 字段之和。如果只需要「上涨 / 平盘 / 下跌」三个汇总数字，直接用下面的**市场总成交额**接口的 `breadth` 即可。 *** ### 市场总成交额 一个请求返回三组数据：**涨跌家数**、**市场总成交额**、以及**与上一交易日的缩量/放量对比**。 **接口地址** * 基本路径：`/common/v2/basic/market/turnover/{market}` * 完整路径：`https://data.infoway.io/common/v2/basic/market/turnover/{market}` **路径参数** | 参数名 | 类型 | 必填 | 描述 | 示例值 | | -------- | ------ | -- | -------------------------- | ---- | | `market` | String | 是 | 市场代码，支持 `CN` / `HK` / `US` | `CN` | **Request param入参说明** | 参数名 | 类型 | 必填 | 描述 | 示例值 | | ------ | ------ | -- | --------------------------- | ------- | | `lang` | String | 否 | 返回语言，`zh-CN` 或 `en`，默认 `en` | `zh-CN` | **返回示例** ```json { "market": "CN", "currency": "CNY", "date": "2026-08-26", "timestamp": 1787727811, "minute_of_day": 423, "turnover": "1808723242719.83", "turnover_scope": "market", "sector_turnover": "1808507515134", "sector_volume": "1067090254", "sector_count": 132, "breadth": { "rise": 2788, "fall": 2343, "flatline": 162, "scope": "market" }, "indexes": [ { "counter_id": "IX/SH/000001", "turnover": "857223487993.3", "volume": "489553021", "rise": 1236, "fall": 934, "flatline": 57, "timestamp": 1787727811 }, { "counter_id": "IX/SZ/399001", "turnover": "951499754726.53", "volume": "577607360", "rise": 324, "fall": 163, "flatline": 13, "timestamp": 1787727811 } ], "compare_status": "ready", "prev": { "date": "2026-08-25", "turnover": "1832000000000", "same_time": "1780000000000", "same_time_minute": 423 }, "compare": { "vs_prev_close": { "change": "-23276757280.17", "change_pct": "-0.012706", "trend": "shrink" }, "vs_prev_same_time": { "change": "28723242719.83", "change_pct": "0.016137", "trend": "expand" } } } ``` | 字段名 | 类型 | 描述 | | --------------------------- | ------- | ---------------------------------------------------- | | `market` | String | 市场代码 | | `currency` | String | 所有金额字段的计价货币 | | `date` | String | 交易日（UTC 日期） | | `timestamp` | Integer | 数据时间戳（秒） | | `minute_of_day` | Integer | 该时间戳对应的 UTC 当日分钟数，用于与「昨日同一时刻」对齐 | | `turnover` | String | **市场总成交额** | | `turnover_scope` | String | 上一行的口径：`market` 全市场大市成交额；`industry_sectors` 全部行业板块合计 | | `sector_turnover` | String | 全部行业板块成交额合计（任何市场都返回，可用于交叉核对） | | `sector_volume` | String | 全部行业板块成交量合计（股数） | | `sector_count` | Integer | 该市场行业板块总数 | | `breadth.rise` | Integer | 上涨家数 | | `breadth.fall` | Integer | 下跌家数 | | `breadth.flatline` | Integer | 平盘家数 | | `breadth.scope` | String | 涨跌家数的口径，含义同 `turnover_scope` | | `indexes` | Array | 构成大市成交额的各指数明细，见下表 | | `compare_status` | String | `ready` 可对比；`warming_up` 对比数据尚在积累（详见下文） | | `prev.date` | String | 对比基准的交易日 | | `prev.turnover` | String | 该交易日**全天**成交额 | | `prev.same_time` | String | 该交易日**同一时刻**的累计成交额 | | `prev.same_time_minute` | Integer | 实际匹配到的时刻（UTC 当日分钟数） | | `compare.vs_prev_close` | Object | 与昨日**全天**成交额相比 | | `compare.vs_prev_same_time` | Object | 与昨日**同一时刻**累计成交额相比 | | `change` | String | 增减金额，负数表示缩量 | | `change_pct` | String | 增减比例，**小数**（`-0.012706` 表示 −1.2706%），保留 6 位小数 | | `trend` | String | `expand` 放量 / `shrink` 缩量 / `flat` 持平（±0.5% 以内） | `indexes[]` 数组元素： | 字段名 | 类型 | 描述 | | ------------ | ------- | ------------ | | `counter_id` | String | 指数内部追溯ID | | `turnover` | String | 该指数报出的成交额 | | `volume` | String | 该指数报出的成交量 | | `rise` | Integer | 该指数成分股上涨家数 | | `fall` | Integer | 该指数成分股下跌家数 | | `flatline` | Integer | 该指数成分股平盘家数 | | `timestamp` | Integer | 该指数的数据时间戳（秒） | > \[!TIP] A 股可用 `indexes` 把沪市（`IX/SH/000001`）与深市（`IX/SZ/399001`）分开取用。 **成交额口径** `turnover` 始终返回该市场当前可得的最完整口径，具体是哪一种由 `turnover_scope` 标明： | 市场 | `turnover_scope` | 取自 | 说明 | | ---- | ------------------ | ----------- | ---------------------------------- | | `CN` | `market` | 上证指数 + 深证成指 | 沪深两市大市成交额 | | `HK` | `market` | 恒生指数 | 港交所口径的大市成交额，含窝轮/牛熊证等结构性产品 | | `US` | `industry_sectors` | 全部行业板块合计 | 美股无全市场综合指数，故采用板块合计，不含 ETF 与无行业归类标的 | > \[!TIP] 需要严格跨市场对比时，请统一改用 `sector_turnover`（所有市场都是同一套板块合计口径），并注意该口径不含 ETF、权证/牛熊证及无行业归类的标的。 > \[!WARNING] A 股统计口径为**沪深两市**，暂不含北交所，因此家数与成交额会略低于包含北交所的统计。 **与昨日对比** * 盘中判断缩量请用 `vs_prev_same_time`（与昨日同一时刻的累计值比）。用 `vs_prev_close` 与昨日全天比，盘中会一直显示「缩量」。 * 「同一时刻」允许 ±15 分钟的采样偏差，实际匹配到的时刻由 `prev.same_time_minute` 给出。 **字段何时为空**（本接口只有这两处会出现 `null`）： | 情况 | 表现 | 说明 | | ------------- | ----------------------------------------------------------- | ------------------------------------------------ | | 刚开通、历史不足一个交易日 | `compare_status` 为 `warming_up`，`prev` 与 `compare` 为 `null` | 对比基准由服务按交易日累积，**次一交易日起自动转为 `ready`** | | 昨日该时刻附近没有采样点 | `prev.same_time` 与 `compare.vs_prev_same_time` 为 `null` | 此时请改用 `vs_prev_close`。我们不会用更早时段的数据顶替，以免得出错误的缩量结论 | *** ### 全球指数 获取全球主要指数列表。 **接口地址** * 基本路径：`/common/v2/basic/market/indexes` * 完整路径：`https://data.infoway.io/common/v2/basic/market/indexes` **返回示例** ```json { "data": { "indexes": [ {"counter_id": "IX/US/.DJI", "name": "道琼斯", "market": "US"}, {"counter_id": "IX/US/.IXIC", "name": "纳斯达克", "market": "US"}, {"counter_id": "IX/US/.SPX", "name": "标普 500", "market": "US"}, {"counter_id": "IX/HK/HSI", "name": "恒生指数", "market": "HK"}, {"counter_id": "IX/HK/HSTECH", "name": "恒生科技", "market": "HK"}, {"counter_id": "IX/SH/000001", "name": "上证指数", "market": "CN"}, {"counter_id": "IX/SZ/399001", "name": "深证成指", "market": "CN"}, {"counter_id": "IX/SZ/399006", "name": "创业板指", "market": "CN"} ] } } ``` | 字段名 | 类型 | 描述 | | ------------ | ------ | ---- | | `counter_id` | String | 指数ID | | `name` | String | 指数名称 | | `market` | String | 所属市场 | *** ### 领涨行业 获取当日领涨行业及龙头股。 **接口地址** * 基本路径：`/common/v2/basic/market/leaders/{market}` * 完整路径：`https://data.infoway.io/common/v2/basic/market/leaders/{market}` **路径参数** | 参数名 | 类型 | 必填 | 描述 | 示例值 | | -------- | ------ | -- | ---- | ---- | | `market` | String | 是 | 市场代码 | `HK` | **Request param入参说明** | 参数名 | 类型 | 必填 | 描述 | 示例值 | | ------- | ------- | -- | --------------- | ---- | | `limit` | Integer | 否 | 返回行业数，1-50，默认10 | `10` | **返回示例** ```json { "market": "HK", "data": { "lists": [ { "counter_id": "BK/HK/IN20351", "name": "保险经纪公司", "chg": "0.1535", "leading_name": "众淼控股", "leading_last_done": "40.400", "leading_chg": "0.1717", "rise_num": 2, "fall_num": 0 } ] } } ``` | 字段名 | 类型 | 描述 | | ------------------- | ------- | ------ | | `counter_id` | String | 行业板块ID | | `name` | String | 行业名称 | | `chg` | String | 行业涨跌幅 | | `leading_name` | String | 龙头股名称 | | `leading_last_done` | String | 龙头股最新价 | | `leading_chg` | String | 龙头股涨跌幅 | | `rise_num` | Integer | 上涨家数 | | `fall_num` | Integer | 下跌家数 | *** ### 大盘综述 获取该市场当日的大盘点评（由上游根据当日行情自动生成的一段文字），可直接用于首页市场快讯位。 **接口地址** * 基本路径：`/common/v2/basic/market/overview/{market}` * 完整路径：`https://data.infoway.io/common/v2/basic/market/overview/{market}` **路径参数** | 参数名 | 类型 | 必填 | 描述 | 示例值 | | -------- | ------ | -- | ---- | ---- | | `market` | String | 是 | 市场代码 | `CN` | **返回示例** ```json { "market": "CN", "overview": "沪指低开后小幅收涨 0.2%，创业板指跌 1%，但市场宽度强劲，超 4200 只个股上涨。碳酸锂期货受矿山复产担忧影响暴跌约 6%，拖累电池权重股压制成长指数，农业与医药板块领涨。" } ``` | 字段名 | 类型 | 描述 | | ---------- | ------ | ------------------------------------ | | `market` | String | 市场代码 | | `overview` | String | 大盘综述文字，随 `lang` 参数返回中文或英文；暂无数据时为空字符串 | *** ### 榜单目录 列出该市场支持哪些榜单（涨跌幅榜、热度榜、盘前盘后榜等）以及每个榜单可用于排序的指标。建议在调用榜单数据接口前先调用本接口获取合法的 `key` 与 `sort` 取值。 **接口地址** * 基本路径：`/common/v2/basic/market/rank/categories/{market}` * 完整路径：`https://data.infoway.io/common/v2/basic/market/rank/categories/{market}` **路径参数** | 参数名 | 类型 | 必填 | 描述 | 示例值 | | -------- | ------ | -- | ---- | ---- | | `market` | String | 是 | 市场代码 | `CN` | **返回示例** ```json { "market": "CN", "count": 7, "data": [ { "key": "all", "name": "全部", "type": "ST", "indicators": [ { "key": "last_done", "name": "最新价" }, { "key": "chg", "name": "涨跌幅" }, { "key": "total_balance", "name": "成交额" } ] } ] } ``` | 字段名 | 类型 | 描述 | | ------------ | ------ | --------------------------------------- | | `key` | String | 榜单标识，用于榜单数据接口的 `key` 路径参数 | | `name` | String | 榜单名称 | | `type` | String | 榜单标的类型，`ST`=个股，`BK`=板块 | | `indicators` | Array | 该榜单支持的排序指标，其 `key` 可用作榜单数据接口的 `sort` 参数 | > \[!NOTE] 上面示例中的 `indicators` 为节选。个股类榜单实际有 20 多个可排序指标（`five_min_chg` 五分钟涨跌幅、`turnover_rate` 换手率、`amplitude` 振幅、`volume_rate` 量比、`pb_ttm`、`market_cap`、`five_day_chg`、`this_year_chg` 等）。板块类榜单（`type=BK`）指标集不同且更短，含 `rise` / `fall`（成分股上涨/下跌家数）。美股 `us_pre` / `us_post` / `us_overnight` 三个榜单另有专属指标（`pre_chg`、`post_chg`、`uson_chg` 等），按盘前/盘后/夜盘涨跌幅排序时请用这些指标，而不是 `chg`。 各市场当前支持的榜单（可能随上游调整，请以本接口实际返回为准）： | 市场 | 榜单 | | ---- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `CN` | `all` 全部、`cn_connect` A股通、`cn_gem` 创业板、`cn_star` 科创板、`heat_discuss` 热议、`heat_watchlist` 关注度、`bk_industry` 行业板块 | | `HK` | `all` 全部、`hk_main` 主板、`hk_gem` 创业板、`hk_ipo` 新股榜、`hk_etf` 港股ETF、`heat_trade` 热门交易、`heat_discuss` 热议、`heat_watchlist` 关注度、`bk_industry` 行业板块、`bk_concept` 概念板块 | | `US` | `all` 全部、`us_concept` 中概股、`us_popular` 明星股、`us_etf` 美股ETF、`us_ipo` 新股榜、`heat_trade` 热门交易、`heat_discuss` 热议、`heat_watchlist` 关注度、`us_pre` 盘前、`us_post` 盘后、`us_overnight` 夜盘、`bk_industry` 行业板块、`bk_concept` 概念板块 | *** ### 榜单数据（涨幅榜/跌幅榜/热度榜） 按指定指标排序返回榜单成分。**涨幅榜 = `sort=chg&order=desc`，跌幅榜 = `sort=chg&order=asc`，成交额榜 = `sort=total_balance&order=desc`。** **接口地址** * 基本路径：`/common/v2/basic/market/rank/{market}/{key}` * 完整路径：`https://data.infoway.io/common/v2/basic/market/rank/{market}/{key}` **路径参数** | 参数名 | 类型 | 必填 | 描述 | 示例值 | | -------- | ------ | -- | ---------------- | ----- | | `market` | String | 是 | 市场代码 | `CN` | | `key` | String | 是 | 榜单标识，取值见「榜单目录」接口 | `all` | **Request param入参说明** | 参数名 | 类型 | 必填 | 描述 | 示例值 | | -------- | ------- | -- | ----------------------------------------- | ------ | | `sort` | String | 否 | 排序指标，须为该榜单 `indicators` 中的 `key`，默认 `chg` | `chg` | | `order` | String | 否 | `desc` 降序（涨幅榜）/ `asc` 升序（跌幅榜），默认 `desc` | `desc` | | `limit` | Integer | 否 | 返回条数，1-100，默认30 | `30` | | `offset` | Integer | 否 | 偏移量，用于翻页，默认0 | `0` | **返回示例** ```json { "market": "CN", "key": "all", "name": "全部", "sort": "chg", "order": "desc", "offset": 0, "limit": 1, "total": 7377, "count": 1, "as_of": "2026-08-27T15:37:46+08:00", "data": [ { "symbol": "300097.SZ", "counter_id": "ST/SZ/300097", "name": "智云股份", "delay": false, "indicators": { "last_done": "10.54", "chg": "0.2005", "change": "1.76", "total_amount": "43060000", "total_balance": "453799962" } } ] } ``` | 字段名 | 类型 | 描述 | | ------------ | ------- | ------------------------------- | | `total` | Integer | 该榜单符合条件的标的总数（用于翻页） | | `count` | Integer | 本次返回条数 | | `as_of` | String | 数据快照时间（ISO 8601，东八区），可据此判断行情新鲜度 | | `symbol` | String | 标的代码 | | `counter_id` | String | 标的内部ID | | `name` | String | 标的名称 | | `delay` | Boolean | 该行情是否为延迟数据 | | `indicators` | Object | 指标值，键为「榜单目录」中返回的指标 `key` | > \[!WARNING] 注意：1) `chg`、`turnover_rate`、`amplitude`、`five_day_chg` 等比率型字段为**小数比率**而非百分数，`0.2005` 表示 +20.05%，`-0.1998` 表示 -19.98%；2) 上面示例的 `indicators` 为节选，实际返回该榜单 `indicators` 中的全部指标（个股榜单通常 20 多个），并非只有 `sort` 指定的那一个；3) 某个指标在该标的上暂无数据时返回空字符串 `""`（例如新股的 `five_day_chg`），请做好空值处理；4) `industry` 返回的是行业名称文本，随 `lang` 参数切换语言。 **错误码** | HTTP | detail | 说明 | | ---- | --------------------------------------------- | ---------------------- | | 400 | `Invalid market` | 市场代码不合法 | | 400 | `Invalid key for market {market}. Valid: ...` | 榜单标识不合法，响应中会列出该市场的合法取值 | | 400 | `Invalid sort for key {key}. Valid: ...` | 排序指标不属于该榜单，响应中会列出合法取值 | | 400 | `Invalid order, must be desc or asc` | 排序方向不合法 | ***