> ## Documentation Index
> Fetch the complete documentation index at: https://gateway.wasmou.net/llms.txt
> Use this file to discover all available pages before exploring further.

# Account & balance

> Retrieve your account information and spendable balance.

## Get account information

Retrieve your account details and balance.

**Endpoint:** `GET /api/account`

```json Response theme={"dark"}
{
  "status": "success",
  "message": "Account information retrieved",
  "data": {
    "user_id": 123,
    "name": "John Doe",
    "email": "john@example.com",
    "balance": 5000.00,
    "available_balance": 4500.00
  }
}
```

## Get balance

Retrieve the balance only. This is the lightest call to make before a purchase.

**Endpoint:** `GET /api/balance`

```json Response theme={"dark"}
{
  "status": "success",
  "message": "Balance retrieved",
  "data": {
    "balance": 5000.00,
    "available_balance": 4500.00
  }
}
```

## Example usage

```bash theme={"dark"}
# Full account info
curl -X GET "https://api.wasmou.net/api/account" \
  -H "X-Api-Key: your_api_key_here"

# Balance only
curl -X GET "https://api.wasmou.net/api/balance" \
  -H "X-Api-Key: your_api_key_here"
```

## Balance notes

* `balance` is the total balance of your wallet.
* `available_balance` is what you can spend right now (the balance minus amounts reserved by pending operations). **Use this one for decisions.**
* All amounts are in DZD.
* If an order fails, the amount is **refunded automatically**.
* Add funds from the [deposit page](https://myapp.wasmou.net/deposit).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.