Research · Live

JSON API

Static JSON endpoints — no runtime, no auth, no rate limit. Use as a stable citation anchor.

Quick start

curl https://x-forecast.com/api/v1/weights.json | jq .groups.base
curl https://x-forecast.com/api/v1/nav.json | jq '.history[-1]'

GET /api/v1/weights.json

Current base / bull / bear weights + effective date

sample response

{
  "version": "v1",
  "effective_date": "2026-06-01",
  "groups": {
    "base": { "a_cn_csi300": 0.10, ... },
    "bull": { ... },
    "bear": { ... }
  },
  "generated_at": "2026-05-26T12:00:00Z"
}

GET /api/v1/nav.json

Daily NAV time series for all 3 groups since inception

sample response

{
  "version": "v1",
  "last_updated": "2026-05-25",
  "inception": "2025-12-01",
  "n_points": 125,
  "history": [
    { "date": "2025-12-01", "base": 100.00, "bull": 100.00, "bear": 100.00 },
    ...
  ]
}

GET /api/v1/view.json

Current month macro view + falsification conditions

sample response

{
  "version": "v1",
  "effective_date": "2026-06-01",
  "macro_view": "起点位置 (2026-05): 美联储 5 月 FOMC 维持利率...",
  "falsification": ["Bull 跑输 Base 超过 2%", ...]
}

Stability promise

v1 endpoints frozen forever; new fields are additive only
Breaking changes will live at /api/v2/ with v1 still served
All responses regenerate at build time — no runtime, no cost
CORS: open (Access-Control-Allow-Origin: *) — designed for academic / journalism citation