Query Bet Logs (Paginated)
Query Bet Logs & Reports within a specified time range, querying different data with different offsets, returning a maximum of 5000 records each time.
API Information
- URL:
POST /v2/betlogs/offset - Authentication: Bearer Token
- Encryption: Requests are encrypted using AES-256-GCM; responses are returned as plaintext JSON
Request
Request Headers
POST /v2/betlogs HTTP/1.1
Host: api.example.com
Content-Type: application/json
Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...
x-agentid: integratorNBTest04
x-timestamp: 1769746894501
x-nonce: 4ff08bc2a45c6b38068dbcd24296a25b
x-signature: c25f8d23704373e8776cce6d9b10f1fde091c34db80d60523c7e04ff30e54633
Request Parameters
Parameters Before Encryption
{
"startDate": "2026-01-21T07:20:00.000Z",
"endDate": "2026-01-21T07:20:00.000Z",
"betSourceId": "0",
"featureMode": 1,
"gameKind": 1,
"offset": 0
}
Encrypted Request Body
{
"cipherText": "G0ZMDELeJwx+7JcIfIFOLJjkSzANPu6krGM2uw==..."
}
| Field | Type | Required | Description |
|---|---|---|---|
startDate | string | Yes | Start time (ISO 8601 format) |
endDate | string | Yes | End time (ISO 8601 format) |
betSourceId | string | No | Transaction source code |
featureMode | number | No | Feature Mode |
gameKind | number | No | Game Kind |
offset | number | Yes | Offset, 0 for the first query, increasing by 5000 for subsequent queries |
Response
Success Response
{
"code": 0,
"message": "No error.",
"data": {
"rows": [
{
"betTime": "2025-12-09T09:05:10.151Z",
"txTime": "2025-12-09T09:05:10.151Z",
"currency": "THB",
"brand": "VP",
"gameCode": "VP_230001_1",
"username": "apitest011",
"roundId": "7652711103511700000",
"transferId": "7652711103511700000",
"betId": "7652711103511700000",
"betStatus": 2,
"actualBetAmt": "0.500000",
"validBetAmt": "0.500000",
"winAmt": "0.360000",
"jackpotWin": "0.000000",
"jackpotContribute": "0.000000",
"betSourceId": 1,
"featureMode": 1,
"gameKind": 1
},
{
"betTime": "2025-12-09T09:05:10.182Z",
"txTime": "2025-12-09T09:05:10.182Z",
"currency": "THB",
"brand": "VP",
"gameCode": "VP_230003_1",
"username": "apitest012",
"roundId": "7652711103511980000",
"transferId": "7652711103511980000",
"betId": "7652711103511980000",
"betStatus": 2,
"actualBetAmt": "1.000000",
"validBetAmt": "1.000000",
"winAmt": "0.000000",
"jackpotWin": "0.000000",
"jackpotContribute": "0.000000",
"betSourceId": 1,
"featureMode": 1,
"gameKind": 1
},
],
"totalRowsNumber": 29999
},
"logUUID": "88825f91-719d-495f-b7a0-58c442d8e985"
}
Response Field Description
| Field | Type | Description |
|---|---|---|
data.rows[].betTime | string | Bet time |
data.rows[].txTime | string | Settlement time |
data.rows[].currency | string | Currency |
data.rows[].brand | string | Brand, fixed as 'VP' |
data.rows[].gameCode | string | Game Code |
data.rows[].username | string | Player Account |
data.rows[].roundId | string | Games round ID, not unique (default equals transferId) |
data.rows[].transferId | string | Transaction ID, unique for VP (scheduled for removal) |
data.rows[].betId | string | Bet ID, unique for VP |
data.rows[].betStatus | number | Bet Status (2=Settlemented) |
data.rows[].actualBetAmt | string | Actual bet amount |
data.rows[].validBetAmt | string | Valid bet amount |
data.rows[].winAmt | string | Win amount |
data.rows[].jackpotWin | string | Jackpot win amount |
data.rows[].jackpotContribute | string | Jackpot contribution amount, current value = 0, default Field |
data.rows[].betSourceId | number | Transaction source code |
data.rows[].featureMode | number | Feature Mode |
data.rows[].gameKind | number | Game Kind |
data.totalRowsNumber | number | Total number of records |
Error Response
When the request fails, the corresponding error code will be returned.
Error Codes
| Code | Description | Handling Suggestion |
|---|---|---|
| 11 | Parameters error | Please ensure the request parameters are complete and correctly formatted. The time range must be within 1 minute and within the past 40 days, and the Settlement time must be earlier than 1 minute before the current time. |
| 77 | Too many request | Too frequent requests, please try again later |
Error Response Example
Parameter error
{
"code": 11,
"message": "Parameters error",
"logUUID": "24cdc3b9-9fe8-44de-8391-a96863e46954"
}
Too many requests
{
"code": 77,
"message": "Too many request, please try again later",
"logUUID": "asdsaggderv"
}
Important Notes
- Call frequency: Limited to 15 calls per second per agentId
- Time Range: The maximum time Range for a single query is 1 minute
- Time limit: startDate and endDate cannot be set beyond the current time, and endDate must be earlier than 1 minute before the current time
- History range: Queryable history range is within 40 days
- Returned records: A maximum of 5000 records are returned each time. If the total number of records exceeds 5000, batch queries with different offsets should be used in a loop.
- jackpotWin: Reserved Field, current value is fixed at 0