GET /v1/finance/market is the unified entry point for market data. Returns market overview + macro indicators by default, with optional extensions for sectors, funds, and valuation map.
Mode Example Description Market overview GET /v1/finance/marketIndices + breadth + macro With sectors ?include=sectorsAdd sector ranking With funds ?include=fundsAdd fund ranking With valuation ?include=valuationAdd industry PE/PB map All data ?include=sectors,funds,valuationEverything in one call Sector detail ?sector=半导体Specific sector with constituents Fund detail ?fund=110011Specific fund details
Parameter Type Required Default Description datestring No Latest Trading date (YYYY-MM-DD) includestring No - Extra data: sectors, funds, valuation sectorstring No - Sector name for detail view typestring No industrySector type: industry/concept fundstring No - Fund code for detail view fund_typestring No - Fund type filter (with include=funds) sort_bystring No change_pctSort field for list modes orderstring No descSort order limitint No 20 Results limit for list modes
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?include=sectors,valuation" curl -H "X-API-Key: sk_gapi_xxxxx" \ "https://api.groundapi.net/v1/finance/market?sector=半导体" Field Description trade_dateTrading date indicesMajor indices (SSE, SZSE, ChiNext, etc.) breadthBreadth stats (advancing/declining/limit up/down) breadth.sentimentMarket sentiment volume_summaryTurnover info top_sectors / bottom_sectorsTop/bottom 5 sectors macroMacro indicators (CPI/PMI/GDP/M2/LPR + treasury yields) briefNatural language market summary
Field Description nameSector name todaySector daily quote valuationPE/PB/market cap aggregate constituentsConstituent stocks (with quotes + valuation)
Field Description code / nameFund code/name navLatest NAV perf_ytd / perf_1yYTD/1-year return strategy / benchmarkStrategy/benchmark
Mode Billing Type Price Market overview (with include) market $0.02/call Sector detail (sector=) sector $0.02/call Fund detail (fund=) fund $0.01/call
First 500 calls/month are free.
