Market Data API | GroundAPI

Overview

GET /v1/finance/market aggregates A-share market snapshots in one call. Use the scope parameter (single value or comma-separated) to pull indices and sentiment, hot pools (limit-up/down and related lists), sector / concept structure (with optional drill-down), IPO calendar, and anomaly-style signal lists. Defaults target the latest trading context; pass date to anchor pools to a specific calendar day. Responses use "success": true with a data object whose keys mirror the requested scopes (e.g. overview, hot).

When to Use

Pick scope by user intent:

User asks	scope	Returns
"How's the market today?" / sentiment	`overview` (default)	5 major indices + limit-up stats
"What stocks hit limit-up?" / strong stocks	`hot`	Limit-up/down/strong/failed-limit/sub-new pools
"Sector performance" / sector rotation	`sectors`	Sector/concept rankings
"What's in AI concept?" / sector constituents	`sectors` + `sector=AI`	Drill into that sector
"IPO calendar" / new listings	`ipo`	Upcoming IPOs
"Strongest stocks today" / multi-streak	`signals`	Multi-streak limit-ups + high-gain stocks

Combine multiple: scope=overview,hot,signals for a complete daily market briefing.

Request Parameters

Parameter	Type	Required	Default	Description
`scope`	string	No	`overview`	One or more scopes, comma-separated: `overview`, `hot`, `sectors`, `ipo`, `signals` (see below).
`sector`	string	No	—	When `scope` includes `sectors`, narrows to a sector or concept drill-down (name or code fragment; case-insensitive match).
`date`	string	No	Today (server)	Trading date `YYYY-MM-DD` for pool-based scopes (`overview`, `hot`, `signals`).
`limit`	int	No	`20`	Max items per list inside each scope (1–100): e.g. cap on limit-up rows, IPO rows, signal rows.

Scopes ([object Object])

Scope	Description
`overview`	Major indices (e.g. SSE, SZSE, ChiNext, 科创50 / STAR Market, 北证50) plus breadth-style sentiment: limit-up / failed-limit counts, seal success rate, max consecutive limit-up streak among pool names.
`hot`	Limit-up, limit-down, strong, failed limit, sub-new pools (each truncated by `limit`), plus aggregate stats and limit-up streak tier histogram.
`sectors`	Without `sector`: concept/industry counts and sample industry and hot-concept nodes. With `sector`: constituent list for the matched leaf sector/concept.
`ipo`	IPO / listing calendar entries (`count` + `items`).
`signals`	Derived anomaly lists: e.g. multi-day limit-up streak names, high intraday gain names from strong pool (each capped by `limit`).

Request Examples

Default — overview only

curl -H "X-API-Key: sk_gapi_xxxxx" \
  "https://api.groundapi.net/v1/finance/market"

All scopes in one request

curl -H "X-API-Key: sk_gapi_xxxxx" \
  "https://api.groundapi.net/v1/finance/market?scope=overview,hot,sectors,ipo,signals"

Hot pools for a specific date

curl -H "X-API-Key: sk_gapi_xxxxx" \
  "https://api.groundapi.net/v1/finance/market?scope=hot&amp;date=2026-04-09&amp;limit=30"

Sector listing (no drill-down)

curl -H "X-API-Key: sk_gapi_xxxxx" \
  "https://api.groundapi.net/v1/finance/market?scope=sectors"

Sector drill-down

curl -H "X-API-Key: sk_gapi_xxxxx" \
  "https://api.groundapi.net/v1/finance/market?scope=sectors&amp;sector=半导体"

IPO calendar

curl -H "X-API-Key: sk_gapi_xxxxx" \
  "https://api.groundapi.net/v1/finance/market?scope=ipo&amp;limit=50"

Response Examples

[object Object] (excerpt)

{
  "success": true,
  "data": {
    "overview": {
      "indices": [
        {
          "code": "000001.SH",
          "name": "上证指数",
          "price": 3050.12,
          "change": 12.34,
          "change_pct": 0.41,
          "volume": 412345678,
          "turnover": 5123456789012
        }
      ],
      "sentiment": {
        "limit_up_count": 48,
        "failed_limit_count": 12,
        "seal_success_rate": 80.0,
        "max_streak": 5
      }
    }
  }
}

[object Object] (structure)

{
  "success": true,
  "data": {
    "overview": { "indices": [], "sentiment": {} },
    "hot": {
      "limit_up": [],
      "limit_down": [],
      "strong": [],
      "failed_limit": [],
      "sub_new": [],
      "streak_tiers": { "1": 20, "2": 5 },
      "stats": {
        "limit_up_total": 60,
        "limit_down_total": 8,
        "strong_total": 100,
        "failed_limit_total": 15
      }
    }
  }
}

[object Object] with [object Object] match

{
  "success": true,
  "data": {
    "sector_detail": {
      "sector": "半导体",
      "code": "885756",
      "found": true,
      "stock_count": 120,
      "stocks": []
    }
  }
}

Pricing

$0.02/call. First 500 calls/month are free.