端点发现
这些表格是金融、市场、宏观、能源与大宗商品界面的面向人类的路由图。完整的请求与响应 schema 保留在生成的 OpenAPI 页面中;下面的方法与路由已对照proto/worldmonitor/market/v1/service.proto 和 proto/worldmonitor/economic/v1/service.proto 核验。除特别说明外,路由均为服务基路径下生成的 sebuf REST RPC,并可在实时 RPC 兜底运行之前进行 bootstrap 预填充。
MarketService 路由
EconomicService 路由
市场监控
可自定义的市场自选列表
市场(Markets)面板支持用户自定义的股票和商品代码列表,允许分析师跟踪默认指数集合之外的特定品种。自选列表接受多种格式:- 指数代码:
^GSPC、^DJI、^IXIC - 股票代码:
AAPL、BRK-B、NVDA - 大宗商品:
GC=F(黄金)、CL=F(原油) - 加密货币对:
BTC-USD、ETH-USD - 友好标签:
TSLA|Tesla Inc(用管道符分隔的显示名称)
SYMBOL|Label 格式。自选列表状态存储在 localStorage 中,键名为 wm-market-watchlist-v1(最多 50 个代码,自动去重)。变更会发出 wm-market-watchlist-changed CustomEvent,用于在面板之间实时同步而无需刷新页面。
宏观信号分析(市场雷达)
市场雷达面板根据 7 个独立信号计算出一个综合的 BUY/CASH 判定,这些信号全部来源于免费 API(Yahoo Finance、mempool.space、alternative.me):
整体判定要求已知信号中 ≥57% 为看涨(BUY),否则为 CASH。数据未知的信号不计入分母。
VWAP 计算 —— 成交量加权平均价(Volume-Weighted Average Price)由 30 天窗口内对齐的价格/成交量配对计算得出。价格或成交量为 null 的配对会被一起排除,以防止指数错位:
投资与 FDI
海湾 FDI 投资数据库
Finance 变体包含一个精选数据库,记录了沙特阿拉伯和阿联酋在全球关键基础设施领域的 64 项重大外商直接投资。这些投资覆盖 12 个行业:
每项投资记录了投资主体(DP World、Mubadala、PIF、ADNOC、Masdar、Saudi Aramco、ACWA Power 等)、目标国家、地理坐标、投资金额(美元)、持股比例、运营状态和年份。投资面板提供按国家(SA/UAE)、行业、主体和状态的可筛选视图 —— 点击任意行会将地图导航到投资位置。
在地球上,投资以缩放气泡的形式显示:≥500 亿美元的项目(NEOM)以最大尺寸渲染,而低于 10 亿美元的投资使用较小的标记。颜色编码状态:绿色表示运营中,琥珀色表示建设中,蓝色表示已宣布。
加密货币与稳定币
稳定币锚定监控
通过 CoinGecko API 监控五种主要稳定币(USDT、USDC、DAI、FDUSD、USDe),缓存时间为 2 分钟。每种币相对于 1.00 美元锚定的偏离程度决定其健康状态:
面板聚合稳定币总市值、24 小时成交量和整体健康状态(HEALTHY / CAUTION / WARNING)。
coins 查询参数用于选择返回哪些稳定币。重复形式(?coins=tether&coins=dai)与逗号连接形式(?coins=tether,dai)等价。ID 会被去除空白、转为小写、去重,并通过 ^[a-z0-9][a-z0-9-]{0,63}$ 验证;单次请求最多 25 个 ID。
不带参数与带参数的请求开销不同,这是有意为之:
coins为空:从缓存快照返回五种默认稳定币,绝不调用上游服务商。- 指定 ID:优先由该快照作答;只有快照未包含的 ID(包括默认五种之外的稳定币)才会访问 CoinGecko,且合并为一次批量请求,受限流保护并单独缓存。
dataStatus——OK、PARTIAL或UNAVAILABLE。它表示数据覆盖情况;summary.healthStatus表示锚定健康状况,二者相互独立。unresolved—— 每个请求了但未出现在响应中的 ID 各一条,并附原因:INVALID_ID(不符合 CoinGecko ID 格式)、OVER_CAP(超出 25 个 ID 上限,从未查询)、NOT_FOUND(服务商已应答,确无此币)或PROVIDER_ERROR(查询失败,因此该 ID 是未知而非不存在)。
BTC ETF 资金流向估算
通过 Yahoo Finance 的 5 日图表 API 跟踪十只现货比特币 ETF(IBIT、FBTC、ARKB、BITB、GBTC、HODL、BRRR、EZBC、BTCO、BTCW)。由于 ETF 资金流向数据需要昂贵的终端订阅,系统通过公开可用的信号估算资金流向:- 价格变化 —— 当日收盘价与前一交易日收盘价对比决定方向
- 成交量比率 —— 当前成交量 / 滚动平均成交量,衡量市场信心
- 资金规模 ——
volume × price × direction × 0.1提供粗略的美元估算
能源与大宗商品
石油与能源分析
石油与能源面板通过美国能源信息署(EIA)API 跟踪四个关键指标:
趋势检测将周环比变化超过 ±0.5% 标记为上升或下降,阈值内的平稳读数显示为稳定。结果在客户端缓存 30 分钟。该面板为地缘政治分析提供能源市场背景 —— 价格飙升通常与受监控冲突地区的供应中断和咽喉要道关闭相关。
央行与贸易
BIS 央行数据
经济面板整合了来自国际清算银行(BIS,央行中的央行)的数据,提供三个互补的数据集:
数据通过
economic/v1 proto 服务中的三个专用 BIS RPC(GetBisPolicyRates、GetBisExchangeRates、GetBisCredit)获取。每个数据集使用独立的熔断器,缓存 TTL 为 30 分钟。面板将政策利率渲染为带有 spark bars 的排序表格,汇率带有方向性趋势指示器,信贷/GDP 渲染为排序列表。BIS 数据的新鲜度在情报缺口系统中跟踪 —— 过期或失败会以明确的警告呈现,而非静默缺口。
WTO 贸易政策情报
贸易政策面板提供对全球贸易限制、关税和壁垒的实时可见性 —— 这对于跟踪经济战、制裁影响和供应链中断风险至关重要。提供六种数据视图:trade/v1 proto 服务定义了六个 RPC。WTO 支撑的限制、关税、流量与壁垒 RPC 各自有独立的熔断器(30 分钟缓存 TTL)和 upstreamUnavailable 信号,用于在 WTO 端点暂时不可达时优雅降级。GetCustomsRevenue 从 Railway seed 提供美国财政部关税数据(免费 API,无需密钥),ListComtradeFlows 提供 UN Comtrade 战略大宗商品流量。该面板在 full/geopolitical、finance 和 commodity 变体上可用。WTO 数据以 wto_trade 接入数据新鲜度跟踪器,财政部收入以 treasury_revenue 接入,任一数据源过期时会触发情报缺口警告。关于确切的方法、路由和门控说明,请参见贸易政策。
在贸易政策活跃变化期间,收入标签页尤为相关。继 2025-2026 年关税升级后,美国海关关税收入从约 70 亿美元/月(2025 年前)飙升至 270-310 亿美元/月。WTO 年度关税数据滞后约一年,因此月度财政部收入数据提供了对关税政策实际财政影响的近实时可见性。收入标签页显示财年累计摘要,使用匹配的财政月份数进行同比对比(例如 FY2026 10 月-2 月 vs FY2025 10 月-2 月),并提供月度表格,高亮显示收入超过上年月均值两倍的月份。在未配置 WTO API 密钥的桌面端,收入标签页仍可访问,因为财政部数据无需身份验证。
供应链
供应链中断情报
供应链面板跨三个互补维度提供对全球物流风险的实时可见性 —— 战略咽喉要道健康状况、运输成本趋势和关键矿产集中度 —— 从而能够及早发现会级联演变为经济和地缘政治后果的中断事件。 咽喉要道标签页 —— 通过交叉比对实时航行警告与 AIS 船舶中断数据,监控 9 条战略水道(苏伊士运河、马六甲海峡、霍尔木兹海峡、曼德海峡、巴拿马运河、台湾海峡、直布罗陀海峡、博斯普鲁斯海峡、达达尼尔海峡)。每个咽喉要道获得一个中断评分(0–100),由三部分公式计算得出:基线威胁等级(战区 / 关键 / 高 / 较高 / 正常)、活跃警告数量(有上限贡献)和 AIS 拥堵严重程度 —— 映射为颜色编码的状态指示器(绿/黄/红)。咽喉要道识别使用文本证据匹配(以主要术语和区域术语进行关键词评分),然后才回退到地理邻近度,以防将提及某一咽喉要道但地理上更接近另一咽喉要道的事件错误分类。数据缓存 TTL 为 5 分钟,以实现近实时感知。 运输费率标签页 —— 跟踪两个美联储经济数据(FRED)序列:深海货运生产者价格指数(PCU483111483111)和货运运输服务指数(TSIFRGHT)。统计尖峰检测将异常价格变动与近期历史进行对比标记。内联 SVG sparklines 一目了然地呈现 24 个月的费率历史。缓存 1 小时,以反映底层数据的每周发布节奏。
关键矿产标签页 —— 将**赫芬达尔-赫希曼指数(HHI)**应用于 2024 年对科技和国防制造至关重要的矿产的全球生产数据 —— 锂、钴、稀土、镓、锗等。HHI 量化供应集中度风险:由单一生产者主导的市场得分接近 10,000,而完全分散的市场得分接近 0。每种矿产显示排名前 3 的生产国及其市场份额百分比,标记出代表战略脆弱性的单一国家依赖(例如中国在稀土加工中的主导地位)。此标签页使用静态生产数据,缓存 24 小时,无外部 API 依赖。
该面板在 full/geopolitical、finance 和 commodity 变体上可用,并与基础设施级联模型集成 —— 当咽喉要道中断与受影响贸易路线的高矿产集中度风险同时发生时,组合信号会馈入收敛检测。
另请参阅海事情报,了解船舶跟踪和暗船检测。