DocumentationStock Data API

Stock Data API

Unified A-share stock endpoint: search, quotes, history, technicals — all in one

Overview

GET /v1/finance/stock is the unified entry point for stock data. Different parameter combinations support search, real-time quotes, historical data, and technical indicators.

Usage Modes

ModeExampleDescription
Search?keyword=茅台Search stocks by name or code
Latest quote?symbol=600519Latest trading day data
Specific date?symbol=600519&date=2026-03-28Data for a specific date
History?symbol=600519&days=60Last N trading days
With technicals?symbol=600519&days=60&include=technicalsHistory + MA/MACD/RSI

Request Parameters

ParameterTypeRequiredDefaultDescription
keywordstringEither keyword or symbol-Search keyword (code or name)
symbolstringEither keyword or symbol-Stock code, 6 digits
datestringNo-Trading date (YYYY-MM-DD)
daysintNo-Last N trading days (1-500)
includestringNo-Extra data: technicals
indicatorsstringNoma,macd,rsiTechnical indicator types
limitintNo10Results limit for search mode (1-50)

Request Examples

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

Latest Quote

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

History with Technicals

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

Response Fields

Search Mode

FieldDescription
symbolStock code
nameStock name
marketMarket (sh/sz/bj)
is_activeActively trading

Quote Mode

FieldDescription
symbolStock code
nameStock name
priceLatest closing price (CNY)
change_pctChange percentage (%)
volumeVolume (lots)
turnoverTurnover (CNY)
high / low / openHigh/Low/Open price
prev_closePrevious close
turnover_rateTurnover rate (%)
trade_dateTrading date

Technicals (include=technicals)

FieldDescription
maMoving averages (ma5/ma10/ma20/ma60/ma120/ma250)
macdMACD (dif/dea/histogram)
rsiRSI (rsi6/rsi12/rsi24)

Pricing

ModeBilling TypePrice
Search/Quote/Historystock$0.01/call
With technicalsstock_analysis$0.02/call

First 500 calls/month are free.

Updated 6 days ago
Did this page help you?