FinBayes ↔ Data Horizon 多市场数据集成与 provider 注册表任务书

本文给 Data Horizon（DH）负责人、DH 执行角色、FinBayes 团队共用，把「FinBayes 的多市场数据需求如何由 DH 维护 provider 注册表、并产出差异化资产」整理成 DH 可评审、评审后可拆解的输入。它不是已排产的任务单。部分核心决策已闭合（vendor 选型 = CoinAnk 套餐1 / 凭据归属 = DH 持 key / S0 网络可达性实测，均见 §11），S2 首刀透传通路已打通；仍待定的是韩股缺口 / 期货 vendor / 富途大陆 LV2 / 再分发的 CoinAnk 书面授权（见 §11）。请 DH 先给 accept / reject 条件。

本文承接 生态级多市场数据边界口径 ADR-0005 与 DH↔FinBayes 数据接口分工 ADR-030，体例对标 Trading Matrix → DH 信源候选任务书。

就绪度：S0/S1（注册表元数据口径 + 字段对齐）即可评审领取；S2（差异化资产生产）依赖 §11 的 owner 决策（vendor 选型 / 凭据归属）与可达性实测闭合后才能启动。

1. 核心结论

DH 不路由商品化标准行情（守 DH 边界不变量 #4 与 ADR-004 差异化价值原则）。请 DH 承接两件、且都不抢 DH 的运行可用性责任：

1. 维护 provider 注册表：把多市场 provider 的元数据、凭据引用规范、能力标签、代理出口建议、可达性证据收进 DH Provider 配置中心。它是推荐配置源 / 注册表，不是运行事实源——FinBayes 读取后在本地合成自己的 fallback / runtime policy、自持取数可用性。
2. 产出差异化资产：仅当对数据做了增值（跨源校验 / 质量标签 / 双时间戳 / 授权限制 / 可回测快照 / 复用契约）才归 DH；只转发 vendor 原始字段不归 DH（判据见 §4.2）。

FinBayes 侧自持商品化数据的直连取数容错、缓存与出处信封（ADR-030 已实现并部署，仅 crypto 市场）。

2. 背景与根因

2026-06-22 FinBayes 团队问 BTC 多交易所订单簿深度、全交易所取不到数。逐所实测显示失败是三类各异的失败 + 一类非失败：地理封锁（binance 451 / bybit 403）、品种模型不匹配（deribit 无现货）、并发瞬时（限频 / 超时无重试）；外加一类「venue 深度返回封顶」非失败，已被既有 covered_pct caveat 处理（详见 DataAcquisition 子系统设计）。根因是取数容错 + venue 感知这一层从未建立。

FinBayes 侧整改已落地（仅 crypto）。但 crypto 只是第一个市场，未来要覆盖多市场（crypto / 美股 / A 股 / 港股 / 日韩股 / 期货 / 外汇）+ 多 vendor——这正是 ADR-0005 立的边界口径，本文是它在 FinBayes ↔ DH 之间的可执行落地。架构层结论：做成 provider-agnostic + 注册表驱动（稳定的出处信封契约 + 取数从注册表合成配置 + 工具按 asset_class 路由防爆炸），以适配未来不断增加的数据源。

3. 分工边界

事项	Data Horizon 负责	FinBayes 负责
商品化标准行情（OHLCV / OI / 资金费率 / 订单簿 / 报价）	不路由。	直连第三方取数 + 弹性容错 + 缓存 + venue 感知。
Provider 元数据 / 凭据引用规范 / 能力标签 / 可达性证据	维护注册表（推荐配置源，非运行依赖）。	读注册表后本地合成 fallback / runtime policy，自持取数可用性；DH 未暴露前用本地静态默认。
差异化资产（清算图 / 订单流 / 多空比 / 链上 等经增值后的资产）	做跨源校验 + 出处 + 质量标签 + 资产化，经 Open API 产出。	作消费方接入。
vendor 选型与尽调	决定集成哪些、自建还是接入。	提供需求 + 尽调输入（§6）+ 消费侧反馈。
出处与诚实降级	差异化资产带来源 / 双时间戳 / 质量元数据。	所有取数产出出处信封；弹性链穷尽才诚实降级。

4. 请 DH 评审的承接事项

4.1 Provider 注册表：能力域从「宏观与金融数据」扩到多市场

DH Provider 配置中心 的 R1 聚焦「宏观与金融数据 Provider」（指 FRED / FMP / Trading Economics 这条宏观事实源链，不是 crypto 交易所行情）。请求把注册表的能力域扩到多市场：crypto（ccxt 各所 + 聚合 vendor）、美股 / A 股 / 港股 / 日韩股、期货 / 外汇。

优先级要诚实：对照 DH 路线图，DH 的 P0-Now 只有 DH-WP-001（TM 信源）与 DH-WP-002（KOL 总控室）；结构化行情底座是 WP-P3-01（P3-Later，明确「不阻塞当前主闭环」）。所以多市场 provider 纳入注册表对 DH 是 R2 之后的候选、让位于 DH 自身 P0，不是近期主线。注册表里 per-provider 的代理出口是建议（对齐 FinBayes 顶层 network.proxy），非 DH 必须为消费方运行维护的策略。

提醒：DH Provider 配置中心目前还没正式 WP 化、未进路线图看板，「对齐配置中心 R1/R2/R3」的前提是先把它立成 WP。本文所有「R1/R2/R3」均指 Provider 配置中心的 R1/R2/R3，与 DH-WP-002 KOL 总控室的 R1/R2/R3 是不同工作流，勿混。

4.2 差异化资产：判据决定什么归 DH

ccxt 做不了 / 难做的衍生品与链上数据（清算图、订单流 / CVD、多空比、大额单、链上）有成熟低价 vendor（§6）。但**「免费源做不了」不等于自动归 DH**。判据（与 ADR-0005 §3 一致）：

• 仅转发 vendor 原始字段 = 商品化，由消费方直连，不进 DH 主线（否则是重复路由、碰红线）。
• 加跨源校验 / 质量标签 / 双时间戳 / 授权限制 / 可回测快照 / 复用契约 = 差异化资产，归 DH。

即 DH 在这批数据上的价值是校验 + 出处 + 资产化，不是当 vendor 代理。这条命中 ADR-004「他处难自助、高杠杆」，但要清醒：它与 DH 第一阶段既定差异化主线（私域职业信号 / 突发事件，且 DH 信号提炼层目前休眠）抢同一条差异化资产生产带宽。建议作为独立新 work package 登记，不与 DH P0 抢 M0/M1 资源。

4.3 work package 归属与回写

• 注册表多市场扩展 → Provider 配置中心自身的 R2/R3 对象扩展（需先把配置中心立成 WP）。
• 差异化资产生产 → 新 work package（类比 WP-MACRO-01 市场纵深扩展），不挂 DH-WP-001（TM 信源）或 DH-WP-002（KOL），那是私域 / 事件信源。
• 消费契约 → 注册表 WP 的对外接口子项，依赖注册表 WP 先成立。

回写位置（对齐 Provider 配置中心 Review §4）：对象分类扩展 → DH 工程架构 或新 WP；分期顺序 → DH 路线图。

5. FinBayes 当前已落地的数据与接口（消费侧就绪度）

让 DH 知道对接对象长什么样（crypto 完整落地；FX / A 股 / 美股 商品化直连取数代码亦已落地、部分待 live 验证；均 FinBayes 直连、不经 DH）：

• 弹性取数层（finbayes/data/acquisition.py）：多源重试 + 故障分类跳源 + first-success-wins + 穷尽后诚实降级。
• venue / 品种模型（finbayes/data/venues.py）：进网络前跳过 venue 没有的品种、标记被墙源。
• 8 个 crypto 技术分析接口，按性质拆清：5 个直连取数（OHLCV / 订单簿深度 / 未平仓合约 / 资金费率 / 报价，走 ccxt）+ 3 个本地计算（EMA / RSI / 关键价位，从 OHLCV 算、无需 provider）+ 1 个 vendor-only 待接（清算，无 key 时诚实 no_source——正是请 DH 补的数据位）。
• 聚合 vendor 接入点（finbayes/data/coinank.py）：transport 注入、离线可测、有 key 才激活。注：owner 已定 CoinAnk 走 DH 集成路径（凭据 DH 持有），故 FinBayes 侧接入将新增 dh_crypto.py（镜像 dh_macro.py）消费 DH Open API，coinank.py 直连降为后备 / 不启用。
• 宏观取数：FinBayes 直连 FRED 兜底（经 DH 宏观 Open API 优先、FRED 兜底）。注意这是 FinBayes 侧直连 FRED，不是消费 DH 产出的宏观资产——DH 那条「宏观高价值资产经 Open API 产出」目前是缺口（WP-MACRO-01，未排期），不要据此以为 DH 已有成熟资产消费线。
• 出处信封契约（FetchResult / SourceRef，见 §7.2）。
• 代理集中配置（顶层 network.proxy + Config.resolve_proxy）：被墙源走代理、可达源直连。

已知缺口（DH 集成可补）：① FX 只能报 rate、无可信 bid/ask（yfinance 限制）；② 清算无免费源；③ 被墙交易所出口 IP 限制。

6. vendor 候选 shortlist（2026-06-22 尽调，待验证假设、非实施结论）

这是一份桌面尽调：基于公开资料的候选与假设，不含抓取时间 / API 文档逐条证据 / 实测记录。所有定价 / 覆盖签约前必须重新核实。

可达性实测（2026-06-23，经 1080 代理 + 直连，对照 okx 可达 / binance 451）：5 家首选 API 主机层全部可达、无一地理封锁——Coinglass / CoinAPI / CryptoQuant / J-Quants 代理与直连均通，OANDA 仅代理可达（直连超时）。仅证主机可达（拿到 HTTP 响应，多为 401/403/404 鉴权态），未证 key/账户级取数、限频、或中国能否注册免费/practice 账户（尤其 J-Quants 注册、OANDA practice 开户）。S0 网络可达 gate 已闭合；账户/取数级仍待 key 就绪后验。

6.1 Crypto

数据位	候选	关键事实（需核实）
衍生品 + 清算 + 订单流	Coinglass	有正式 API + 文档（官方仅证 $29 档含 Liquidation Orders & Funding 等基础能力、80+ endpoints、30/min）；清算热力图 / 挂单热力图等高价值层所属档位无端点级证据、待逐端点核验（勿臆断 $29 可覆盖、亦勿臆断具体高档价）；CVD 需用 taker buy/sell + 深度自算（CoinAnk 套餐3 原生供）。是 CoinAnk 的候选替代，能力重叠待逐端点 API 字段核验——非「等价物」。
链上分析	CryptoQuant（面板 $109/mo，API 准入档与分辨率待核）/ Nansen（标签层，$49 Pro 档、API 另按 credit 计费，价格 / 准入待核）/ Glassnode（深但 API 锁贵档）	交易所资金流 + 巨鲸性价比相对高；定价均桌面值、签约前必核。
广覆盖 / 低价市场数据	CoinAPI（PAYG + $25 credits）	400+ 所、规范化 symbology；CCData 免费档 2026-06 已退役 → 降级。
企业级（当前减分）	Kaiko（~$28.5k/yr，2026-06 已收购 Amberdata）/ Amberdata（$600/mo per exchange）	覆盖全但天价，仅 DH 走机构合规路线时评估。

决策（owner 2026-06-23）：crypto 首个集成 = CoinAnk 初级套餐、走 DH 集成（非上表 Coinglass）；上表 Coinglass/CryptoQuant/CoinAPI 留作后续升级 / 扩展候选。CoinAnk 初级套餐（套餐1）覆盖 OI/资金费率/清算（aggregate：汇总窗口 + 历史桶 + 支持对；逐笔爆仓订单属套餐3）/K线，正补 FinBayes 清算缺口（详见 §8 S2 与 §11 DH 2026-06-23 确认）。

6.2 宏观 + 欧美股 / 期货 / 外汇

数据位	候选	关键事实（需核实）
宏观 / 经济指标	Trading Economics（经济日历 + 196 国 + 预测）	补 FRED 全球面与日历缺口；免费 developer key 仅子集，经济日历是否在免费档需核实。
美股	Polygon.io（现 Massive，$79 Developer / 实时 $199）/ Finnhub（免费 60/min）	已更名 Massive，api.polygon.io 并行至「new year」后下线 → 集成须用可配置 base URL。
期货	Polygon/Massive（待核权限）/ Barchart	Massive（前 Polygon.io）官方已列 Futures 的 REST / WebSocket / Flat Files 入口——覆盖存在，待核验的是品种范围 / 历史深度 / 实时权限档 / 定价（已不是「覆盖是否存在」存疑）；Barchart 覆盖确定但 $500+/mo 偏贵。
外汇	OANDA v20	需 v20 账户（demo 或 live）、有真实 bid/ask、历史回 2005。纠正口径：practice 走同一 v20 pricing 端点、报价是真实市场指示价（非「模拟报价」）；被模拟的是成交 / 滑点（demo 无真实撮合）——故作 FX 分析源（要价差）基本可用，caveat 应落在「成交不可信 + 商用许可 / 中国开户门槛 / division 限制」而非「报价是假的」。另：oanda_fx.py 当前 offline-tested、response 解析未经 live 验证，须首个真 token 时 live 验。
企业级综合（当前减分）	Bloomberg（~$32k/yr+）/ FactSet（合约最灵活）/ LSEG-Refinitiv（RDP）	覆盖天花板但天价，仅 DH 走 B 端商业化时评估。

6.3 亚洲股市

市场	候选	关键事实（需核实）
A 股	Tushare Pro（积分制）/ AkShare（免费）	两者大陆免代理。AkShare 是爬虫、底层站点改版即失效，只作免费兜底。
港股	富途 OpenAPI（大陆用户免费 LV2）/ AkShare（延迟 15min）/ Twelve Data（实时付费 Pro $229）	富途需券商账户 + OpenD 网关；大陆 LV2 判定依开户地 / IP，经代理出海可能降级 LV1，需实测。
日股	J-Quants（官方分档 ¥0–16,500/mo）	需代理；Free 档数据延迟 12 周基本不可用。
韩股	基本面 = OpenDART（免费）；行情 = KRX Open API（需审批）/ 券商 OpenAPI 类（如 KIS Developers，需券商账户）/ Massive 全球股或 Databento 间接覆盖部分 KRX（待核）/ Twelve Data Pro（$229）/ pykrx（脆弱爬虫）	四市场最难的一块（非绝对无解）：缺「同时低价+稳定+实时」的行情 API。owner 决策前先把三难拆成可裁剪条件——延迟行情能否接受（能则 AkShare 类延迟源 / Massive 间接可用）、实时是否硬需、预算上限——而非在伪三难里二选一。

爬虫类源（AkShare / pykrx）随上游站点改版即失效，统一只作免费兜底、绝不作唯一源。

7. 接口契约与字段口径

7.1 Provider 注册表字段（DH 维护 → 消费方读取）

可下发的配置元数据（DH 待建字段，FinBayes 侧暂用 venues.py + 本地静态默认兜底）：

字段	说明
provider_id	稳定 provider ID。
capability_domain	能力域 / 市场（crypto-spot / crypto-deriv / us-equity / a-share / hk-equity / jp-equity / fx / macro …）。
data_types	供哪些数据类型（ohlcv / oi / funding / liquidation / orderbook / quote / onchain …）。
credential_ref	凭据引用规范（keychain 引用名，不含明文，不下发实际 key）。
proxy_egress	被墙源代理出口建议（对齐 FinBayes network.proxy，非 DH 运行维护责任）。
capability_label	能力标签 / 限频 / 额度等元数据。
reachability	可达性证据（含中国出口 IP 实测结论）。

不下发：明文凭据、运行时 fallback / 限频策略——这些是消费方读注册表后本地合成并自持。

7.2 差异化资产消费契约（出处信封口径）

DH Open API 产出的差异化资产应带与 FinBayes FetchResult.to_dict() 等价的字段（核对自代码仓 finbayes/data/fetch_result.py）：

• FetchResult：ok / data_type / symbol / request_id / fetched_at / as_of / staleness_s / fallback_used / count / sources / error / data。其中 request_id（join 回结论/事件流的关联 ID）+ fetched_at（双时间戳之一，与 as_of 共同构成双时间戳） 是 DH 资产必带；staleness_s 由 fetched_at - as_of 派生（DH 可不存）。
• SourceRef：venue / symbol_as_seen / quote_currency / kind（venue|composite|vendor）/ as_of / constituents / method / **upstream**。upstream（中继背后的权威源，如 FRED 背后的 BLS）对 DH 尤其关键——DH 自己是中继，产出资产应尽量填 upstream 指向原始交易所 / 链上源。聚合 vendor 例外规则（必读）：当 vendor 是跨所聚合站（如 CoinAnk 聚合清算）、不暴露 constituent 级原始来源时，upstream / constituents 可标聚合级或留空，但必须 kind=vendor + method=aggregated + 在 venue 注明聚合站名，诚实标「聚合级、无逐所拆分」——不得伪造逐所 upstream。否则该字段对聚合资产物理不可实现，会逼出假出处。

7.3 API 形态：并入 DH 现有 Open API 同一表面，按 asset family 分命名空间（owner 2026-06-23 拍）

owner 拍定：DH 集成的数据不另起独立鉴权的新 API，也不塞进宏观那套 schema，而是与现有宏观 Open API（dh-api.topquant.org，X-API-Key）共用同一表面——

• 统一的是契约不是 URL：同 host + 同 X-API-Key + 同一出处信封契约（§7.2）。FinBayes 只集成一个 DH client、一套 key、一套 envelope 解析，复用现有消费宏观的管线（dh_macro.py），crypto 侧加一个 dh_crypto.py 镜像即可，不是第二个集成点。
• 分的是 schema / 命名空间：/macro/* 原样不动；crypto 差异化资产走 /crypto/*（或统一 /assets/{asset_type}），各自 schema 独立演化（宏观是 release/point/event 语义、crypto 衍生品是 symbol×交易所 时序/快照，不混）。
• DH 现有 Provider 配置中心 API 是后台管理面（运营人员配 provider），下列对外消费接口是新增（属注册表 WP 的 R2 之后子项，非 R1 既有能力的暴露）；deploy 成一个服务还是同网关下兄弟服务由 DH 定，FinBayes 的硬要求只有「一套鉴权 + 一套出处信封 + asset-type 路由」：
  • GET /dh/providers：按能力域 / 市场读 provider 注册表（§7.1 元数据，不含明文凭据）。
  • 清算（DH 2026-06-23 实接 CoinAnk Plan1 aggregate 面）：DH 描述为 3 端点 crypto/liquidations/{summary,history,symbols}（简写未带 /v1/open/ 前缀；最终 FinBayes-facing 路径 + 是否单端点带 mode 待 DH 给样例时锁定，见 §11）——消费出处信封 + license 封装的聚合清算数据（信封比 macro 富、带 sourceEnvelope/quality/fetchedAt/licenseScope；首刀为单源透传 pilot，跨源校验 / 快照尚无 → 尚未达「资产化」、亦非裸字段代理）；限频 30/min、DH 无缓存 → 低频消费 + symbols 本地缓存。后续 crypto 资产沿用同一命名空间。

8. 推进节奏（与 Provider 配置中心 R1/R2/R3 对齐，附 DH 现实排序）

阶段	DH 交付	DH 现实排序	FinBayes 动作
S0（硬 gate）	确认能力域扩展范围 + 注册表字段口径。可达性实测已于 2026-06-23 完成：5 家首选 API 主机层均可达、无地理封锁（OANDA 仅代理可达）；账户/取数级待 key 验。	评审 + 可达性（网络层已闭合）。	提供 §6 尽调 + §5 就绪度 + §7 字段建议。
S1	把宏观 + crypto 商品化 provider 元数据纳入注册表，暴露 §7.3 读取接口。	配置中心 R2 之后，让位 DH P0（KOL / TM 信源）。	改弹性链从 DH 读注册表 → 本地合成 runtime policy（非「替换本地默认」）。
S2（首刀，DH 2026-06-23 已接入 Plan1）	DH 已接入 CoinAnk 套餐1（aggregate 清算：summary/history/symbols），首刀产出出处信封 + license + 双时间戳封装的单源透传清算数据（pilot）——跨源校验 / 可回测快照尚无（DH 拟后续加快照表 + 跨源印证），按 ADR-0005 §3 灰带门槛尚未达「资产化」；复用现有 Open API 鉴权；DH 持 key、30/min 透传无缓存。注：此链路使 DH 成为 FinBayes 清算数据的运行单点（透传、无缓存），属 DH 自愿承担的运行依赖、超出「注册表不担可用性」口径——须配降级路径，且 FinBayes 应保留 coinank.py 直连作兜底（不能因「降为不启用」而无本地后备）。	新 WP，Open API 暴露层排 DH R2+，不抢 KOL 总控室 / TM 信源 P0；逐笔爆仓 / CVD（套餐3）/清算热力图（套餐4）升级后再加。	✓ 透传通路已打通并 live 验证：dh_crypto.py 消费端（四读取 + 根 JSON 解析 + 保留 sourceEnvelope/quality + 错误映射）接进 crypto 工具清算动作（vendor_sources seam + _render_liquidations），清算从 no_source → 真实跨所聚合数据带出处 + license 边界，内测群真实提问触发并贯通；as_of 只取数据时间 / 失败原因不被弹性链吞 / 非 dict 防御 / 缺多空拆分诚实标「—」。工程执行证据（commit / 测试条数 / lint / gateway 进程态 / key 后缀）留工程仓，不入本任务书正文。此为透传 pilot，资产化（跨源校验 / 快照）属 S2 后续。
S3	逐步纳入股 / 期 / 汇 provider 与资产。	P3 量级，不进第一阶段主线。	复用同一弹性取数层推广到非 crypto。

9. 验收标准

• provider 注册表可按能力域 / 市场查询，含凭据引用规范（非明文）、代理出口建议、可达性证据；
• FinBayes 能从 DH 读注册表并本地合成 runtime policy、自持可用性（行为不退化）；
• 在 S0 可达性实测通过的前提下，至少一个 vendor 经 DH Open API 产出带出处信封的差异化资产（校验 / 质量标签，非裸转发）；
• 商品化数据仍由 FinBayes 直连、DH 不路由（红线不破）；
• DH 产出资产带来源 / 双时间戳 / 质量元数据，FinBayes 诚实降级链不被绕过。

10. 工作切分（供 DH 参考，DH 评审后自行编排）

DH 现有 agent 族是 analyst / social / forward，没有下列角色——这是建议的工作分解，DH 评审 accept 后由 DH 决定新建 agent 还是由人承接，勿当现成 agent 派活：

建议角色	任务	输出
provider 注册录入	把多市场 provider 录入注册表、分能力域、绑凭据引用与代理出口建议。	provider 注册表（§7.1）。
消费契约设计	设计并暴露 §7.3 读取接口。	下游消费契约 + 字段字典。
vendor 资产化接入	接入 vendor 产差异化资产（校验 + 出处），经 Open API 产出。	差异化资产 Open API + 出处信封。
可达性实测	用 1080 代理对 §6 首选 vendor 打真实 API 验可达性（S0 一次性动作，非常驻）。	可达性实测结论（回填 §6）。

11. 状态与待确认事项

• DH 已接受 6 条对齐项（2026-06-23）：条件 = 第一刀以 GET /v1/open/crypto/liquidations 产出资产化清算数据（非 CoinAnk 原始字段代理）；DH 复用现有 Open API 鉴权 + 出处信封；CoinAnk 作 DH 持凭据的候选 provider 进 Provider 配置中心；排 DH R2+，不抢 KOL / TM 信源 P0。
• DH 已确认 4 项（2026-06-23 回复，曾标 ④ 最关键）：
  • ① 套餐字段 / 粒度 / 历史深度：套餐1 清算 = aggregate（聚合面，非逐笔流），三端点——summary（实时汇总，1h/24h 窗口；字段 totalTurnover / longTurnover / shortTurnover / longRatio / shortRatio + 最大清算单摘要 symbol/exchangeName/positionSide/tradeTurnover/timestamp）、history（历史桶，mode=aggregated 币种级 / mode=pair 所×对；粒度 4h/6h/8h/12h/1d；size≤500）、symbols（支持对）。逐笔爆仓订单属 CoinAnk Plan3，不在套餐1。
  • ② 授权：生产采 DH 服务端托管 CoinAnk key（链路 FinBayes → DH Open API → DH server → CoinAnk），FinBayes 不碰 key；DH 生产已验证该 key 可成功调 CoinAnk（无 IP/域绑定阻断）。key 是否容多服务/多实例/多 IP 仍建议团队向 CoinAnk 做条款确认，架构上 DH 统一管。
  • ③ 限频：套餐1 = 30 请求/分钟，DH 当前实时透传、无快照缓存层 → FinBayes 初期须低频：summary 30–60s/次（按 baseCoin 控量）、history 按分析周期拉取不轮询、symbols 本地缓存低频刷新。DH 拟后续加周期同步 + 快照表，让 FinBayes 默认读快照。
  • ④ 派生数据再分发边界 — 已澄清：DH 响应显式带 licenseScope: internal_ecosystem_derived_asset_pending_coinank_terms_confirmation。口径 = 内部接入/验证 + 作 FinBayes 判断证据：现在即可；对外产品化 / 转卖 / 公开分发：须先取得 CoinAnk 书面授权边界确认；DH 响应的 sourceEnvelope / quality / fetchedAt 须随判断证据一并留存。→ 「DH 集成一次、内部接入 / 验证 + 作 FinBayes 判断证据」成立；但生态内多下游分发（含 Trading Matrix 等其他消费方）仍待 CoinAnk 书面授权边界确认——DH 作 key 持有方登记该再分发敞口，未拿到书面前不得对外产品化 / 转卖 / 公开分发。此前「若禁再分发则方案不成立、回退 FinBayes 直配 key」的分支未触发；coinank.py 直连维持后备（建议保留作 DH 透传链的本地兜底，非纯休眠）。
• DH 已给 handoff 契约 + dh_crypto.py 已实现（2026-06-23）：DH 交付 handoff 文档（Base URL https://dh-api.topquant.org/v1、X-API-Key、四端点、summary/history 精确样例、403/401/429 语义）。FinBayes 据此实现 dh_crypto.py（b197f31 本地）：四读取 + 根 JSON 直解析（无 data 外层）+ 保留 sourceEnvelope/quality 作证据/审计/回退 + 错误映射（401=auth / 403=权限未放行（非解析失败） / 429=rate_limited / quality≠ready=empty 触发回退）；17 离线单测 + 本地 contract 测试钉死 handoff 样例。live verify=403（权限未放行）→ DH 放行 key 的 crypto scope 后重验：三端点（summary / history / symbols）全 200、真实数据经解析器、信封字段全保留（凭据 / key 细节留工程仓）。已接进 crypto 工具（b197f31+1aa7e27 本地）：清算动作走 vendor_sources seam → DH summary，_render_liquidations 渲染跨所聚合（多空清算额 + 最大单 + Plan1 warning + license 边界），清算从 no_source → 真实数据；端到端 live 渲染通过、经 5 方对抗审计 + 整改（as_of 只取数据时间 / resilient_fetch 保留失败原因 / 非 dict quality·windows·缺 sourceEnvelope 守卫 / 渲染缺多空拆分诚实标「—」）、测试 / lint 全过（条数留工程仓）。S2 首刀透传通路已打通并上线 live 验证（数据 DH→dh_crypto→渲染→答案贯通；非资产化闭环——跨源校验 / 快照属后续）。gateway 进程态 / commit 留工程仓、不入本任务书正文。history/pair/symbols 已在模块、未来如需可加工具动作。
• 聚合 vendor 选型 — 已定（owner 2026-06-23）：首个 = CoinAnk 初级套餐、走 DH 集成；Coinglass 留作后续选项（暂不对账）。后续升套餐 + 加 provider。
• 凭据归属 — 已定：CoinAnk key 由 DH 持有，FinBayes 经 DH Open API 消费（不直配 key）；FinBayes coinank.py 直连接入点降为后备 / 不启用。
• 代理出口：被墙 / 海外源经哪个出口；S0 可达性实测已闭合（2026-06-23）——5 家首选 API 主机层均可达、无地理封锁（OANDA 直连超时、仅代理可达，余 4 家代理+直连均通）；剩 key/账户级取数待激活后验。
• 韩股缺口 — 暂缓（owner 2026-06-24）：四市场其余先行；待「延迟行情可否接受 / 实时是否硬需 / 预算上限」三前提明确后再起（候选见 §6.3：券商 OpenAPI / KRX 自建 / Twelve Data Pro / 延迟源兜底）。不阻塞 DH 会签与首刀。
• 富途大陆 LV2 判定：经代理出海是否被降级 LV1，需实测。
• Polygon/Massive 期货覆盖：核实是否提供期货；用可配置 base URL 应对域名迁移。
• API 形态 — 已定（§7.3）：并入 DH 现有 Open API 同一表面 + asset-family 命名空间（同 host / X-API-Key / 出处信封）；REST 优先，MCP / bulk export 由 DH 按需。