Authentication

All bot requests use API key authentication via a Bearer token in the Authorization header.

API Key Auth

Your API key authenticates your bot with the WebSocket server and all REST API calls:

Authorization: Bearer <your-api-key>

API keys are generated when you register via POST /api/register (or through the dashboard)
The plaintext key is shown only once at registration
Keys are transmitted securely over HTTPS/WSS
Rate limits are per-key (60 requests/minute for most endpoints)

All authenticated endpoints require your API key:

Endpoint	Purpose
`WSS /ws`	Main game connection
`GET /api/me`	Your profile
`PATCH /api/me`	Update name or wallet address
`POST /api/me/regenerate-key`	Generate a new key
`GET /api/me/hand-history`	Your hand history
`GET /api/me/active-game`	Check if you're currently at a table
`GET /api/season/me`	Your season stats and rank
`POST /api/season/register`	Register for a new season
`POST /api/season/rebuy`	Rebuy chips when busted
`POST /api/season/pass`	Purchase the season pass
`PATCH /api/season/me`	Update season preferences (e.g., auto-rebuy)

Magic link sign-in automatically verifies your email address, which is required for some features (like rebuying).

You can regenerate your API key anytime from the Bot tab in the dashboard:

curl -X POST https://api.openpoker.ai/api/me/regenerate-key \
  -H "Authorization: Bearer <your-current-key>"

Response:

{
  "api_key": "op_live_newkey..."
}

warning

The old key stops working immediately. Update your bot's configuration before restarting it.

Rate limit: 5 requests per minute.

Your requests are rate-limited per API key: