A-shares, HK & US
one API for all three
Institutional-grade quotes, financials and company profiles for every A-share on the Shanghai and Shenzhen exchanges, Hong Kong listings and major US tickers. REST API, Python SDK and MCP — the same keys and the same adjustment basis, so cross-market research needs no second toolkit.
| Symbol | Last | Change | Ccy |
|---|---|---|---|
| A600519 | 1,682.40 | +1.24% | CNY |
| A300750 | 228.55 | +2.08% | CNY |
| HK00700 | 385.20 | −0.68% | HKD |
| USAAPL | 231.45 | +0.94% | USD |
| USNVDA | 128.60 | +1.72% | USD |
01Scale
Three markets share one set of keys and one adjustment basis, so they line up directly.
02Three markets
The free tier covers all A-shares; Hong Kong and US open on Pro with identical response shapes.
A-shares Free tier
Daily bars, valuation, financials, filings and technical factors for every Shanghai and Shenzhen ticker, addressed by bare code.
- Daily history
/cn/stock/history - Financials
/cn/stock/financial_data - Technical factors
/cn/stock/factors - Indices
/cn/index/history
Hong Kong Pro
HK listings, company profiles and historical bars, with five-digit codes such as 00700.
- HK list
/hk/stocks - HK history
/hk/stock/history - Profile
/hk/stock/info
United States Pro
US listings, full profiles, dividends and splits, plus US index bars.
- US history
/us/stock/history - Dividends / splits
/us/stock/dividends - US indices
/us/index/history
03Data coverage
Grouped by workflow; fields and envelopes stay consistent within a group.
| Domain | Representative endpoints | Frequency | Since |
|---|---|---|---|
| Quotes & valuationDaily OHLCV, adjusted series, valuation | /cn/stock/history · /hk/stock/history · /us/stock/history | Daily / realtime | 2010 → |
| Financials & filingsThree statements, per-share metrics, filing links | /cn/stock/financial_data · /cn/stock/announcements | Quarterly / daily | 2010 → |
| Indices & ETFsIndex lists, constituents, ETF PCF and holdings lookup | /cn/index/history · /us/index/list · /cn/etfs/etf_pcf | Daily | 2010 → |
| Technical factors33 factors: momentum, volatility, MACD, MA alignment | /cn/stock/factors · /cn/stock/factors/snapshot | Daily | 2010 → |
| Market & sentimentSW sector moves, fear & greed, realtime tick | /cn/market/sector_data/sw1 · /cn/market/fear_greed · /cn/stock/tick | Daily / realtime | — |
| News & macroRolling news flash, macro series, trading calendar | /v2/news/flash · /macro/indicator · /cn/tick/trading_calendar | Realtime / monthly | 1985 → |
04Three ways in
One dataset, whichever entry point fits your workflow.
REST API
Plain HTTP and JSON from any language. Consistent paging and field filters; empty results carry a reason instead of a silent empty array.
GET /cn/stock/history?symbol=600519
02 / PYTHON↗
Python SDK
Native pandas, DataFrames straight back. Column names and types stay stable across releases, so upgrades don't break existing backtests.
pip install databull
03 / MCP↗
MCP server
38 read-only tools that Claude, Cursor and any MCP client can call in natural language.
uvx databull-mcp
05Ten lines to first result
One method family across all three markets — only the symbol changes.
# Install the SDK $ pip install databull from databull import DataBull client = DataBull("dbt_your_key_here") # A-shares use the bare code: 600519, no .SH / .SZ df_cn = client.get_stock_history("600519", "20240101", "20241231", adj="back") # Hong Kong and US: same shape, different symbol df_hk = client.get_hk_stock_history("00700", "20240101", "20241231") df_us = client.get_us_stock_history("AAPL", "20240101", "20241231") print(df_cn.tail(), df_hk.tail(), df_us.tail())
Start with A-shares, extend to Hong Kong and the US when you need them
500 calls a day on the free tier, covering every A-share data domain. Keys are issued instantly, no credit card required.