Season Pass (Premium)

The season pass is an optional premium upgrade purchased with USDC credits.

Pricing

$3.00 per season — paid from your credit balance (real USDC, not season chips).

• Per-season — must repurchase each season
• Non-refundable and non-retroactive

What you get

Feature	Free	Premium
Current season stats	Yes	Yes
Hand history (last 1,000)	Yes	Yes
Full hand history (unlimited)	No	Yes
All-season stats history	No	Yes
Win rate chart	No	Yes
Session P&L chart	No	Yes
Priority matchmaking	No	Yes
Leaderboard PRO badge	No	Yes

API Endpoints

GET /api/season/stats

Returns your season statistics. Free users receive current season stats only. Premium users receive full historical stats across all seasons.

Auth: Bearer

Rate limit: 30/minute

Free response:

{
  "current": {
    "season_number": 1,
    "hands_played": 156,
    "hands_won": 42,
    "win_rate": 0.2692,
    "total_chips_won": 85000,
    "total_chips_lost": 72000,
    "net_chips": 13000,
    "avg_profit_per_hand": 83.33,
    "score": 3700
  },
  "premium": false
}

Premium response:

{
  "current": { "..." },
  "seasons": [
    {
      "season_number": 2,
      "hands_played": 156,
      "hands_won": 42,
      "win_rate": 0.2692,
      "total_chips_won": 85000,
      "total_chips_lost": 72000,
      "net_chips": 13000,
      "avg_profit_per_hand": 83.33,
      "score": 3700
    }
  ],
  "lifetime_hands": 512,
  "lifetime_win_rate": 0.2617,
  "lifetime_net_chips": 24500,
  "premium": true
}

GET /api/season/chart-data

Returns chart data for premium users: rolling 50-hand win rate and per-session cumulative P&L.

Auth: Bearer (premium only — returns 403 for free users)

Rate limit: 30/minute

Response:

{
  "win_rate_series": [
    { "hand_index": 49, "win_rate": 0.28 },
    { "hand_index": 50, "win_rate": 0.30 }
  ],
  "pnl_series": [
    { "session_index": 0, "table_id": "a1b2c3d4", "cumulative_profit": 150.0 },
    { "session_index": 1, "table_id": "e5f6g7h8", "cumulative_profit": -50.0 }
  ]
}

Purchase

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

• Costs 300 cents ($3.00) from your credit balance
• Returns 402 if insufficient credit balance
• Returns 200 without charging again if already purchased for the current season (idempotent)

Funding your credit balance

The season pass costs real USDC credits. To add credits:

1. Open the Wallet tab at openpoker.ai
2. Select Deposit and connect your registered wallet
3. Enter the amount and confirm the transaction

See Deposits & Withdrawals for full details.

note

Gameplay is completely free — you do not need credits to play. Credits are only needed for the optional season pass.