证券数据 API | GroundAPI

概览

GET /v1/finance/stock 是证券数据的统一入口，支持 A 股个股、指数（如 000001.SH）、ETF（如 510300.SH）。通过 symbol 与 aspects 组合可拉取多维度数据；symbol 支持英文逗号分隔的 多标的对比（最多 10 只）；亦可通过 keyword 在股票维度内搜索。

什么时候用我

按使用意图选择 aspects（按从最常用到最专业排序）：

用户问什么	aspects	说明
"XXX 怎么样"、"看一下茅台"	`overview`（默认）	一站式快照：行情 + 简介 + 财务摘要
"现在多少钱"、"PE 多少"	`quote`	仅最新行情数据
"走势图"、"K 线"	`quote,kline`	行情 + 历史 K 线
"技术面"、"MACD/均线"	`quote,kline,technical`	+ 技术指标 + 信号检测
"财报"、"营收利润"	`financial`	完整三大报表 + 行业对比
"十大股东"、"机构持仓"	`holders`	股东数据
"管理层"	`management`	高管/董事/监事
"分红"、"解禁"、"业绩预告"	`events`	公司事件日历
"在行业里排第几"、"同行对比"	`peers`	同行业排名
"全面分析"	`summary`	多维事实聚合（不含主观结论）

搜索模式（不知道代码时）：用 keyword 而不是 symbol，如 ?keyword=茅台。

多股对比：symbol=600519,000858,601398 用逗号分隔，最多 10 只。

请求参数

参数	类型	必填	默认值	说明
`keyword`	string	与 `symbol` 二选一	-	按名称或代码搜索股票（搜索模式下仅返回股票列表）
`symbol`	string	与 `keyword` 二选一	-	证券代码；支持 `600519`、`000001.SH`、`510300.SH` 等；多标的用逗号分隔，如 `600519,000858`
`aspects`	string	否	`overview`	数据维度，英文逗号分隔，见下表；仅在使用 `symbol` 时生效
`days`	int	否	`60`	回溯自然日数量，用于 `kline` / `technical` 等需要时间窗口的维度（1–500）
`period`	string	否	`d`	K 线周期：`d`（日）/ `w`（周）/ `m`（月）
`limit`	int	否	`10`	搜索模式下返回条数上限（1–50）

以下为文档内查询串示例；在 MDX 中对 & 使用 & 转义，curl 中请仍写 &。

场景	查询示例
多维度 K 线	`?symbol=600519&aspects=quote,kline&days=120&period=d`
指数概览	`?symbol=000001.SH&aspects=overview,quote`
多标的对比	`?symbol=600519,000858&aspects=overview`

数据维度（aspects）

维度	说明
`overview`	默认组合：最新行情摘要、公司/标的简介要点、财务摘要
`profile`	公司全称、上市信息、股本结构、概念与指数归属等完整档案
`quote`	最新收盘行情快照（价格、PE/PB、市值、换手率等）
`kline`	历史 K 线（由 `days`、`period` 控制范围与周期）
`technical`	技术指标：MACD/MA/BOLL/KDJ，基于历史 K 线本地计算，含信号检测
`financial`	财务报表与关键财务指标
`holders`	十大股东、十大流通股东、股东户数变化趋势、基金持仓
`management`	董监高及管理层信息
`events`	公告、重大事项等公司事件
`summary`	多源摘要：行情 + 技术 + 财务要点 + 持股概览
`peers`	同行业或可比标的列表

请求示例

搜索股票

curl -H "X-API-Key: sk_gapi_xxxxx" \
  "https://api.groundapi.net/v1/finance/stock?keyword=茅台&limit=5"

默认概览（overview）

curl -H "X-API-Key: sk_gapi_xxxxx" \
  "https://api.groundapi.net/v1/finance/stock?symbol=600519"

多维度组合

curl -H "X-API-Key: sk_gapi_xxxxx" \
  "https://api.groundapi.net/v1/finance/stock?symbol=600519&aspects=quote,kline,technical&days=120&period=d"

指数

curl -H "X-API-Key: sk_gapi_xxxxx" \
  "https://api.groundapi.net/v1/finance/stock?symbol=000001.SH&aspects=overview,quote"

ETF

curl -H "X-API-Key: sk_gapi_xxxxx" \
  "https://api.groundapi.net/v1/finance/stock?symbol=510300.SH&aspects=overview,kline&days=90&period=d"

多标的对比

curl -H "X-API-Key: sk_gapi_xxxxx" \
  "https://api.groundapi.net/v1/finance/stock?symbol=600519,000858,000001.SH&aspects=overview"

返回示例

搜索模式（[object Object]）

响应中 data 为股票对象数组（字段以实际数据源为准，常见包含代码、名称、市场等）。

{
  "success": true,
  "data": [
    {
      "dm": "600519",
      "mc": "贵州茅台",
      "jys": "sh"
    }
  ]
}

单标的 · overview（[object Object] + 默认 [object Object]）

所有数据来自本地数据库（每日收盘后同步更新），不提供盘中实时数据。

{
  "success": true,
  "data": {
    "symbol": "600519",
    "type": "stock",
    "quote": {
      "price": 1443.31,
      "open": 1444.0,
      "high": 1446.5,
      "low": 1433.0,
      "prev_close": 1453.96,
      "change_pct": -0.73,
      "pe": 20.98,
      "pb": 7.03,
      "volume": 25214,
      "turnover": 3629675500,
      "turnover_rate": 0.2,
      "amplitude": 0.93,
      "total_market_cap": 1807414124012,
      "limit_up": 1606.54,
      "limit_down": 1314.44,
      "update_time": "2026-04-13",
      "market_status": "closed"
    },
    "profile_brief": {
      "industry": "食品饮料",
      "listing_date": "2001-08-27",
      "total_shares": 1252270215,
      "float_shares": 1252270215,
      "concepts": ["保险重仓", "QFII重仓", "基金重仓", "奢侈品"]
    },
    "financial_brief": {
      "report_date": "2025-09-30",
      "eps": 46.36,
      "bps": 210.76,
      "roe": 8.08,
      "revenue_yoy": 16.33,
      "profit_yoy": 15.04,
      "debt_ratio": 20.88
    }
  }
}

多标的对比

{
  "success": true,
  "data": {
    "compare": [
      {
        "symbol": "600519",
        "type": "stock",
        "quote": { "price": 1688.0, "change_pct": 1.08 }
      },
      {
        "symbol": "000858",
        "type": "stock",
        "quote": { "price": 142.5, "change_pct": -0.35 }
      }
    ],
    "count": 2
  }
}

定价

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