市场数据 API | GroundAPI

概览

GET /v1/finance/market 提供 A 股市场级数据。通过 scope 选择一种或多种视图（英文逗号分隔）；在板块维度下可用 sector 下钻到具体行业或概念的成分股列表。

什么时候用我

按使用意图选择 scope：

用户问什么	scope	返回什么
"今天大盘怎么样"、"市场情绪"	`overview`（默认）	5 大指数行情 + 涨跌停统计
"今天涨停了哪些股"、"什么强势股"	`hot`	涨停/跌停/强势/炸板/次新股池
"板块涨跌"、"哪个板块最强"	`sectors`	板块/概念排行
"AI 概念里都有谁"、"半导体成分股"	`sectors`+`sector=AI`	该板块下钻成分股
"新股日历"、"打新机会"	`ipo`	即将上市的新股
"今天最强的股"、"连板梯队"	`signals`	多连板/大涨幅异动股

组合使用：scope=overview,hot,signals 一次拉取多维数据，适合做"每日市场简报"。

请求参数

参数	类型	必填	默认值	说明
`scope`	string	否	`overview`	数据范围，逗号分隔，见下表
`sector`	string	否	-	板块/概念名称或代码，在 `scope` 含 `sectors` 且需下钻时传入
`date`	string	否	当日	交易日（`YYYY-MM-DD`），用于涨跌停池、异动等与日期相关的数据
`limit`	int	否	`20`	各列表类结果的单类条数上限（1–100）

文档表格中的查询串里 & 写作 &；复制到 curl 时请改为 &。

场景	查询示例
多 scope	`?scope=overview,hot&limit=30`
板块下钻	`?scope=sectors&sector=半导体`

数据范围（scope）

取值	说明
`overview`	主要指数最新行情、涨跌停家数与情绪相关统计
`hot`	涨停、跌停、强势、炸板、次新等股池及连板分层
`sectors`	不传 `sector` 时返回行业/热门概念等排行树摘要；传 `sector` 时返回该板块成分股
`ipo`	新股日历与待发、已发新股列表
`signals`	异动信号摘要，如连板高度、大幅拉升强势股等

请求示例

市场概览（默认）

curl -H "X-API-Key: sk_gapi_xxxxx" \
  "https://api.groundapi.net/v1/finance/market"

概览 + 热门股池

curl -H "X-API-Key: sk_gapi_xxxxx" \
  "https://api.groundapi.net/v1/finance/market?scope=overview,hot&limit=30"

板块列表（不传 sector）

curl -H "X-API-Key: sk_gapi_xxxxx" \
  "https://api.groundapi.net/v1/finance/market?scope=sectors"

板块下钻

curl -H "X-API-Key: sk_gapi_xxxxx" \
  "https://api.groundapi.net/v1/finance/market?scope=sectors&sector=半导体"

新股日历

curl -H "X-API-Key: sk_gapi_xxxxx" \
  "https://api.groundapi.net/v1/finance/market?scope=ipo&limit=50"

异动信号

curl -H "X-API-Key: sk_gapi_xxxxx" \
  "https://api.groundapi.net/v1/finance/market?scope=signals&date=2026-04-09&limit=20"

一次拉齐多类数据

curl -H "X-API-Key: sk_gapi_xxxxx" \
  "https://api.groundapi.net/v1/finance/market?scope=overview,hot,sectors,ipo,signals&limit=15"

返回示例

overview + hot（节选）

{
  "success": true,
  "data": {
    "overview": {
      "indices": [
        {
          "code": "000001.SH",
          "name": "上证指数",
          "price": 3050.12,
          "change": 12.34,
          "change_pct": 0.41,
          "volume": 412000000,
          "turnover": 528000000000
        }
      ],
      "sentiment": {
        "limit_up_count": 48,
        "failed_limit_count": 12,
        "seal_success_rate": 80.0,
        "max_streak": 5
      }
    },
    "hot": {
      "limit_up": [],
      "limit_down": [],
      "strong": [],
      "failed_limit": [],
      "sub_new": [],
      "streak_tiers": { "1": 20, "2": 8 },
      "stats": {
        "limit_up_total": 48,
        "limit_down_total": 15,
        "strong_total": 32,
        "failed_limit_total": 12
      }
    }
  }
}

sectors 下钻成功

{
  "success": true,
  "data": {
    "sector_detail": {
      "sector": "半导体",
      "code": "881121",
      "found": true,
      "stock_count": 120,
      "stocks": [
        { "dm": "688981", "mc": "中芯国际", "zf": 2.1 }
      ]
    }
  }
}

ipo（节选）

{
  "success": true,
  "data": {
    "ipo": {
      "count": 8,
      "items": []
    }
  }
}

定价

$0.02/次。每月前 500 次免费。