Skip to main content

Query Bet Logs

Query bet records within a specified time range.

API Information

  • URLPOST /v2/betlogs
  • 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:00Z",
"endDate": "2026-01-21T07:20:00Z",
"betSourceId": "0"
}

Encrypted Request Body

{
"cipherText": "G0ZMDELeJwx+7JcIfIFOLJjkSzANPu6krGM2uw==..."
}
FieldTypeRequiredDescription
startDatestringYesStart time (ISO 8601 format)
endDatestringYesEnd time (ISO 8601 format)
betSourceIdstringNoTransaction source code

Response

Success Response

{
"code": 0,
"message": "No error.",
"data": [
{
"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
}
],
"logUUID": "88825f91-719d-495f-b7a0-58c442d8e985"
}

Response Field Description

FieldTypeDescription
data[].betTimestringBet time
data[].txTimestringSettlement time
data[].currencystringCurrency
data[].brandstringBrand, fixed as 'VP'
data[].gameCodestringGame Code
data[].usernamestringPlayer Account
data[].roundIdstringGame Round ID, not unique (defaults to transferId)
data[].transferIdstringTransaction ID, unique to VP (planned for removal)
data[].betIdstringBet ID, unique to VP
data[].betStatusnumberBet Status (2=Settled)
data[].actualBetAmtstringActual Bet Amount
data[].validBetAmtstringValid Bet Amount
data[].winAmtstringWinning Amount
data[].jackpotWinstringJackpot winning amount, current JP value=0, reserved field
data[].jackpotContributestringJackpot contribution amount, current JP value=0, reserved field
data[].betSourceIdnumberTransaction source code

Error Response

When the request fails, the corresponding error code will be returned.

Error Codes

CodeDescriptionHandling Suggestion
11Parameters errorPlease ensure the request parameters are complete and correctly formatted; time range must be within 10 minutes and within the last 40 days
77Too many requestRequest too frequent, please try again later

Error Response Example

Parameter error

{
"code": 11,
"message": "Parameters error",
"logUUID": "24cdc3b9-9fe8-44de-8391-a96863e46954"
}

Request too frequent

{
"code": 77,
"message": "Too many request, please try again later",
"logUUID": "asdsaggderv"
}

Important Notes

  1. Call Frequency: Each agentId is limited to once every 3 seconds
  2. Time Range: Maximum time Range for a single query is 10 minutes
  3. Time Restriction: startDate and endDate settings cannot exceed current time
  4. Historical Range: Queryable historical record range is within 40 days