FinDataHub 数据使用文档

系统概览

快讯数据 API

Base URL: http://127.0.0.1:8100

V2 统一接口（推荐）

从 news_unified 单表读取已去重数据，性能优于 V1 的 12 分表 UNION。

V2 响应字段 (news_unified)

V1 兼容接口（无需鉴权）

WebSocket 实时推送

连接: ws://127.0.0.1:8100/ws/live?key={API_KEY}

行情数据 API

Base URL: http://127.0.0.1:8000

REST API

MCP 工具 (Stdio)

协议: MCP 2024-11-05 · 鉴权: MCP_TOKEN 环境变量 (可选)

Python SDK

# pip install findatahub-client  (或本地 pip install -e .)
from findatahub import Client

client = Client(database="fin_data_clean")

# A 股日线行情
df = client.daily("000001.SZ", start_date="20260101")
print(df.columns)  # ['ts_code','trade_date','open','high','low','close','pre_close','vol','amount','pct_chg']

# 批量查询
df = client.daily_batch(
    ["000001.SZ", "600519.SH"],
    start_date="20260101", end_date="20260801"
)

# 周线/月线
df_w = client.weekly("000001.SZ", start_date="20250101")
df_m = client.monthly("000001.SZ")

# 财务指标
df = client.fina_indicator("000001.SZ", limit=10)

# 搜索股票
df = client.search_stock("平安")

# 数据质量
score = client.quality_score("stock_daily")
stats = client.stats()  # 各表行数 + 质量分

# 导出
path = client.export("stock_daily", fmt="csv")  # → ~/Downloads/findatahub_stock_daily.csv

数据库表结构

快讯系统 (news_flash)

news_unified — 统一快讯整合表 (Silver 层)

所有活跃源的快讯经四层去重后写入此表。V2 API 直接从此表读取。

快讯分表 (Bronze 层)

每个数据源一张分表，结构相同。活跃源: news_cls, news_wallstreetcn, news_sina, news_gelonghui, news_10jqka, news_hotlist

行情系统 (fin_data_clean)

stock_daily — A 股日线 (统一清洗 Schema)

TuShare + AKShare 双源合并清洗后的标准日线数据。

使用示例

Curl — 获取最新快讯

# 最新 20 条 (V2)
curl -s "http://127.0.0.1:8100/api/v2/news/live?limit=20" | python3 -m json.tool

# 筛选高重要性快讯
curl -s "http://127.0.0.1:8100/api/v2/news/live?limit=20&importance=4"

# 按来源筛选
curl -s "http://127.0.0.1:8100/api/v2/news/live?limit=20&source=cls"

# 关键词搜索
curl -s "http://127.0.0.1:8100/api/v2/news/search?q=降准&limit=10"

# 统计概览
curl -s "http://127.0.0.1:8100/api/v2/news/stats"

Curl — 查询行情数据

# 平安银行 2026 年日线
curl -s "http://127.0.0.1:8000/api/v1/daily/000001.SZ?start_date=20260101" | python3 -m json.tool

# 批量查询
curl -s -X POST "http://127.0.0.1:8000/api/v1/daily/batch" \
  -H "Content-Type: application/json" \
  -d '{"ts_codes":["000001.SZ","600519.SH"],"start_date":"20260701","end_date":"20260801"}'

# 数据质量
curl -s "http://127.0.0.1:8000/api/v1/quality/stock_daily"

# 健康检查
curl -s "http://127.0.0.1:8000/api/v1/health"

Python — 快讯 + 行情联动

import httpx
import pandas as pd

# 1. 获取高重要性快讯
resp = httpx.get("http://127.0.0.1:8100/api/v2/news/live",
                  params={"importance": 4, "limit": 50})
news = resp.json()["data"]
print(f"高重要性快讯: {len(news)} 条")

# 2. 从快讯中提取股票代码
import re
codes = set()
for n in news:
    found = re.findall(r'\b(\d{6}\.(?:SZ|SH))\b', n["title"])
    codes.update(found)

# 3. 批量查询这些股票的行情
if codes:
    resp2 = httpx.post("http://127.0.0.1:8000/api/v1/daily/batch",
                       json={"ts_codes": list(codes),
                             "start_date": "20260801"})
    df = pd.DataFrame(resp2.json()["data"])
    print(f"行情数据: {len(df)} 行")
    print(df[["ts_code", "close", "pct_chg"]].head())

JavaScript (前端) — WebSocket 实时推送

// 连接 WebSocket
const wsKey = import.meta.env.VITE_WS_KEY || '';
const ws = new WebSocket(`ws://127.0.0.1:8100/ws/live?key=${encodeURIComponent(wsKey)}`);

ws.onmessage = (e) => {
  const { type, inserted, pushed } = JSON.parse(e.data);
  if (type === 'new_news') {
    console.log(`新快讯: ${inserted} 条入库, ${pushed} 条推送`);
    // 拉取最新数据
    fetch('/api/v2/news/live?limit=10').then(r => r.json()).then(render);
  }
};

// 心跳保持
setInterval(() => ws.send('ping'), 30000);

数据管道流程

鉴权体系