オラクルと決済

公開サーフェスの理由

予測マーケットはトレーダーが自分でアウトカムを確認できる場合にのみ機能します。解決結果はモデレーター（またはそれ以上）が提案し、別の管理者（またはスーパー管理者）が確認します。確定パイプラインを公開し、SatoriExへの信頼に依存しないようにしています。

• 誰でも現在異議申し立て期間中のマーケットを一覧表示し、提案された勝者を読むことができます。
• 誰でもクローズしたがまだ確定されていないマーケットを一覧表示できます — ウォッチドッグに有用。
• 誰でも歴史上の全ての確定・決済済みマーケットを勝利アウトカムとともに一覧表示できます。

公開エンドポイント

3つのGETエンドポイントが透明性サーフェス全体を担います。認証は不要です。全て標準のpageとsizeパラメータでページネーションし、カテゴリと検索クエリでフィルタリングできます。

# 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をポーリングします。

レスポンスの形式

3つのエンドポイントはいずれも同じエンベロープを返します — マーケットのページネーションリスト（各アウトカム、現在価格、異議件数、異議終了時刻付き）。フィールド名は基礎となるマーケットモデルに対応します。

{
  "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、フレッシュなnonceをカバーします。リプレイの試みは拒否されます。
• スーパー管理者または信頼されたオラクルWebhookのみが有効な署名を生成できます。
• 2人による承認は依然として適用されます — 全ライフサイクルについては確定コンセプトページをご覧ください。

信頼モデルの概要

異なるアクションは異なる権限を必要とします。読み取れるものは全て公開です。書き込めるものは証拠金付きユーザーアカウント（異議申し立て）または署名済み管理者アクション（確定）が必要です。

2人による承認はサーバーサイドで強制されます。同じ管理者アカウントが提案と確認の両方を行うことはできません。