核心概念

預言機與結算

預言機是 SatoriEx 透明的清算介面。三個公開端點讓任何人——使用者、開發者、記者、稽核人員——無需帳戶、API 金鑰或對我們的信任，即可驗證每筆待定和已完成的裁決。

想了解概念背景？

若您想了解裁決作為平台功能的含義——階段、爭議窗口、賠付——請先閱讀裁決概念頁面。閱讀：裁決與清算

Coming from Polymarket?

Polymarket's resolution uses UMA's Optimistic Oracle — anyone can propose with a $750 bond, anyone can dispute, escalations route to a DVM token-holder vote. SatoriEx uses an optimistic-bonded model with similar mechanics scaled for our market: any KYC-verified user can propose an outcome under bond, anyone can file a $10 dispute (refunded + $5 reward if upheld), and a tier-2 escalation routes to an independent voter panel — not the original proposer — for the final decision. Public endpoints make every step auditable, and the proposer's bond is slashed to the dispute reserve when an upheld escalation overturns the outcome.

為何設立公開介面

預測市場只有在交易者能夠自行驗證結果時才能運作。解決結果由版主（或更高權限）提議，由獨立管理員（或超級管理員）確認。我們公開裁決流程，使其不依賴對 SatoriEx 的信任。

任何人均可列出目前處於爭議窗口的市場，並查看提議的獲勝結果。
任何人均可列出已關閉但尚未裁決的市場——對監察機構非常有用。
任何人均可列出歷史上所有已裁決和已清算的市場，附帶獲勝結果。

公開端點

三個 GET 端點承載整個透明度介面。均無需身份驗證。所有端點均使用標準 page 和 size 參數分頁；結果可按類別和搜尋關鍵字篩選。

端點	回傳內容	用途
GET /oracle/propose	已過關閉時間、等待提議獲勝結果的活躍市場。	監控即將裁決的市場。
GET /oracle/verify	處於 2 小時爭議窗口中、附有提議獲勝結果的市場。	稽核待定裁決；如有異議可提出爭議。
GET /oracle/settled	已裁決和已清算的市場，附帶獲勝結果及裁決時間戳記。	供分析、報告或第三方資料流使用的歷史紀錄。

# All three endpoints are public — no auth required.
curl https://staging.satoriex.io/api/v1/oracle/verify?page=1&size=50
curl https://staging.satoriex.io/api/v1/oracle/propose
curl https://staging.satoriex.io/api/v1/oracle/settled?category=politics

這些端點設計上可緩存。監察服務通常在爭議窗口期間每隔幾分鐘輪詢 /verify。

回應格式

三個端點均回傳相同的封包——市場的分頁列表，每個市場附有其結果、當前價格、爭議數量及爭議結束時間。欄位名稱與底層市場模型一致。

{
  "code": 0,
  "data": {
    "markets": [{
      "id": "mkt_01H...",
      "title": "Will the central bank cut rates in May?",
      "status": "resolved",
      "winning_outcome_id": "out_01H...",
      "resolved_at": "2026-05-08T14:02:31Z",
      "dispute_end_time": "2026-05-09T14:02:31Z",
      "dispute_count": 0,
      "outcomes": [{ "id": "out_01H...", "label": "Yes", "price_bps": 7400 }]
    }],
    "total": 1247,
    "page": 1,
    "size": 50
  }
}

裁決操作

讀取預言機是公開的，但寫入則不然。唯一的寫入端點 POST /oracle/resolve 接受獲勝結果及對裁決酬載的 HMAC-SHA256 簽名。

POST /api/v1/oracle/resolve
Content-Type: application/json

{
  "market_id":           "mkt_01H...",
  "winning_outcome_id":  "out_01H...",
  "timestamp":           "2026-05-11T14:02:31Z",
  "signature":           "<HMAC-SHA256 over: market_id:winning_outcome_id:unix_ts>"
}

# Signature pre-image uses ':' as delimiter and the unix epoch
# seconds form of timestamp. Requests older than 5 minutes are
# rejected as replay-suspect.

需要伺服器端共享密鑰——切勿在客戶端程式碼中暴露簽名金鑰。
簽名涵蓋 market_id、winning_outcome_id 及新鮮隨機數；重放攻擊將被拒絕。
只有超級管理員或受信任的預言機 Webhook 才能產生有效簽名。
雙人審批仍然適用——請參閱裁決概念頁面了解完整生命週期。

信任模型概覽

不同操作需要不同的權限。任何您可以讀取的內容均為公開；任何您可以寫入的內容均需要已繳保證金的使用者帳戶（爭議）或已簽名的管理員操作（裁決）。

功能	可執行者
讀取待定和已清算的裁決	任何人——無需帳戶
讀取任何裁決的公開爭議	任何人——無需帳戶
對提議的裁決提出爭議	任何繳納 $10 USDC 保證金的使用者
為市場提議獲勝結果	版主或更高權限（首位提議者）
確認提議的裁決	獨立管理員（或更高權限）——不同於提議者

雙人審批在伺服器端強制執行。同一管理員帳戶不能同時提議並確認。

為何設立公開介面

公開端點

回應格式

裁決操作

信任模型概覽

相關資源