Reference

Three endpoints. Every field explained.

Auth is a RapidAPI subscription — send your key as X-RapidAPI-Key through the marketplace gateway. See API access for plans and listing links.

GET /v1/live

The current round, per table.

Returns one object per table with a latest block: round_id, number, color, parity, dozen, column, half, timestamp, backfilled.

{
  "status": "ok",
  "tables": [
    {
      "table_id": "greek_roulette",
      "latest": {
        "round_id": "390472248",
        "number": 16,
        "color": "red",
        "parity": "even",
        "dozen": 2,
        "column": 1,
        "half": "high",
        "timestamp": "2026-08-03T20:21:11Z",
        "backfilled": false
      }
    }
  ]
}

If a table's feed has gone stale, /v1/live returns 503 rather than serving an old number as though it were current.

GET /v1/history

Cursor-paginated, newest first.

Params: table (slug, required), limit (rows per call, clamped to your plan's max), cursor (from the previous response's next_cursor).

{
  "status": "ok",
  "count": 50,
  "rounds": [
    { "round_id": "390472248", "number": 16, "color": "red", "backfilled": false },
    { "type": "gap", "from": "390472201", "to": "390472210" },
    { "round_id": "390472200", "number": 0, "color": "green", "backfilled": true }
  ],
  "next_cursor": "390472150"
}

• Gaps are marked, never closed

  A missing span appears as an explicit {"type": "gap"} object instead of being silently stitched shut. You always know when the record has a hole.

• Recovered rounds are flagged

  Rounds recovered after the fact carry backfilled: true, so you can tell live captures from later reconciliation.

• Paging stops at your plan's window

  When a page reaches the edge of your history window, next_cursor comes back null. Asking for a cursor past the window returns 402 window_exceeded.

GET /v1/meta

Table registry and account usage.

Returns the tables your key can read, each with a measured coverage_30d_pct and history_days, plus your current plan and usage for the billing period.

{
  "status": "ok",
  "plan": "PRO",
  "usage": { "requests_this_period": 1284, "limit": 10000 },
  "tables": [
    {
      "table_id": "greek_roulette",
      "coverage_30d_pct": 99.4,
      "history_days": 168
    }
  ]
}

Errors

Failures are explicit, not silent.

Plans

Window and rate limits live on the API access page.

Live data is identical on every plan. BASIC, PRO, ULTRA and MEGA differ by history window and request volume — see the plan ladder and the 10 listing links.