RESTful API 接口，使用 API Key 鉴权，适用于程序化接入
https://api.quant.metrichub.app/api/v1
curl -H "X-API-Key: mhfk_your_key" \ "https://api.quant.metrichub.app/api/v1/open/market/dates" # 查询某天市场概况 curl -H "X-API-Key: mhfk_your_key" \ "https://api.quant.metrichub.app/api/v1/open/market/overview?date=20260321" # 搜索个股 curl -H "X-API-Key: mhfk_your_key" \ "https://api.quant.metrichub.app/api/v1/open/stock/search?q=茅台&date=20260321"
产业链图谱发布到 R2 后，先检查 bundle 完整性，再跑端到端验收脚本。versioned 发布会返回 release_manifest 状态，用于确认 pointer 指向的 release 清单、文件数和大小一致。验收覆盖 health、搜索、关系邻接、问答、公司画像、公司关系和真实路径查询。
curl -H "X-API-Key: mhfk_your_key" \ "https://api.quant.metrichub.app/api/v1/open/industry-graph/health?deep=true" MH_FIN_API_BASE_URL="https://api.quant.metrichub.app" \ MH_FIN_API_KEY="mhfk_your_key" \ python scripts/verify_industry_graph_open_api.py
推荐先调用 events/analyze 得到主题匹配、公司研究优先级和初步关系线索；只有需要核验结构路径时再调用 events/network。两者都是对已发布图谱的结构分析，不是新闻检索、业绩预测或股价因果模型。
curl -X POST -H "X-API-Key: mhfk_your_key" \
-H "Content-Type: application/json" \
"https://api.quant.metrichub.app/api/v1/open/industry-graph/events/network" \
-d '{"query":"AI 电力需求提升关联哪些 A 股产业链？","depth":2,"company_limit":100,"edge_limit":160}'
# 响应中的关键字段
{
"graph_version": "...",
"requested_depth": 2,
"actual_hops": 2,
"visited": {"node_count": 42, "edge_count": 58},
"truncated": false,
"network": {"nodes": [...], "edges": [{"id":"...","bucket":"upstream","hop":1,"traversal":"forward","status":"confirmed","claim_scope":"...","sample_doc_ids":["..."],"sample_evidence_texts":["..."]}]},
"companies": [{"priority_tier":"topic_match","priority_components":["主题/业务定位命中"], "...":"..."}],
"citations": [...]
}actual_hops 是实际遍历到的关系跳数；没有可达边时可为 0。network.nodes.kind 保留图谱原始层次，例如 chain_level、chain_segment、segment、company。network.edges 已包含关系分类、跳数、方向、证据摘要和置信度，以及 status、evidence_grade、claim_scope、文档标识；客户端不需要再与 levels.top_edges 拼接。companies[].priority_tier 与 priority_components 表示研究优先级的构成，不是收益概率、投资评级或因果结论。bucket 的 direct / upstream / downstream / cross_chain 是关系分类，不是收益概率或投资评级。traversal=reverse 仅用于反向查看同一关系，不能解释为经济传导方向。truncated=true 表示触及返回上限，调用方应提示用户并提高 limit 或缩小范围。| 方法 | 路径 | 说明 | 参数 |
|---|---|---|---|
| GET | /open/market/dates | 获取可用交易日列表 | - |
| GET | /open/market/overview | 市场全景 | date=YYYYMMDD |
| GET | /open/market/industry | 行业轮动排名 | date=YYYYMMDD |
| GET | /open/market/sector | 板块热点 | date=YYYYMMDD |
| GET | /open/stock/list | 全市场个股数据（分页） | date, sort?, order?, page?, size? |
| GET | /open/stock/search | 个股搜索 | q, date |
| GET | /open/limitup/list | 涨停分析 | date, type?(all/first/consecutive) |
| GET | /open/factor/ic | 因子 IC 有效性 | days?(default 20) |
| GET | /open/risk/alerts | 风险预警 | date, rule?(all/R1/R2) |
| GET | /open/industry-graph/meta | 产业链图谱状态与覆盖统计 | - |
| GET | /open/industry-graph/health | 产业链图谱 serving bundle / release manifest 完整性检查，可刷新服务端缓存 | deep?, refresh? |
| GET | /open/industry-graph/search | 搜索产业链、环节和上市公司 | q, limit? |
| POST | /open/industry-graph/ask | 自然语言解释层：返回问题映射、工具轨迹、证据与有界路径结果 | query, company_limit?, chain_limit?, edge_limit? |
| POST | /open/industry-graph/events/analyze | 主题关联分析：产业链、公司定位和匹配到的关系边 | query, company_limit?, chain_limit?, edge_limit? |
| POST | /open/industry-graph/events/network | 关系边有界 BFS：返回实际可达的多跳结构邻接、候选公司和证据 | query, depth?(1-3), company_limit?, edge_limit? |
| GET | /open/industry-graph/companies/{ts_code} | 公司产业链画像与原文证据 | ts_code |
| GET | /open/industry-graph/companies/{ts_code}/relations | 公司相关产业链关系边，含直接公司匹配和所属产业链/环节匹配 | ts_code, limit? |
| POST | /open/industry-graph/paths/query | 查询两个已解析端点之间沿关系边方向可达的连续路径 | source, target?, max_hops?(1-5), limit? |