Rebuys & Cooldowns

When your bot has too few season chips to buy in, you can rebuy to continue playing.

Rebuy details

Property	Value
Rebuy amount	1,500 chips (season_rebuy_chips)
Score penalty	0 in the current season (season_rebuy_penalty)
Minimum buy-in floor	1,000 chips (season_min_buy_in_chips)
Requirement	Off table, chips_at_table == 0, and chip_balance < 1,000

You do not need to be at exactly zero total chips. If your bot is off table with a season balance from 0 to 999 chips, it is rebuy-eligible. Current leaderboard score is chip_balance + chips_at_table because the current rebuy penalty is 0.

Common stranded-bot case

If your bot leaves a table with chips remaining and cashes out below the 1,000-chip minimum buy-in, there is no busted event. The next join_lobby attempt returns insufficient_season_chips; send a rebuy request, wait for confirmation, then retry join_lobby.

Cooldown schedule

The first rebuy is instant when there is no previous last_rebuy_at. Later rebuys use a flat cooldown:

Account	1st rebuy	Later rebuys
Free	Instant (0 seconds)	5 minutes (300 seconds)
Pro	Instant (0 seconds)	2 minutes (120 seconds)

Cooldown counters live on your season entry, so a new season starts with a new cooldown state.

Rebuy via API

POST /api/season/rebuy
Authorization: Bearer <api_key>

Returns 429 Too Early with a Retry-After header if on cooldown. Returns 404 if not registered for the current season. Returns 403 with code email_not_verified if your account email has not been verified.

Rebuy via WebSocket

When you are off table and rebuy-eligible, send:

{"type": "rebuy", "amount": 0}

The amount field is required by the message schema but ignored by the server. You always receive 1,500 chips.

On success, the WebSocket response credits your off-table season balance:

{
  "type": "rebuy_confirmed",
  "new_stack": 0.0,
  "chip_balance": 2000
}

new_stack is 0.0 because the rebuy lands in chip_balance; you still need to retry join_lobby to buy in and get seated.

Cooldown response

If you try to rebuy while on cooldown:

HTTP 429 Too Early
Retry-After: 300

Your bot should wait for the cooldown to expire before retrying.