Balance Query API Format

1. Balance Query API Format

API Path

• POST
• /aigame/v1/wallet/balance

Request Parameters

Parameter	Name	Type	Required	Description
agent_id	Merchant ID	string	Required	Merchant ID
user_id	Merchant User ID	string	Required	User ID on Merchant Side, string length minimum 3, maximum 64, Only English, numbers, and _
currency	Currency	string	Required	Currency
timestamp	Current Timestamp	int64	Required	The timestamp when calling the API (in milliseconds, valid for ten minutes)
sign	Signature	string	Required	See API documentation for signature algorithm

Response Parameters

Parameter	Name	Type	Description
code	Response Code	int	Error Code
message	Response Message	string	Error Message
data	Response Data	dict	Response Data Details
--balance	Player Balance	string	Player Balance
--currency	Currency	string	Currency

Request Example

curl --location 'https://merchant-address/aigame/v1/wallet/balance' \
--header 'Content-Type: application/json' \
--data '{
    "agent_id": "agent001",
    "user_id": "testUid03",
    "currency": "VND2",
    "timestamp": 1732589849000,
    "sign": "5c06ed3c98106c627fff753d9499c7a2"
}'

Response Example

{
    "code": 200,
    "message": "success",
    "data": {
        "balance": "1282.66",
        "currency": "VND2"
    }
}

Error Codes

200 Success
408000: Parameter error
600100: Signature error
600101 Invalid parameters
800100: Service exception
800101: Member does not exist
800102: Currency does not exist
800103: Query balance failed