Get User Balance

The integrator queries the user's balance on the MINI.GAME platform.

GetPlayerWallet

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

POST {MINIGAME_APIURL}/api/cash/v1/getPlayerWallet?trace_id=your_trace_id

{MINIGAME_APIURL}is the MINI.GAME API domain, which can be obtained from the backend.

Headers

Name	Value
Content-Type	"application/json; charset=utf-8"
sign	"your_sign_string"

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

Body

Name	Type	Description
appid	string	The unique identifier for the merchant, available in the merchant backend.
timestamp	integer	Timestamp (in seconds)
token	string	The user's token on the MINI.GAME platform can be obtained through the Get User Game Token API.
currency	string	Currency name, for details, refer to the "name" field of the supported currencies in the currency list.

Integrator Request Parameter Example

{
    "appid": "13",
    "timestamp": 1711954264,
    "token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJjcmVhdGUiOjE3MTk2Mjk2NDQsInVzZXIiOiJ7XCJpZFwiOjM1NzE0MSxcIm9wZXJhdGVyX2lkXCI6MSxcImFnZW50X2lkXCI6MTAwMDIwLFwiYXBwX2lkXCI6MTAzMSxcImFjY291bnRfdHlwZVwiOjAsXCJ2YWx1ZVwiOlwiMVwiLFwibm93X2dhbWVfaWRcIjowfSJ9.tXfaavxZu7PIedpJ5Tp7oL0aBEnb5ujok4cbKWoNj0U",
    "currency": "usdt"
}

MINI.GAME Platform Response Parameter Example

Success

{
    "data": {
         "currency":"usdt",
         "balance":999.999,
    },
    "code": 0,
    "msg": "ok"
}

Failed

{
    "code": 10002,
    "msg": "sign invalid"
}

Response Example Parameter Descriptions

Name	Next level	Required	Type	Description
data	—-	Yes	object	Response Data
—-	balance	Yes	decimal	User balance, supports up to 4 decimal places
—-	currency	Yes	string	Currency name, for details, refer to the "name" field of the supported currencies in the currency list.
code	—-	Yes	integer	Status Code
msg	—-	Yes	string	Prompt message

Error Code

For more error codes, please refer to the General Error Codes page description.