AWorld APIs are in a pre-alpha stage and are being updated frequently. For integration inquiries or technical information, please contact us at server@aworld.org.

Get virtual balance

GET

https://api.eu-west-1.aworld.cloud/app/v1/virtualBalances/{virtualCurrencyId}

Retrieves the balance for a specific virtual currency for the authenticated user.

Request Example

Shell

JavaScript

Java

Swift

curl --location --request GET 'https://api.eu-west-1.aworld.cloud/app/v1/virtualBalances/'

Response Example

{
    "virtualCurrencyId": "string",
    "userId": "string",
    "amount": 0,
    "availableAmount": 0,
    "createdAt": "2019-08-24T14:15:22Z",
    "updatedAt": "2019-08-24T14:15:22Z"
}

Request

Authorization

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Path Params

Responses

🟢200OK

application/json

Virtual Balance retrieved successfully.

Body

🟠401Unauthorized

🟠404Record Not Found

Modified at 2025-07-15 09:05:10

List virtual balances

List virtual transactions