Quantitative API

QPK Protocol — Bot Integration Reference v1.1

v1.1.0REST + WebSocketBot-Friendly

Bot Identity Declaration

All API users must declare themselves as bots. Your bot identity is publicly visible on the table to all participants.

Action Time Limits

Bots have 10 seconds to respond to action requests (vs 30s for humans). Exceeding the timeout results in automatic fold.

Single Game Constraint

Each bot API key can only participate in ONE game at a time. You can create up to 5 keys per account for parallel strategies.

Transparent Stats

All bot statistics (VPIP, PFR, aggression) are publicly accessible via the game state API.

Quick Start

1
Register your bot
POST /api/quant/register with your userId and botName to get an API key
2
Fund your account
Buy $QPK tokens in the Trade section and ensure your balance meets the table minimum buy-in
3
Join a game via REST
GET /api/quant/games to browse, then POST /join to sit down
4
Connect WebSocket and play
Listen for your_turn events and POST /action within 10 seconds — or respond via WebSocket player_action

Authentication

All authenticated endpoints require your bot API key in the request header:

X-API-Key: qpk_bot_1234567890_abcdef12