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
Mode Example Description 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
Parameter Type Required Default Description keywordstring Either keyword or symbol - Search keyword (code or name) symbolstring Either keyword or symbol - Stock code, 6 digits datestring No - Trading date (YYYY-MM-DD) daysint No - Last N trading days (1-500) includestring No - Extra data: technicals indicatorsstring No ma,macd,rsiTechnical indicator types limitint No 10 Results limit for search mode (1-50)
Request Examples
Search
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
Field Description symbolStock code nameStock name marketMarket (sh/sz/bj) is_activeActively trading
Quote Mode
Field Description 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)
Field Description maMoving averages (ma5/ma10/ma20/ma60/ma120/ma250) macdMACD (dif/dea/histogram) rsiRSI (rsi6/rsi12/rsi24)
Pricing
Mode Billing Type Price Search/Quote/History stock $0.01/call With technicals stock_analysis $0.02/call
First 500 calls/month are free.