概览
GET /v1/finance/stock 是股票数据的统一入口，通过不同的参数组合支持搜索、实时行情、历史数据和技术指标查询。
使用模式
| 模式 | 示例 | 说明 |
|---|
| 搜索 | ?keyword=茅台 | 按名称或代码搜索股票 |
| 最新行情 | ?symbol=600519 | 获取最新交易日行情 |
| 指定日期 | ?symbol=600519&date=2026-03-28 | 获取指定日期行情 |
| 历史 K 线 | ?symbol=600519&days=60 | 获取最近 N 个交易日数据 |
| 含技术指标 | ?symbol=600519&days=60&include=technicals | 历史数据 + MA/MACD/RSI |
请求参数
| 参数 | 类型 | 必填 | 默认值 | 说明 |
|---|
keyword | string | 与 symbol 二选一 | - | 搜索关键词（代码或名称） |
symbol | string | 与 keyword 二选一 | - | 股票代码，6 位数字 |
date | string | 否 | - | 指定交易日（YYYY-MM-DD），需配合 symbol |
days | int | 否 | - | 返回最近 N 个交易日历史（1-500） |
include | string | 否 | - | 附加数据：technicals |
indicators | string | 否 | ma,macd,rsi | 技术指标类型，逗号分隔 |
limit | int | 否 | 10 | 搜索模式下返回条数（1-50） |
请求示例
搜索股票
curl -H "X-API-Key: sk_gapi_xxxxx" \
"https://api.groundapi.net/v1/finance/stock?keyword=茅台"
获取最新行情
curl -H "X-API-Key: sk_gapi_xxxxx" \
"https://api.groundapi.net/v1/finance/stock?symbol=600519"
获取历史 K 线 + 技术指标
curl -H "X-API-Key: sk_gapi_xxxxx" \
"https://api.groundapi.net/v1/finance/stock?symbol=600519&days=60&include=technicals"
响应字段
搜索模式
| 字段 | 说明 |
|---|
symbol | 股票代码 |
name | 股票名称 |
market | 所属市场（sh/sz/bj） |
is_active | 是否在市交易 |
行情模式
| 字段 | 说明 |
|---|
symbol | 股票代码 |
name | 股票名称 |
price | 最新收盘价（元） |
change_pct | 涨跌幅（%） |
volume | 成交量（手） |
turnover | 成交额（元） |
high / low / open | 最高/最低/开盘价 |
prev_close | 前收盘价 |
turnover_rate | 换手率（%） |
amplitude | 振幅（%） |
trade_date | 交易日期 |
技术指标（include=technicals）
| 字段 | 说明 |
|---|
ma | 移动均线（ma5/ma10/ma20/ma60/ma120/ma250） |
macd | MACD（dif/dea/histogram） |
rsi | RSI（rsi6/rsi12/rsi24） |
计费
| 模式 | 计费类型 | 单价 |
|---|
| 搜索/行情/历史 | stock | $0.01/次 |
| 含技术指标 | stock_analysis | $0.02/次 |
每月前 500 次调用免费。
