monitor-supply-chain-stress

当用户询问广泛的航运压力、承运商市场承压情况，或在深入分析特定瓶颈或航线之前询问供应链是否出现中断迹象时，使用此技能。该接口返回一个综合压力评分以及构成该评分的承运商/指数输入数据。

身份认证

服务端调用者（代理、脚本、SDK）必须通过 X-WorldMonitor-Key 头提供 API 密钥。Authorization: Bearer ... 用于 MCP/OAuth 或 Clerk JWT —— 不适用于 原始 API 密钥。

X-WorldMonitor-Key: wm_0123456789abcdef0123456789abcdef01234567

在 https://www.worldmonitor.app/pro 申请密钥。

接口

GET https://worldmonitor.app/api/supply-chain/v1/get-shipping-stress

参数

名称	位置	必填	形态	备注
jmespath	query	否	JMESPath，长度 <= 1024 字符	服务端投影，例如 {score: stressScore, level: stressLevel, carriers: carriers[].{name: name, changePct: changePct}}

响应形态

{
  "carriers": [
    {
      "symbol": "BDRY",
      "name": "Breakwave Dry Bulk Shipping ETF",
      "price": 12.34,
      "changePct": 3.2,
      "carrierType": "etf",
      "sparkline": [11.9, 12.1, 12.34]
    }
  ],
  "stressScore": 64,
  "stressLevel": "elevated",
  "fetchedAt": 1783250000000,
  "upstreamUnavailable": false
}

stressScore 取值范围为 0-100，数值越高代表中断越严重。upstreamUnavailable: true 表示市场数据源失败或陈旧缓存已耗尽；不要将空的承运商列表解读为"无压力"。

完整示例

curl -s -H "X-WorldMonitor-Key: $WM_AP…