Skip to main content
Servers MUST provide a transaction history endpoint that returns all financial events for an authenticated client.

Endpoint

GET /api/wallet/transactions?startDate={ISO8601}&endDate={ISO8601}&limit={number}&offset={number}
Authorization: Bearer {token}

Response 200:
{
  "transactions": [
    {
      "txId": string,              // Unique transaction identifier
      "type": "deposit" | "withdrawal" | "game_win" | "game_loss" | "rake",
      "amount": number,
      "balance": number,           // Balance after this transaction
      "tableId": string | null,    // Null for deposit/withdrawal
      "gameType": string | null,
      "timestamp": number,         // Unix milliseconds
      "onChainTxHash": string | null  // Present for deposit/withdrawal
    }
  ],
  "total": number,
  "limit": number,
  "offset": number
}
Transactions are returned in reverse chronological order (newest first).

Query Parameters

ParameterTypeDescription
startDateISO 8601Filter transactions after this date
endDateISO 8601Filter transactions before this date
limitnumberMax results per page (default: 50, max: 200)
offsetnumberPagination offset

Retention

Servers MUST retain transaction history for a minimum of 12 months. This supports audit, reconciliation, and regulatory reporting requirements.