maoxianyong 0.1.3

Unified stock data infrastructure for A-share, HK and US markets

maoxianyong

Unified stock data infrastructure for A-share, HK and US markets.

Install

pip install maoxianyong

Quick Start

from stock import StockReader, get_universe

reader = StockReader()

# Single stock
df = reader.get('NVDA.US', start='2024-01-01')

# Multi-stock wide table (for backtesting / correlation)
close = reader.get_wide(['NVDA.US', 'AMD.US', 'TSLA.US'], 'close', start='2024-01-01')
close.pct_change().corr()

# All US stocks
us = reader.get_market('US', start='2024-01-01')

# Custom SQL
reader.query("""
    SELECT symbol, date, close,
           close / LAG(close) OVER (PARTITION BY symbol ORDER BY date) - 1 AS ret
    FROM {daily}
    WHERE market = 'US'
    ORDER BY symbol, date
""")

# Index constituents
symbols = get_universe('hs300')   # CSI 300
symbols = get_universe('hsi')     # Hang Seng Index
symbols = get_universe('us_core') # US tech + sector leaders

Data Sources

Market	Source	Symbols
A-share	AKShare (Sina)	600519.SH, 000001.SZ
HK	AKShare (Sina)	00700.HK, 09988.HK
US	yfinance	AAPL.US, NVDA.US

Cloud Sync (Aliyun OSS)

export DATA_SOURCE=oss
export OSS_KEY_ID=your-key
export OSS_KEY_SECRET=your-secret
export OSS_ENDPOINT=oss-cn-hangzhou.aliyuncs.com
export OSS_BUCKET=your-bucket