Overview

AShareHub provides institutional-grade Chinese A-Share market data through a simple, modern Python SDK. Access real-time and historical data for all listed Chinese A-shares.

Key Features:

• Returns pd.DataFrame — same convention as Tushare
• 38 data endpoints covering market, financial, real-time, news, and reference data
• 10+ years of historical data
• Secure API key authentication
• Fast and reliable

Installation

pip install asharehub

Requirements: Python 3.10+, pandas

Quick Start

from asharehub import AShareHub

client = AShareHub(api_key="ash_your_key_here")

# Get daily market data — returns pd.DataFrame
df = client.market_daily(symbol="000001.SZ", start_date="2024-01-01", end_date="2024-12-31")
print(df[["trade_date", "open", "high", "low", "close", "vol"]])

client.close()

API Methods

All methods return pd.DataFrame. Empty results return an empty DataFrame (df.empty == True).

Market Data

df = client.market_daily(symbol="000001.SZ", start_date="2024-01-01")
df = client.fundamentals(symbol="000001.SZ", start_date="2024-01-01")
df = client.margin(symbol="000001.SZ", limit=100)
df = client.block_trade(symbol="000001.SZ", limit=100)
df = client.top_list(limit=100)
df = client.shareholders(symbol="000001.SZ", limit=100)
df = client.holder_trade(symbol="000001.SZ", limit=100)
df = client.concepts(limit=100)
df = client.concept_members(symbol="TS2", limit=100)
df = client.adj_factor(symbol="000001.SZ", limit=100)
df = client.technical_factors(symbol="000001.SZ", limit=100)
df = client.limit_list(limit_type="U", limit=100)

Capital Flows

df = client.moneyflow_hsgt(start_date="2024-01-01", limit=100)
df = client.moneyflow(symbol="000001.SZ", limit=100)
df = client.northbound_holdings(symbol="000001.SZ", limit=100)

Financials

df = client.financial_indicators(symbol="000001.SZ", limit=20)
df = client.income(symbol="000001.SZ", limit=20)
df = client.balance_sheet(symbol="000001.SZ", limit=20)
df = client.cash_flow(symbol="000001.SZ", limit=20)
df = client.forecast(symbol="000001.SZ", limit=50)
df = client.express(symbol="000001.SZ", limit=50)
df = client.dividend(symbol="000001.SZ", limit=50)

Indices

df = client.index_daily(symbol="000300.SH", start_date="2024-01-01")
df = client.index_weight(symbol="399300.SZ", limit=100)

Other

df = client.chip_distribution(symbol="000001.SZ", limit=100)
df = client.fx_daily(symbol="USDCNH.FXCM", limit=100)

Reference Data

df = client.stock_list(limit=100)
df = client.industry_list(limit=100)
df = client.trade_calendar(exchange="SSE", start_date="2024-01-01")

Common Parameters

All data methods accept:

Common Index Codes

Authentication

Get your free API key:

1. Visit asharehub.com/console/register
2. Create an account
3. Generate your API key in the dashboard

Free tier includes 100 API calls per day.

Error Handling

from asharehub import AShareHub
import httpx

client = AShareHub(api_key="your_key")

try:
    df = client.market_daily(symbol="000001.SZ")
except httpx.HTTPStatusError as e:
    if e.response.status_code == 401:
        print("Invalid API key")
    elif e.response.status_code == 429:
        print("Rate limit exceeded")
    else:
        print(f"HTTP error: {e}")

Advanced Usage

Context Manager

with AShareHub(api_key="your_key") as client:
    df = client.market_daily(symbol="000001.SZ")
    # Client automatically closes when exiting context

Custom Base URL

client = AShareHub(
    api_key="your_key",
    base_url="https://custom.api.url",
    timeout=60.0
)

Rate Limits

Support

• Documentation
• Report Issues
• Email: support@asharehub.com

License

MIT License - see the LICENSE file for details.