AShareHub API Documentation

AShareHub provides RESTful API access to Chinese A-Share market data through 38 endpoints, covering all listed A-shares on the Shanghai and Shenzhen exchanges. Our API delivers daily OHLCV prices, fundamental indicators, northbound capital flows, money flow by order size, chip distribution, margin trading, block trades, shareholder data, concept/theme sectors, FX rates, index data, industry classifications, and financial statements.

Quick Start

curl -H "X-API-Key: ash_your_key_here" \
  "https://asharehub.com/v1/market/daily?ts_code=000001.SZ&limit=5"

pip install asharehub

from asharehub import AShareHub
client = AShareHub(api_key="ash_your_key_here")
df = client.market_daily(ts_code="000001.SZ", limit=5)
print(df)

Authentication

All data API endpoints require an API key passed via the X-API-Key header.

curl -H "X-API-Key: ash_your_key_here" https://asharehub.com/v1/market/daily

Rate Limits

Requests are limited per API key on a daily basis. When exceeded, the API returns 429 Too Many Requests.

Real-time Quote

Latest intraday quote snapshot — one row per security, continuously refreshed during trading hours. Outside trading hours, returns the last session's closing snapshot.

Parameters

Response Fields

curl -H "X-API-Key: YOUR_KEY" \
  "https://asharehub.com/v1/market/realtime?ts_code=600519.SH,000001.SZ"

News Flash

Real-time Chinese financial news flashes. source is required — each source is a separate feed (they report the same events independently, so query one at a time). Content is Chinese.

Parameters

Response Fields

curl -H "X-API-Key: YOUR_KEY" \
  "https://asharehub.com/v1/news/flash?source=cls&importance=1&limit=10"

Market Daily

Daily OHLCV price data for A-share stocks.

Parameters

Response Fields

curl -H "X-API-Key: YOUR_KEY" \
  "https://asharehub.com/v1/market/daily?ts_code=000001.SZ&start_date=2024-01-01&end_date=2024-01-31&limit=5"

Fundamentals

Daily fundamental indicators including PE, PB, turnover rate, market cap, etc.

Parameters

Same as Market Daily: ts_code, start_date, end_date, limit, offset

Key Response Fields

Margin Trading

Daily margin trading and short selling data per stock.

Parameters

Response Fields

curl -H "X-API-Key: YOUR_KEY" \
  "https://asharehub.com/v1/market/margin?ts_code=000001.SZ&start_date=2024-01-01&limit=5"

Block Trade

Block (large-lot) trade records for A-share stocks.

Parameters

Response Fields

curl -H "X-API-Key: YOUR_KEY" \
  "https://asharehub.com/v1/market/block-trade?ts_code=000001.SZ&start_date=2024-01-01&limit=5"

Top List

Dragon & Tiger list — stocks triggering exchange disclosure rules.

Parameters

Response Fields

curl -H "X-API-Key: YOUR_KEY" \
  "https://asharehub.com/v1/market/top-list?start_date=2024-01-01&end_date=2024-01-31&limit=5"

Top Inst

Per-seat institutional breakdown of Dragon & Tiger list buying/selling. Unlike the aggregated top list, this shows which specific brokerage branch (e.g. "中信建投上海溧阳路") was trading — widely used for hot-money tracking.

Same parameters as Market Daily (ts_code, start_date, end_date, limit, offset).

Response Fields

Shareholders

Quarterly shareholder count. Declining count suggests chip concentration.

Parameters

Response Fields

curl -H "X-API-Key: YOUR_KEY" \
  "https://asharehub.com/v1/market/shareholders?ts_code=000001.SZ&limit=5"

Holder Trade

Major shareholder and executive trades.

Parameters

Response Fields

curl -H "X-API-Key: YOUR_KEY" \
  "https://asharehub.com/v1/market/holder-trade?ts_code=000001.SZ&limit=5"

Concepts

Concept/theme sector indices (AI, new energy, semiconductors, etc.).

Parameters

Response Fields

curl -H "X-API-Key: YOUR_KEY" \
  "https://asharehub.com/v1/market/concepts?start_date=2024-01-01&end_date=2024-01-31&limit=5"

Concept Members

Constituent stocks of concept/theme indices.

Parameters

Response Fields

curl -H "X-API-Key: YOUR_KEY" \
  "https://asharehub.com/v1/market/concept-members?ts_code=BK0425.DC&limit=10"

Adjustment Factor

Daily adjustment factors for calculating forward/backward adjusted prices. Essential for accurate historical price analysis across splits and dividends.

Parameters

ts_code, start_date, end_date, limit (max 5000), offset

Response Fields

curl -H "X-API-Key: YOUR_KEY" \
  "https://asharehub.com/v1/market/adj-factor?ts_code=000001.SZ&start_date=2024-01-01&limit=5"

Technical Factors

Daily technical indicators (MACD, KDJ, RSI, Bollinger Bands, CCI) and forward/backward adjusted prices.

Parameters

ts_code, start_date, end_date, limit (max 5000), offset

Key Response Fields

curl -H "X-API-Key: YOUR_KEY" \
  "https://asharehub.com/v1/market/technical-factors?ts_code=000001.SZ&start_date=2024-01-01&limit=5"

Technical Factors Pro

Professional-grade technical indicators — 200+ columns per row. Beyond MACD/KDJ/RSI/BOLL/CCI, includes MA, EMA, DMI, ATR, OBV, TRIX, MFI, BBI, BIAS, BRAR, CR, ROC, PSY, WR, ASI and more. Every indicator ships in unadjusted (_bfq), forward-adjusted (_qfq) and backward-adjusted (_hfq) variants.

Parameters

ts_code, start_date, end_date, limit (max 5000), offset

Key Response Fields

curl -H "X-API-Key: YOUR_KEY" \
  "https://asharehub.com/v1/market/technical-factors-pro?ts_code=000001.SZ&limit=1"

Limit List

Daily limit-up and limit-down stocks. A-share stocks have ±10% (±20% for ChiNext/STAR) daily price limits.

Parameters

ts_code, start_date, end_date, limit_type (U=up, D=down, Z=broken), limit (max 5000), offset

Key Response Fields

curl -H "X-API-Key: YOUR_KEY" \
  "https://asharehub.com/v1/market/limit-list?limit_type=U&start_date=2024-03-01&limit=10"

Northbound Capital Flows

Daily northbound capital flows via Stock Connect (Shanghai & Shenzhen). A key indicator of foreign investor sentiment toward A-shares.

Parameters

Response Fields

curl -H "X-API-Key: YOUR_KEY" \
  "https://asharehub.com/v1/flows/moneyflow-hsgt?start_date=2024-01-01&end_date=2024-01-31"

Money Flow

Individual stock money flow by order size.

Parameters

Key Response Fields

curl -H "X-API-Key: YOUR_KEY" \
  "https://asharehub.com/v1/flows/moneyflow?ts_code=000001.SZ&start_date=2024-01-01&limit=5"

Northbound Holdings

Northbound (foreign) investor holdings per stock.

Parameters

Response Fields

curl -H "X-API-Key: YOUR_KEY" \
  "https://asharehub.com/v1/flows/northbound-holdings?ts_code=000001.SZ&start_date=2024-01-01&limit=5"

Southbound Holdings

Mainland-held HK stocks via Stock Connect — the mirror of Northbound Holdings. Tracks how much of each HK-listed stock (e.g. Tencent, Meituan, HK-listed Chinese banks) is held by mainland investors, useful for A/H premium signals.

Same parameters as Market Daily (ts_code is an HK code, start_date, end_date, limit, offset).

Response Fields

Financial Indicators

Quarterly financial indicators including ROE, margins, EPS, and 50+ metrics per company.

Parameters

Key Response Fields

curl -H "X-API-Key: YOUR_KEY" \
  "https://asharehub.com/v1/financials/indicators?ts_code=000001.SZ&limit=4"

Income Statement

Quarterly/annual income statement data. All monetary values in CNY.

Parameters

ts_code, start_date, end_date (report period), limit (max 200), offset

Key Response Fields

curl -H "X-API-Key: YOUR_KEY" \
  "https://asharehub.com/v1/financials/income?ts_code=000001.SZ&start_date=2023-01-01&limit=4"

Balance Sheet

Quarterly/annual balance sheet data. All monetary values in CNY.

Parameters

ts_code, start_date, end_date (report period), limit (max 200), offset

Key Response Fields

curl -H "X-API-Key: YOUR_KEY" \
  "https://asharehub.com/v1/financials/balance-sheet?ts_code=000001.SZ&limit=4"

Cash Flow Statement

Quarterly/annual cash flow statement. Three sections: operating, investing, and financing activities.

Parameters

ts_code, start_date, end_date (report period), limit (max 200), offset

Key Response Fields

curl -H "X-API-Key: YOUR_KEY" \
  "https://asharehub.com/v1/financials/cash-flow?ts_code=600519.SH&limit=4"

Earnings Forecast

Earnings forecasts (业绩预告) — early profit guidance disclosures required by exchange rules. Types include significant increase, decrease, turnaround, first loss, etc.

Parameters

ts_code, start_date, end_date (announcement date), limit (max 1000), offset

Key Response Fields

curl -H "X-API-Key: YOUR_KEY" \
  "https://asharehub.com/v1/financials/forecast?ts_code=000001.SZ&limit=5"

Earnings Express

Preliminary earnings flash reports (业绩快报) released before formal financial statements.

Parameters

ts_code, start_date, end_date (announcement date), limit (max 1000), offset

Key Response Fields

curl -H "X-API-Key: YOUR_KEY" \
  "https://asharehub.com/v1/financials/express?ts_code=000001.SZ&limit=5"

Audit Opinions

Annual report audit results — opinion type (unqualified / qualified / disclaimer, etc.), audit firm, signing auditors and audit fees. Annual data only.

Parameters

ts_code, start_date, end_date (report period), limit (max 1000), offset

Key Response Fields

Main Business

Main business composition — revenue, cost and profit broken down by product/region segment, to understand what drives a company's business. Disclosed in semi-annual and annual reports.

Parameters

ts_code, start_date, end_date (report period), limit (max 2000), offset

Key Response Fields

Disclosure Date

Financial report disclosure schedule — planned vs. actual disclosure dates per company, useful for scheduling earnings tracking ahead of time.

Parameters

ts_code, start_date, end_date (report period), limit (max 2000), offset

Key Response Fields

Analyst Reports

Sell-side analyst reports and earnings forecasts — report title, brokerage, rating (buy / overweight / neutral / sell), target price, and revenue / net profit / EPS forecasts.

Parameters

ts_code, start_date, end_date (report date), limit (max 3000), offset

Key Response Fields

Dividend

Cash and stock dividend distribution data. Includes ex-dividend dates, record dates, and payment dates.

Parameters

ts_code, start_date, end_date (announcement date), limit (max 1000), offset

Key Response Fields

curl -H "X-API-Key: YOUR_KEY" \
  "https://asharehub.com/v1/shareholders/dividend?ts_code=600519.SH&limit=10"

Index Daily

Daily OHLCV data for major Chinese market indices.

Parameters

Common Index Codes

curl -H "X-API-Key: YOUR_KEY" \
  "https://asharehub.com/v1/indices/daily?ts_code=000300.SH&start_date=2024-01-01&limit=10"

Index Weight

Constituent stock weights for major indices. Useful for tracking index rebalancing and passive fund flows.

Parameters

index_code (e.g. 399300.SZ), start_date, end_date, limit (max 5000), offset

Response Fields

curl -H "X-API-Key: YOUR_KEY" \
  "https://asharehub.com/v1/indices/index-weight?index_code=399300.SZ&limit=10"

Chip Distribution

Cost distribution and winner rates — unique A-share market microstructure data showing the percentage of shareholders in profit at various price levels.

Parameters

Response Fields

FX Rates

Daily foreign exchange rates with bid/ask prices. Default pair is USD/CNH — essential for cross-border portfolio valuation.

Parameters

Response Fields

curl -H "X-API-Key: YOUR_KEY" \
  "https://asharehub.com/v1/fx/daily?start_date=2024-01-01&end_date=2024-01-31&limit=5"

Stock List

A-share stock list with basic reference info.

Parameters

Response Fields

curl -H "X-API-Key: YOUR_KEY" \
  "https://asharehub.com/v1/reference/stocks?limit=10"

Industries

Shenwan 3-level industry classification (SW2021).

Parameters

Response Fields

curl -H "X-API-Key: YOUR_KEY" \
  "https://asharehub.com/v1/reference/industries?ts_code=000001.SZ"

Trade Calendar

Trading calendar for Shanghai (SSE) and Shenzhen (SZSE) exchanges. Useful for scheduling data pulls and handling holidays.

Parameters

exchange (SSE/SZSE), start_date, end_date, is_open (1=trading days, 0=closed), limit (max 5000), offset

Response Fields

curl -H "X-API-Key: YOUR_KEY" \
  "https://asharehub.com/v1/reference/trade-calendar?exchange=SSE&is_open=1&start_date=2024-01-01&limit=20"

Python SDK

The official Python SDK wraps all API endpoints and returns pandas DataFrames.

Installation

pip install asharehub

Requires Python 3.8+. Dependencies: httpx, pydantic.

SDK Usage Examples

from asharehub import AShareHub
client = AShareHub(api_key="ash_your_key_here")

df = client.market_daily(ts_code="000001.SZ", start_date="2024-01-01", end_date="2024-03-31")
print(df.head())

flows = client.moneyflow_hsgt(start_date="2024-01-01", end_date="2024-01-31")
print(flows[["trade_date", "north_money"]].head())

fina = client.financial_indicators(ts_code="000001.SZ")
print(fina[["end_date", "roe", "grossprofit_margin", "eps"]].head())

MCP — Cloud Hosted

AShareHub provides a cloud-hosted Model Context Protocol server. No local installation required — just point your MCP client to our endpoint.

Connection URL

Client Configuration

{
  "mcpServers": {
    "asharehub": {
      "url": "https://asharehub.com/mcp/sse?api_key=ash_your_key"
    }
  }
}

{
  "mcpServers": {
    "asharehub": {
      "url": "https://asharehub.com/mcp/sse?api_key=ash_your_key"
    }
  }
}

{
  "mcpServers": {
    "asharehub": {
      "serverUrl": "https://asharehub.com/mcp/sse?api_key=ash_your_key"
    }
  }
}

MCP — Available Tools (38)

All 37 API endpoints are available as MCP tools. Each tool returns JSON data.