Oracle & Resolusi

Mengapa permukaan publik

Pasar prediksi hanya berfungsi jika pedagang dapat memverifikasi sendiri hasilnya. Hasil resolusi diusulkan oleh moderator (atau lebih tinggi) dan dikonfirmasi oleh admin terpisah (atau super-admin). Kami mengekspos pipeline resolusi agar tidak ada yang bergantung pada kepercayaan terhadap SatoriEx.

• Siapa pun dapat mencantumkan pasar yang saat ini berada dalam jendela sengketa dan membaca pemenang yang diusulkan.
• Siapa pun dapat mencantumkan pasar yang telah ditutup tetapi belum diselesaikan — berguna bagi pengawas.
• Siapa pun dapat mencantumkan setiap pasar yang telah diselesaikan dan disetel dalam sejarah, beserta hasil pemenangnya.

Endpoint publik

Tiga endpoint GET membawa seluruh permukaan transparansi. Tidak ada yang memerlukan autentikasi. Semuanya dipaginasi dengan parameter page dan size standar; hasil dapat difilter berdasarkan kategori dan kueri pencarian.

# 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

Endpoint ini sengaja dapat di-cache. Layanan watchdog biasanya melakukan polling /verify setiap beberapa menit selama jendela sengketa.

Bentuk respons

Ketiga endpoint mengembalikan amplop yang sama — daftar pasar yang dipaginasi, masing-masing dengan hasilnya, harga saat ini, jumlah sengketa, dan waktu akhir sengketa. Nama field sesuai dengan model pasar yang mendasarinya.

{
  "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
  }
}

Tindakan resolusi

Membaca oracle bersifat terbuka. Bertindak atasnya tidak. Satu-satunya endpoint yang bermutasi, POST /oracle/resolve, menerima hasil pemenang dan tanda tangan HMAC-SHA256 atas payload resolusi.

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.

• Memerlukan rahasia bersama sisi server — jangan pernah mengekspos kunci penandatanganan dalam kode klien.
• Tanda tangan mencakup market_id, winning_outcome_id, dan nonce baru; upaya pemutaran ulang ditolak.
• Hanya super-admin atau webhook oracle tepercaya yang dapat menghasilkan tanda tangan yang valid.
• Persetujuan dua orang tetap berlaku — lihat halaman konsep Resolusi untuk siklus hidup lengkapnya.

Model kepercayaan sekilas

Tindakan yang berbeda memerlukan hak istimewa yang berbeda. Apa pun yang dapat Anda baca bersifat publik; apa pun yang dapat Anda tulis memerlukan akun pengguna dengan jaminan (sengketa) atau tindakan admin yang ditandatangani (resolusi).

Persetujuan dua orang diterapkan di sisi server. Akun admin yang sama tidak dapat mengusulkan sekaligus mengonfirmasi.