+
+
A-Share Data Platform
+
A股全量数据服务 — Parquet + DuckDB 存储，REST + WebSocket 双协议
+
+
+
+
+
+
+
支持的 K 线周期
+
+
+
+ 注意：日线/周线/月线可回填全部历史数据；分钟线 API 仅保留近 1-3 个月，需通过每日盘后拉取积累本地数据；
+ 2 小时线从 1 小时线实时推导，无需单独存储。
+
+
+
+
股票查询 GET
+
+
+
GET /api/v1/stocks
+
分页查询股票列表，可按交易所、板块筛选
+
+ 参数: exchange=SH|SZ|BJ market=主板|创业板|科创板 limit=100 offset=0
+
+
+
+
+
GET /api/v1/stocks/{ts_code}
+
单只股票基本信息 — 例: /api/v1/stocks/000001.SZ
+
+
+
+
GET /api/v1/stocks/search?q=平安
+
按名称或代码模糊搜索，最多返回 50 条
+
+
+
# 搜索平安
+curl "http://localhost:8000/api/v1/stocks/search?q=平安"
+
+# 查看深交所主板股票
+curl "http://localhost:8000/api/v1/stocks?exchange=SZ&market=主板&limit=20"
+
+
+
K 线查询 GET POST
+
+
+
GET /api/v1/klines/{freq}?ts_code=000001.SZ&start_date=2026-01-01&end_date=2026-05-16
+
查询单只股票指定周期的 K 线数据
+
+ 参数: freq=1m|5m|15m|30m|1h|2h|1d|1w|1M ts_code start_date end_date limit=10000
+
+
+
+
+
POST /api/v1/klines/{freq}/batch
+
批量查询多只股票 K 线
+
Body: {"codes": ["000001.SZ","600000.SH"], "start_date": "2026-01-01", "end_date": "2026-05-16"}
+
+
+
+
GET /api/v1/klines/{freq}/latest?ts_code=000001.SZ
+
最新交易日数据（ts_code 可选，不传返回全量）
+
+
+
+
GET /api/v1/klines/available-freqs
+
返回所有支持的频率及其分类
+
+
+
# 平安银行 2026 年日线
+curl "http://localhost:8000/api/v1/klines/1d?ts_code=000001.SZ&start_date=2026-01-01"
+
+# 批量查 2h K 线
+curl -X POST "http://localhost:8000/api/v1/klines/2h/batch" \
+ -H "Content-Type: application/json" \
+ -d '{"codes": ["000001.SZ","600000.SH"], "start_date": "2026-05-01"}'
+
+
+
实时行情 GET
+
+
+
GET /api/v1/realtime/spot?codes=000001.SZ,600000.SH
+
获取指定股票实时快照（最新价、涨跌幅、成交量等）。不传 codes 返回全市场数据
+
+
+
+
GET /api/v1/realtime/market-state
+
当前市场状态：trading / lunch_break / closed / pre_open / closing_auction
+
+
+
curl "http://localhost:8000/api/v1/realtime/spot?codes=000001.SZ,600519.SH"
+curl "http://localhost:8000/api/v1/realtime/market-state"
+
+
+
交易日历 GET
+
+
+
GET /api/v1/calendar/trading-days?start=2026-01-01&end=2026-05-16
+
查询日期范围内的交易日
+
+
+
+
GET /api/v1/calendar/is-trading-day?date=2026-01-15
+
判断指定日期是否为交易日
+
+
+
+
实时推送 WebSocket
+
+
+
WS /ws/realtime
+
交易时段（9:25-15:05）每 5 秒推送订阅股票的实时行情
+
+
+
+ WebSocket 连接后需先发送订阅命令才会收到数据推送。支持按股票代码粒度订阅/退订。
+
+
+
# 使用 websocat 测试:
+websocat ws://localhost:8000/ws/realtime
+
+# 连接后发送订阅:
+{"action": "subscribe", "codes": ["000001.SZ", "600519.SH"]}
+
+# 退订:
+{"action": "unsubscribe", "codes": ["000001.SZ"]}
+
+# 取消全部订阅:
+{"action": "unsubscribe_all"}
+
+
# 服务器推送的消息格式:
+
+# 行情数据
+{"type": "spot", "data": {
+ "000001.SZ": {
+ "price": 12.34, "change": 0.12, "pct_chg": 0.98,
+ "volume": 12345678, "amount": 152345678.9,
+ "high": 12.45, "low": 12.10, "open": 12.20,
+ "pre_close": 12.22, "name": "平安银行"
+ }
+}}
+
+# 市场状态
+{"type": "market_state", "state": "trading", "timestamp": "2026-05-16T10:30:00+08:00"}
+
+# 心跳 (每 30 秒)
+{"type": "heartbeat", "timestamp": "2026-05-16T10:30:00+08:00", "connections": 3}
+
+# 确认订阅
+{"type": "subscribed", "codes": ["000001.SZ", "600519.SH"]}
+
+
+
CLI 命令行工具
+
+
# 初始化数据库
+ashare-dp backfill init
+
+# 回填全部历史日线/周线/月线
+ashare-dp backfill daily
+
+# 回填近 30 天分钟数据
+ashare-dp backfill minute --days 30
+
+# 启动 API 服务
+ashare-dp serve start --port 8000
+
+# 命令行查询
+ashare-dp query kline 1d 000001.SZ --start 2026-01-01
+ashare-dp query latest --freq 1d --ts-code 000001.SZ
+ashare-dp query stats
+
+
+
+
+