OREStats API v1

{
  "activeSubs": 17,
  "oreNow": 0.1,
  "nextThreshold": 100,
  "oreAtNextThreshold": 0.2,
  "treasury": "...",
  "oreMint": "..."
}

• ownerPubkey— Solana pubkey แบบ base58 ที่จะเป็นเจ้าของ API key

{ "ownerPubkey": "..." }

{
  "nonce": "ore-pay-...",
  "priceOre": 0.1,
  "instructions": { "to": "...", "memo": "ore-pay-...", "amountBaseUnits": "10000000000", "mint": "..." },
  "expiresAt": "..."
}

• nonce— ค่าที่คืนจาก POST /subscribe
• txSig— ลายเซ็น SPL transfer ที่ยืนยันแล้วซึ่งมี memo จากขั้นตอนที่ 1
• ownerPubkey— ต้องตรงกับกระเป๋าเงินที่จ่าย (และส่งผ่าน POST)

{ "nonce": "...", "txSig": "...", "ownerPubkey": "..." }

{
  "apiKey": "ore_xxx (shown ONCE)",
  "subscriberId": "sub_...",
  "paidUntil": "..."
}

snapshot ของรอบปัจจุบัน (deployed, count, secondsLeft, prevRound)

server-sent events; ส่ง snapshot ทุกครั้งที่ board / round account บนเชนเปลี่ยน

aggregate (chi-squared, perGrid, totalDeployedSol, effectiveHouseEdge)

• limit— จำนวนรอบที่จะคืน; ค่าเริ่มต้น 100, สูงสุด 10000

N รอบล่าสุดที่จัดทำดัชนี (id, deployed[25], count[25], winningSquare, totalDeployed, totalWinnings)

• id— round id (path segment)

รอบเดียว + id ก่อนหน้า/ถัดไป

• n— ดัชนีช่อง 0..24 (path segment)
• limit— ความยาวซีรีส์; ค่าเริ่มต้น 200

สถิติต่อกริด + ซีรีส์ hit/miss ล่าสุด (1 ≤ n ≤ 25)

• since— cursor ของ id; คืนเฉพาะ event ที่ id > since
• limit— event สูงสุดต่อการเรียก; ค่าเริ่มต้น 100
• kind— filter เสริม: drought_broken | big_round | tier | milestone | subscription

{
  "count": 12,
  "lastId": 47,
  "events": [
    { "id": 47, "ts": "...", "kind": "drought_broken", "grid": 8, "drought": 91, "roundId": 247101 },
    { "id": 48, "ts": "...", "kind": "big_round", "roundId": 247155, "deployedSol": 8.94, "thresholdSol": 8.15, "multiplier": 1.10, "winningSquare": 12, "totalMiners": 209 },
    ...
  ]
}

• since— cursor สำหรับการเล่นซ้ำเสริม; ถ้าไม่ระบุจะเล่น 50 ล่าสุด
• kind— filter เสริม (ชุดเดียวกับ /events)

server-sent events; replays last 50 (or events since cursor) on connect, then pushes each new event as it fires (drought / streak / big round / tier / milestone / subscription).

• from— round id เริ่มต้น (รวม)
• to— round id สิ้นสุดเสริม (รวม)
• limit— ขนาดหน้า; ค่าเริ่มต้น 5000, สูงสุด 10000

{
  "count": 5000,
  "from": 228237,
  "to": 233236,
  "hasMore": true,
  "nextFrom": 233237,
  "rounds": [ { id, deployed[25], count[25], winningSquare, totalDeployed, totalWinnings }, ... ]
}

• ownerPubkey— กระเป๋าเงินที่สมัครสมาชิกแต่แรก

{ "ownerPubkey": "..." }

{ "nonce": "ore-reissue-...", "message": "OREStats reissue ... @ ...", "expiresAt": "..." }

• nonce— ค่าที่คืนจาก POST /reissue
• ownerPubkey— กระเป๋าเงินเดียวกับ POST
• signatureBase64— ลายเซ็น ed25519 ที่เข้ารหัส base64 ของสตริงข้อความ

{ "nonce": "...", "ownerPubkey": "...", "signatureBase64": "..." }

{ "apiKey": "ore_xxx (NEW, old key revoked)", "subscriberId": "sub_...", "paidUntil": "..." }

• name— ป้ายชื่อแสดงผล, สตริงไม่ว่าง
• dsl— Strategy DSL ฉบับเต็ม — base_strategy, params, filters[] เสริม ดูค่าอ้างอิงด้านล่าง

{
  "name": "my cold-5",
  "dsl": {
    "base_strategy": "cold",
    "params": {
      "bet_size_lamports": 200000,
      "num_squares": 5,
      "sizing_mode": "flat",
      "max_bet_per_square_lamports": 5000000,
      "tx_fee_lamports": 10000
    },
    "filters": [
      { "metric": "current_drought_min", "op": ">=", "value": 30 }
    ]
  }
}

{
  "strategy": {
    "id": "...", "owner": "...", "name": "...",
    "dsl": { "base_strategy": "...", "params": { ... }, "filters": [ ... ] },
    "createdAt": "...", "updatedAt": "...", "active": true
  }
}

{
  "count": 3,
  "strategies": [
    {
      "id": "...", "name": "...", "dsl": { ... }, "active": true,
      "stats": { "roundsSettled": 412, "roundsWon": 88, "netProfitSol": 0.123, "roiPercent": 4.7 }
    },
    ...
  ]
}

• id— strategy id (path segment)

{ "strategy": { ... }, "predictionCount": 412 }

• name— ชื่อแสดงผลใหม่ (เสริม)
• active— true เพื่อกลับมา predict, false เพื่อหยุดพัก (เสริม)

{ "name": "renamed", "active": false }

{ "strategy": { ... } }

• id— strategy id (path segment)

{ "ok": true }

• id— strategy id (path segment)

{
  "strategyId": "...",
  "roundsObserved": 432,
  "roundsBet": 412, "roundsWon": 88,
  "squaresBet": 2060, "squaresWon": 92,
  "netProfitSol": 0.12, "totalStakeSol": 2.6,
  "roiPercent": 4.7, "winRate": 0.21, "perSquareWinRate": 0.045,
  "maxDrawdownSol": 0.08, "maxStreak": 12,
  "equityCurve": [{ "round": 247001, "balanceLamports": 0 }, ...],
  "pendingCount": 1
}

• dsl— Strategy DSL (shape เดียวกับ create)
• fromRoundId— ขอบล่างของหน้าต่างเล่นซ้ำแบบรวมเสริม
• toRoundId— ขอบบนแบบรวมเสริม

{
  "dsl": { "base_strategy": "...", "params": { ... }, "filters": [ ... ] },
  "fromRoundId": 200000,
  "toRoundId": 247000
}

{
  "result": {
    "totalRounds": 47000, "roundsBet": 9200, "roundsWon": 1800,
    "squaresBet": 46000, "squaresWonOn": 1900,
    "netProfitLamports": ..., "netProfitSol": ...,
    "totalStakeLamports": ..., "totalStakeSol": ...,
    "totalRecoveryLamports": ..., "totalRecoverySol": ...,
    "roiPercent": ..., "winRate": ..., "perSquareWinRate": ...,
    "maxStreak": ..., "capHits": ..., "totalCapLossSol": ...,
    "minWalletSol": ..., "maxDrawdownSol": ...,
    "rangeMin": 200000, "rangeMax": 247000,
    "exitedEarly": null,
    "exitRoundId": 0,
    "equityCurve":   [{ "round": ..., "balanceLamports": ... }, ...],
    "perSquare":     [{ "square": 0, "betCount": ..., "winCount": ..., "netLamports": ... }, ...],
    "perRoundPnlLamports": [...],
    "streakRunLengths":    [...]
  }
}

• dsl— Strategy DSL (shape เดียวกับ backtest)

{ "dsl": { ... } }

{ "analytics": { ... } }

{
  "generatedAt": "...",
  "minRoundsToQualify": 1000,
  "count": 14,
  "entries": [
    { "id": "...", "name": "...", "ownerShort": "abcd...wxyz", "roiPercent": ..., "roundsSettled": ... },
    ...
  ]
}

• id— strategy id (path segment)

{
  "strategy": {
    "id": "...", "name": "...", "ownerShort": "abcd...wxyz",
    "dsl": { ... },
    "createdAt": "..."
  },
  "forwardTest": {
    "roundsSettled": ...,
    "netProfitSol": ...,
    "equityCurve": [{ "round": ..., "balanceLamports": ... }, ...]
  }
}