# AShareHub

> RESTful API for Chinese A-share (Shanghai/Shenzhen) market data — daily & real-time quotes, fundamentals, money flow, chip distribution, financial statements, Dragon & Tiger lists, and more. Built for quants, fintech apps, and AI agents; English-first with bilingual docs.

- Base URL: `https://asharehub.com`  |  API prefix: `/v2` (current; v1 is frozen for back-compat)
- Auth: send header `X-API-Key: <your key>` on every request. Get a free key at https://asharehub.com/console/register (Free tier = 100 requests/day).
- Codes use `symbol` (e.g. `000001.SZ`, `600519.SH`). All responses are JSON.
- Delivery channels: REST, Python SDK (`pip install asharehub`), and an MCP server / skill for AI agents.

## Documentation
- [API Docs (English)](https://asharehub.com/en/docs): full reference — params, return fields, examples
- [API Docs (中文)](https://asharehub.com/zh/docs): 完整接口文档
- [Quickstart](https://asharehub.com/en/docs#quickstart): get a key and make your first call
- [Authentication](https://asharehub.com/en/docs#authentication): API-key header details
- [Rate Limits](https://asharehub.com/en/docs#rate-limits): per-tier daily quotas

## Python SDK
- [Install & usage](https://asharehub.com/en/docs#sdk-install): `pip install asharehub`; client defaults to v2 and returns pandas DataFrames
- [PyPI](https://pypi.org/project/asharehub/): package page

## MCP & AI Agents
- [MCP server setup](https://asharehub.com/en/docs#mcp-setup): connect Claude / Cursor / any MCP client
- [Available tools](https://asharehub.com/en/docs#mcp-tools): one MCP tool per data endpoint
- [Skill](https://asharehub.com/en/skill): drop-in skill for AI assistants

## Basic Data
- [GET /v2/reference/stocks](https://asharehub.com/en/docs#stocks): All listed A-shares: code, name, industry, listing date, status
- [GET /v2/reference/industries](https://asharehub.com/en/docs#industries): Shenwan (SW) industry classification
- [GET /v2/reference/trade-calendar](https://asharehub.com/en/docs#trade-calendar): Exchange trading calendar (is_open per date)

## Market Data
- [GET /v2/market/daily](https://asharehub.com/en/docs#market-daily): Daily OHLCV bars (unadjusted)
- [GET /v2/market/realtime](https://asharehub.com/en/docs#realtime): Real-time quote snapshot, intraday; basket up to 200 codes (sources: Tencent + Sina)
- [GET /v2/market/fundamentals](https://asharehub.com/en/docs#fundamentals): Daily valuation & size: PE/PB/PS, turnover, total/float market cap
- [GET /v2/market/adj-factor](https://asharehub.com/en/docs#adj-factor): Daily adjustment factor for forward/back-adjusted (qfq/hfq) prices
- [GET /v2/market/limit-list](https://asharehub.com/en/docs#limit-list): Daily limit-up / limit-down stocks and statistics
- [GET /v2/flows/moneyflow](https://asharehub.com/en/docs#moneyflow): Per-stock money flow by order size (small/medium/large/extra-large)
- [GET /v2/flows/moneyflow-hsgt](https://asharehub.com/en/docs#moneyflow-hsgt): Market-wide Stock Connect (north/southbound) capital flow
- [GET /v2/indices/daily](https://asharehub.com/en/docs#indices): Daily index OHLC (SSE/SZSE/CSI major indices)
- [GET /v2/indices/index-weight](https://asharehub.com/en/docs#index-weight): Index constituent weights

## Financial Data
- [GET /v2/financials/indicators](https://asharehub.com/en/docs#financials): Per-period financial indicators: ROE, margins, growth, turnover
- [GET /v2/financials/income](https://asharehub.com/en/docs#income): Income statement (whole-market by reporting period)
- [GET /v2/financials/balance-sheet](https://asharehub.com/en/docs#balance-sheet): Balance sheet
- [GET /v2/financials/cash-flow](https://asharehub.com/en/docs#cash-flow): Cash flow statement
- [GET /v2/financials/forecast](https://asharehub.com/en/docs#forecast): Earnings forecast / profit warning (pre-announcement)
- [GET /v2/financials/express](https://asharehub.com/en/docs#express): Earnings express / flash report
- [GET /v2/shareholders/dividend](https://asharehub.com/en/docs#dividend): Dividend & bonus-share distribution
- [GET /v2/financials/audit](https://asharehub.com/en/docs#audit): Annual audit opinions
- [GET /v2/financials/main-business](https://asharehub.com/en/docs#main-business): Main business composition (by product / region)
- [GET /v2/financials/disclosure-date](https://asharehub.com/en/docs#disclosure-date): Scheduled financial disclosure dates

## Market Reference Data
- [GET /v2/market/margin](https://asharehub.com/en/docs#margin): Margin trading & short-selling detail
- [GET /v2/market/block-trade](https://asharehub.com/en/docs#block-trade): Block trades (大宗交易)
- [GET /v2/market/top-list](https://asharehub.com/en/docs#top-list): Dragon & Tiger list (龙虎榜), daily
- [GET /v2/market/top-inst](https://asharehub.com/en/docs#top-inst): Dragon & Tiger institutional-seat detail
- [GET /v2/market/shareholders](https://asharehub.com/en/docs#shareholders): Shareholder count per period
- [GET /v2/market/holder-trade](https://asharehub.com/en/docs#holder-trade): Major-shareholder increase / decrease trades
- [GET /v2/market/concepts](https://asharehub.com/en/docs#concepts): Concept / theme board indices (Eastmoney DC)
- [GET /v2/market/concept-members](https://asharehub.com/en/docs#concept-members): Concept / theme board members
- [GET /v2/financials/analyst-reports](https://asharehub.com/en/docs#analyst-reports): Sell-side analyst earnings forecasts & ratings

## Specialty Data
- [GET /v2/market/technical-factors](https://asharehub.com/en/docs#technical-factors): Technical indicators (MACD/KDJ/RSI/BOLL/CCI) + adjusted prices
- [GET /v2/market/technical-factors-pro](https://asharehub.com/en/docs#technical-factors-pro): 200+ technical factors with bfq/qfq/hfq variants
- [GET /v2/chips/distribution](https://asharehub.com/en/docs#chips): Chip distribution: cost percentiles & winner rate
- [GET /v2/flows/northbound-holdings](https://asharehub.com/en/docs#northbound-holdings): Per-stock northbound (HK→mainland) holdings
- [GET /v2/flows/southbound-holdings](https://asharehub.com/en/docs#southbound-holdings): Per-stock southbound (mainland→HK) holdings

## Forex
- [GET /v2/fx/daily](https://asharehub.com/en/docs#fx): Daily FX rates

## News
- [GET /v2/news/flash](https://asharehub.com/en/docs#news-flash): Real-time financial news flash (source: cls/jin10/sina; Chinese text)

## Notes
- v1 endpoints (`/v1/...`) remain available but are frozen; new code should use `/v2`. v1 uses `ts_code` and returns numeric fields as strings.
- Prices are unadjusted unless noted; combine `daily` with `adj-factor` (or use `technical-factors`/`-pro`) for qfq/hfq adjusted series.