重点赛事实时数据
覆盖世界杯、欧洲杯、欧冠和五大联赛，提供比分、状态、比赛秒表、事件、技术统计、阵容和赛前伤停。
/api/v1/football/live?priority=top- 稳定
match_id与external_ids.canonical_match_key last_updated、source_updated_at、confidence_score
两条数据产品线
首页只展示客户需要理解的能力：稳定接口、覆盖范围、字段质量和接入方式；采集源、解析细节和运行维护由平台后台持续处理。
股票研究数据
支持 US/HK/CN，面向 AI 股票分析、估值、风险分析、报告生成、股票搜索和数据补全。
/v1/symbols/search?q=茅台&market=AUTO/v1/stocks/{market}/{ticker}/profile与/quote- 财务摘要、财务报表、公告文件、历史价格和批量接口持续补全
核心覆盖范围
优先覆盖高价值、高频使用的数据，避免低质量噪声影响客户产品体验。
世界杯world-cup
欧洲杯euro
欧冠champions-league
英超premier-league
西甲la-liga
德甲bundesliga
意甲serie-a
法甲ligue-1
美股US equities
港股HK equities
A 股CN equities
公告财报filings and reports
5-10s进行中重点足球赛事支持高频刷新比分、状态和比赛秒表。
72h滚动发现未来重点赛事，自动入库并持续补齐详情接口。
US/HK/CN股票搜索、行情、财务和公告接口使用统一字段结构。
Trace尽量返回 data_source、updated_at、missing_fields 和 missing_reasons。
常用接口
足球和股票接口位于同一 API 域名下，返回标准 JSON，适合前端页面、后端任务和 AI 分析流程调用。
GET
/api/v1/football/live?priority=top重点赛事实时比分、状态、分钟、秒表和新鲜度。
GET
/api/v1/football/matches/upcoming?priority=top&hours=72未来 72 小时重点赛事滚动窗口，便于赛前预热和映射。
GET
/api/v1/football/match/{match_id}比赛详情，包含稳定 ID、外部映射、覆盖质量和伤停汇总。
GET
/api/v1/football/match/{match_id}/injuries赛前伤停、停赛、缺阵、出战成疑名单；没有明确名单时返回空数组。
GET
/api/v1/football/match/{match_id}/stats控球率、射门、角球、犯规、越位和牌数等技术统计。
GET
/v1/symbols/search?q={keyword}&market=AUTO支持代码、中文名、英文名、拼音、简称和别名搜索。
GET
/v1/stocks/{market}/{ticker}/quote近实时行情，包含价格、涨跌幅、成交量、市值和估值字段。
POST
/v1/stocks/batch批量读取 profile、quote、fundamentals 等字段，单只失败不影响其他结果。
采集、校验、输出
HKJData 保存原始响应，解析后做标准化、横向对比、新鲜度标记和离线索引，客户只需要对接稳定 API。
01Public Sources公开页面、公开 JSON、动态页面、交易所公告和财报文件。
02Raw Payloads先保存原始响应，保留追溯、修复和复核依据。
03Parsers提取比赛、股票、财务、公告、事件和阵容数据。
04Quality Layer多源对比，标记 stale、confidence 和 missing_reason。
05API Output输出统一 JSON，便于客户产品稳定调用。
接入建议
足球先接入 /api/v1/football/live?priority=top 和 upcoming 滚动窗口。股票先接入 /v1/symbols/search、/profile 和 /quote，再逐步启用财务、公告和批量接口。