一訊號全對象最新讀數 + 篩選欄 band/frequency_label/percentile(?signal_id=<>)——跨站(river gauge)...

{ "discoverable": true, "method": "GET", "queryParams": { "signal_id": "required" }, "type": "http" }

{ "additionalProperties": true, "properties": { "_citation": { "description": "離線可驗證引用:{statement_type, not_advice:bool, claim, fact, source, record_hash, signature(Ed25519), key_id, issuer_DID(did:key), verify_url}。零信任自驗的信任根", "type": [ "object", "null" ] }, "count": { "description": "rows 筆數(該訊號的全對象數)", "type": "integer" }, "grade": { "description": "資料分級誠實揭露(如 \"screening-level, not decision-grade\")", "type": [ "string", "null" ] }, "nature": { "description": "中立聲明:GAUGE 只提供觀測與走勢描述,不判斷、不預測、不建議", "type": "string" }, "rows": { "description": "★核心交付:一訊號全對象最新讀數,單筆形狀見 items(欄位在【這裡面】,不在頂層)", "items": { "additionalProperties": true, "properties": { "change": { "description": "變動。★按 metric 巢狀:change.<metric>={delta, direction};另有純量 change.period(如 \"vs_previous\")。direction 枚舉 rising/falling/stable", "type": [ "object", "null" ] }, "current": { "description": "當前讀數。★內部 metric 結構隨 signal 而異(crypto→{price_usd,volume_24h,...};shipping→{wind_kmh,wave_height_m,...})。單位以欄名後綴標示,另見 standard_ruler.unit", "type": [ "object", "null" ] }, "data_age_hours": { "description": "★採集當下凍結的齡(0=同小時),僅供參考——採集器停擺時本欄會凍結不動。判新鮮請一律用 provenance.age_hours_now(request-time 現算齡)與 provenance.freshness;門檻依據見 provenance.freshness_basis", "type": [ "number", "null" ] }, "entity": { "description": "監測對象 id(如 btc / us / hormuz);完整可查清單見免費 /gauge/catalog 或 /gauge/preview", "type": "string" }, "entity_name": { "description": "對象人類可讀名", "type": [ "string", "null" ] }, "hash_core_version": { "description": "record_hash 的 core 契約版本(現行 3);離線重算時據此選對 core 組法", "type": [ "integer", "null" ] }, "lifecycle": { "description": "生命週期區塊(state/birth_at/end_at/death_type/context…);★屬 record_hash v3 core 的一部分,離線重算必須帶上。非 lifecycle 類線為 null", "type": [ "object", "null" ] }, "observed_at": { "description": "資料真實觀測時間 ISO-8601", "type": "string" }, "ots_status": { "description": "OpenTimestamps 比特幣錨定狀態:pending(尚未錨定,record_hash+Ed25519 仍即時可驗) / anchored(已上鏈) / null", "type": [ "string", "null" ] }, "previous": { "description": "上一期讀數(current 的 metric 子集;或 {note} 說明無前值)", "type": [ "object", "null" ] }, "record_hash": { "description": "sha256:<64hex>(A 契約 v3,綁數值+provenance)。★離線重算 core 需要完整記錄欄位(snapshot_date/current/source_ref/source_tier/完整 standard_ruler/sources,以及 lifecycle 類線的 lifecycle)=主力 /gauge 交付的形狀;版本看同回應的 hash_core_version;$0.01–0.03 的單維外掛(ruler/calibrated/strata/history)交付的是【投影】,同一枚 hash 請以免費 /gauge/verify 覆核(我方重讀 DB 重算),或改買 /gauge 取完整 core 自行離線重算。無法雜湊時 null", "type": [ "string", "null" ] }, "record_hash_verifiable": { "description": "{mode:offline|via-endpoint, note}。★由伺服器【實算】判定本回應能否零連網重算出自己的 record_hash:offline=payload 含完整 canonical core;via-endpoint=投影過的交付(為控制體積省略部分 core 欄),請以免費 /gauge/verify 覆核或改買 /gauge", "type": [ "object", "null" ] }, "signal_id": { "description": "調取標籤(屬.種 ASCII 雙名法,如 crypto.spot / macro.unemployment / shipping.route-disruption);完整可查清單見免費 /gauge/catalog", "type": "string" }, "snapshot_date": { "description": "ISO-8601 date-time(UTC,如 2026-07-24T00:00:00.000Z;當日切齊零時)", "type": "string" }, "source_agreement_cv": { "description": "多源一致性變異係數(越小越一致);單源或不適用→null", "type": [ "number", "null" ] }, "source_ref": { "description": "官方來源 URL(provenance)", "type": [ "string", "null" ] }, "source_tier": { "description": "來源層級:T1(第一手官方) / T2 或 T2-<子類,如 T2-exchange>(可觀察·策展) / screen-viewpoint;null=未定級(見 unverified)", "type": [ "string", "null" ] }, "sources": { "description": "來源清單 [{name, value, weight, as_of, role}];多源時佐證 current", "items": { "type": "object" }, "type": [ "array", "null" ] }, "standard_ruler": { "description": "官方標準尺(band/閾值/normalized_index/pct_to_action;含 unit 與出處;無官方尺→null)。★內部結構隨 signal 而異", "type": [ "object", "null" ] }, "stat_ruler": { "description": "統計尺(近5年同季節經驗百分位落點;無統計→null)", "type": [ "object", "null" ] }, "strata": { "description": "統計分層(近5年同季節各官方層占比 + 現值落層;無統計→null)", "type": [ "object", "null" ] }, "summary_zh": { "description": "人類可讀總結(一句話 + 官方尺深淺 + 統計落點)", "type": [ "string", "null" ] }, "trend_7d": { "description": "近7期走勢點陣列;[]=此 signal 不適用或尚無序列(非錯誤)", "items": { "type": "object" }, "type": [ "array", "null" ] }, "unverified": { "description": "true=來源未定級(source_tier 為 null);買家/代理可據此過濾未定級資料", "type": "boolean" } }, "type": "object" }, "type": "array" }, "scope": { "description": "範圍與邊界誠實聲明(監測非預報、情報非指揮、可驗證保證的邊界)", "type": [ "string", "null" ] } }, "required": [ "count", "rows" ], "type": "object" }