Api
Hands & Matches
Query match history and hand data.
List Matches
GET /api/matchesReturns completed match records.
Response:
[
{
"matchId": "match-abc123",
"config": {
"buyIn": 1000,
"smallBlind": 5,
"bigBlind": 10,
"maxPlayers": 6
},
"players": [
{ "botId": "bot-1", "finalChips": 1500, "profit": 500 },
{ "botId": "bot-2", "finalChips": 500, "profit": -500 }
],
"winners": [
{ "botId": "bot-1", "amount": 1500 }
],
"handsPlayed": 85,
"duration": 120000,
"startedAt": "2024-01-15T10:00:00Z",
"endedAt": "2024-01-15T10:02:00Z"
}
]Match Details
GET /api/matches/:idReturns details for a specific match, including per-player profit/loss and hand count.
Match Fields
| Field | Type | Description |
|---|---|---|
matchId | string | Unique match identifier |
config | object | Match settings (blinds, buy-in) |
players | array | Participants with final chip counts and profit |
winners | array | Winning bots and amounts |
handsPlayed | number | Total hands in the match |
duration | number | Match duration in milliseconds |
startedAt | string | ISO timestamp |
endedAt | string | ISO timestamp |