# Merchant's Account Balance

## Retrieve the balance of an specific asset for a specific account or subaccount

<mark style="color:blue;">`GET`</mark> `https://live.betaapp.com/v1/balance`

#### Query Parameters

| Name                                    | Type   | Description                                    |
| --------------------------------------- | ------ | ---------------------------------------------- |
| asset<mark style="color:red;">\*</mark> | String | Fiat Asset used on your settlement preference. |

#### Headers

| Name                                            | Type   | Description                             |
| ----------------------------------------------- | ------ | --------------------------------------- |
| Authorization<mark style="color:red;">\*</mark> | String | Bearer {access\_token}                  |
| x-sub-account-id                                | String | ID of your subaccount, If you have one. |
| accept<mark style="color:red;">\*</mark>        | String | application/json                        |

{% tabs %}
{% tab title="200: OK Sucess" %}

```json
{
  "message": "string",
  "number_of_orders_associated": 0,
  "total_asset": "string",
  "total_amount": 0,
  "total_fees": 0
}
```

{% endtab %}

{% tab title="400: Bad Request Error message " %}

```json
{
  "message": "string"
}
```

{% endtab %}
{% endtabs %}

**Request Example:**

{% code overflow="wrap" %}

```json
curl -X 'GET' \
  'https://live.betaapp.com/v1/balance?asset=BRL' \
  -H 'accept: application/json' \
  -H 'X-sub-account-id: 22376b76...3543083b' \
  -H 'Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCIsImtpZCI6InJlaEF1NURPY...ctfx2I4g'
```

{% endcode %}

**Response Example:**

```json
{
  "total_amount": 18500,
  "total_fees": 185,
  "number_of_orders_associated": 22
}
```

{% hint style="info" %}
The `total_fees` parameter represents the amount in fees that will be discounted during the settlement process.
{% endhint %}

{% hint style="success" %}
The `number_of_orders_associated` parameter represents how many orders compose the `total_amount`.
{% endhint %}

### Settlements

Merchants are required to request settlements through the Dashboard. It could be requested automatically based on your [initial settings setup](/documentation-beta-ramps/getting-started/set-up-your-account.md), or it could be requested manually when you follow these steps:

1. **Click on the three dots on the right side of your balance amount**

You will be redirected to the Settlement History page, where you can see an overview of the amount ready for settlement.

![Balance in fiat being displayed on the Dashboard](/files/Tds5KiPaaNGlZHtiYZDN)

2. **Click on More Info located on the top-right side of the Settlement Overview**

<figure><img src="/files/ieFHVIEgbEsidtDZnxLs" alt="Beta&#x27;s Settlement Menu on Dashboard"><figcaption><p>Settlement Menu on Dashboard</p></figcaption></figure>

3. **Request your Settlement**

<figure><img src="/files/q5GwFSGUzw5MWHlsddKL" alt="Request Settlement Page"><figcaption><p>Request Settlement</p></figcaption></figure>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.betaramps.com/documentation-beta-ramps/request-payments/merchants-account-balance.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.