This API returns the given player’s available cash balance. This can be called at any time, even if the player is not currently online.
POST {base_url}/getbalance
Request Data
|
Name |
Required |
Data Type |
Description |
|---|---|---|---|
|
playerId |
Yes |
String (50) |
System ID of the player. |
|
extOperatorToken |
Optional |
String (150) |
Optional tracking identifier for this player, if a value was provided during the last login call response and during gameplay. If MG+ calls outside of gameplay, then this parameter may not be present. |
Example Request
{
"playerId": "test_player",
"extOperatorToken": "tracertoken77"
}
Response Data
|
Name |
Required |
Data Type |
Description |
|---|---|---|---|
|
currency |
Yes |
String (3) |
Currency code assigned to the player. |
|
balance |
Yes |
Number |
Available player balance.
|
Example Response
{
"currency": "CNY",
"balance": 2050.50
}
HTTP Response Codes
|
Status Code |
Description |
Example |
|---|---|---|
|
200 |
OK |
|
|
401 |
API Token expired or not valid |
|
|
404 |
Player not found |
|