# AShareHub

> RESTful API for Chinese A-share and ETF (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/en/console/register (Free tier = 100 requests/day).
- Public primary codes use `symbol` for stocks, indices, sectors and ETFs (e.g. `000001.SZ`, `000300.SH`, `BK0949.DC`, `510300.SH`). A second constituent security uses `con_symbol`. All responses are JSON.
- Dates use `YYYYMMDD` in v2 requests. Returned numeric fields are JSON numbers.
- 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
- [Plans and pricing](https://asharehub.com/en/console/pricing): current hosted API prices and quotas; SDK licensing is separate
- Individual reference pages have a `.md` representation; append `.md` to a section URL to read code blocks, field tables and source links without the site navigation.

## 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

## ETF Data
- [GET /v2/etf/basic](https://asharehub.com/en/docs/etf-basic): ETF directory, manager, tracked index and listing status
- [GET /v2/etf/indices](https://asharehub.com/en/docs/etf-indices): Benchmark indices tracked by domestic ETFs
- [GET /v2/etf/daily](https://asharehub.com/en/docs/etf-daily): ETF daily OHLCV
- [GET /v2/etf/adj-factor](https://asharehub.com/en/docs/etf-adj-factor): ETF adjustment factors
- [GET /v2/etf/share-size](https://asharehub.com/en/docs/etf-share-size): Daily ETF shares, assets, NAV and close
- [GET /v2/etf/nav](https://asharehub.com/en/docs/etf-nav): ETF unit and accumulated NAV, and asset size
- [GET /v2/etf/portfolio](https://asharehub.com/en/docs/etf-portfolio): Periodically disclosed ETF holdings
- [GET /v2/etf/basket/sh](https://asharehub.com/en/docs/etf-sh-basket): Shanghai ETF PCF basket constituents
- [GET /v2/etf/basket/sz](https://asharehub.com/en/docs/etf-sz-basket): Shenzhen ETF PCF basket constituents

## 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 sector constituents
- [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.
- Choose and record the adjustment anchor when reproducing historical prices. Industry membership is classification data, not a Shenwan index-return series.
- Daily datasets and intraday quote snapshots have different refresh schedules. Check returned trade dates and timestamps; data may be delayed or revised.