User Bet Record

Used by merchants to query bet records for players and games.

MINI.GAME server time zone: UTC+0. Integrators should be mindful of time zone calculations when processing data statistics.

GetGameRecordList

This API is provided by the MINI.GAME platform and is called by the integrator.

POST {BACKEND_URL}/api/special/outer/record/GetGameRecordList?trace_id=your_trace_id

{BACKEND_URL} is the MINI.GAME configuration interface in the merchant backend where the domain for backend API calls can be obtained.

Headers

Parameter	Location	Required	Type	Description
sign	header	Yes	string	Signature Algorithm and Example
app_id	header	Yes	string	Merchant number
trace_id	url params	Yes	string	unique and randomly generated.

Please refer to the Signature Algorithm and Example page for details on the signature algorithm.

Body

Name	Type	Description
uname	string	User ID, matches the uname field used for game player verification.
game_id	integer	Game ID,If id=0, query all games
page	integer	Current Page
size	integer	Page Size
start_time	integer	Query Start Time: Timestamp in UTC+0
end_time	integer	Query End Time: Timestamp in UTC+0

If start_time and end_time need to be obtained through date conversion, use dates in the UTC+0 time zone to convert to timestamps (in seconds).

Integrator Request Parameter Example

{
    "uname": "1004613",
    "game_id": "10049",
    "start_time": 0,
    "end_time": 0,
    "page": 1,
    "size": 2
}

MINI.GAME Platform Response Parameter Example

success（special）

//Multi-step betting multi-reward game
{
    "code": 1,
    "msg": "success",
    "data": [
		{
			"uuid": "f060ca98-9b4e-e0d6-a68c-69d95eee547e",
			"order_id": "c91af8605dc2c24695019e6984610e0280c7a621d0403e73965848bd5909be15",
			"create_time": 1749181074,
			"round_id": 1749181040,
			"account": "10056080126",
			"account_id": "b3a40400fad139084df435f151a224fc",
			"game_id": 3000001,
			"currency": "mmk",
			"win": 11360,
			"enter_money": 19610,
			"after_settlement_money": 30970,
			"bet": 2000,
			"state": 1,
			"action_type": 4
		},
		{
			"uuid": "10d978fd-dce9-ce75-4414-7fe8acd7c580",
			"order_id": "b8bf051636a3e0577b7c3d835b4acc8792b63e0298c492cfc86adc3802afd2fa",
			"create_time": 1749181072,
			"round_id": 1749181040,
			"account": "3023391580",
			"account_id": "631820e6073db67cb58051943092023f",
			"game_id": 3000001,
			"currency": "vnd",
			"win": 606600.122,
			"enter_money": 1820,
			"after_settlement_money": 608420.122,
			"bet": 5000,
			"state": 1,
			"action_type": 4
		},
		{
			"uuid": "77e59435-0d04-6e96-67d4-bb5bee17efdc",
			"order_id": "6b1dea8ed8592b5e0e5b4bf334d38bc2ddb3346680fe734778cab18c758b8d98",
			"create_time": 1749181071,
			"round_id": 1749181040,
			"account": "3023391580",
			"account_id": "631820e6073db67cb58051943092023f",
			"game_id": 3000001,
			"currency": "vnd",
			"win": -569100.122,
			"enter_money": 570920.122,
			"after_settlement_money": 1820,
			"bet": 4000,
			"state": 1,
			"action_type": 3
		},
		{
			"uuid": "2ae1a6ea-5190-6f7e-83b9-6ca4eea2f779",
			"order_id": "f4cdc523cd31e266cdb654493044070c82f220c4eef69d6a443f2dfd21d8e531",
			"create_time": 1749181045,
			"round_id": 1749181040,
			"account": "3023391580",
			"account_id": "631820e6073db67cb58051943092023f",
			"game_id": 3000001,
			"currency": "vnd",
			"win": -5000,
			"enter_money": 575920.122,
			"after_settlement_money": 570920.122,
			"bet": 5000,
			"state": 1,
			"action_type": 1
		},
		{
			"uuid": "3cf86bdf-46c9-410f-7fff-1658d0abe7a4",
			"order_id": "57c9dcf8224c38e7223aa650eaaa426b2aeb8125b2f1815e17d34294a37c2786",
			"create_time": 1749181045,
			"round_id": 1749181040,
			"account": "10056080126",
			"account_id": "b3a40400fad139084df435f151a224fc",
			"game_id": 3000001,
			"currency": "mmk",
			"win": -2000,
			"enter_money": 21610,
			"after_settlement_money": 19610,
			"bet": 2000,
			"state": 1,
			"action_type": 1
		},
		{
			"uuid": "798d0580-b736-28e7-1a5a-2fecd6910beb",
			"order_id": "9d8890d698e92dd6abedb2e163d2ca65f5aca2eeeb147ff828705f4a1025863b",
			"create_time": 1749181045,
			"round_id": 1749181040,
			"account": "3023391580",
			"account_id": "631820e6073db67cb58051943092023f",
			"game_id": 3000001,
			"currency": "vnd",
			"win": -4000,
			"enter_money": 579920.122,
			"after_settlement_money": 575920.122,
			"bet": 4000,
			"state": 1,
			"action_type": 1
		}
	]
}

success（normal）

fail

Response Example Parameter Descriptions

Return value	Required	Type	Description
code	Yes	integer	Status Code
msg	Yes	string	Prompt message
uuid	Yes	string	Bet record ID
order_id	Yes	string	Bet order ID
account	Yes	string	User Nickname
account_id	Yes	string	User ID
game_id	Yes	integer	Game ID
round_id	Yes	integer(64)	Session ID, bet order and reward round_id are corresponding
currency	Yes	string	Currency name, for details, refer to the "name" field of the supported currencies in the currency list.(lower case)
enter_money	Yes	decimal	The balance before user bet
after_settlement_money	Yes	decimal	The balance after user bet
bet	Yes	decimal	Bet Amount
win	Yes	decimal	Payout Amount
create_time	Yes	integer	User Bet Timestamp
state	Yes	integer	Status: 1 success ，2 failure
state	Yes	integer	Log type: 1 bet 2 cancel bet 3 payout 4 payout and verify. When multiple payouts are made, 3 and 4 are both payouts, 4 means the last payout in this round (game over), status 4 is unique

To display the player's final win/loss, use the formula: Win - Bet = Player's Win/Loss. Example: if Bet = 50 and Win = 10, then the player's win/loss is: 10 - 50 = -40

Error Code

For more error codes, please refer to the Special Error Code page description.