> For the complete documentation index, see [llms.txt](https://roqqu-api-services.gitbook.io/ras/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://roqqu-api-services.gitbook.io/ras/balances/get-crypto-balances.md).

# Get Crypto Balances

Retrieve cryptocurrency balances for a merchant.

**Endpoint:** `POST /balances`

**Authentication:** Required (x-api-key header)

#### Request Parameters <a href="#request-parameters" id="request-parameters"></a>

| Parameter | Type   | Required | Description                            |
| --------- | ------ | -------- | -------------------------------------- |
| email     | string | No       | Email of merchant                      |
| token     | string | No       | Symbol of token (e.g., btc, eth, usdt) |

#### Example Request <a href="#example-request" id="example-request"></a>

```
curl -X POST https://service.roqqu.com/v1/balances \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/x-www-form-urlencoded" \
  -d "email=ebentest@yopmail.com" \
  -d "token=btc"
```

#### Example Response <a href="#example-response" id="example-response"></a>

```
{
  "status": "success",
  "message": "balance retrieved successfully",
  "data": {
    "balance": {
      "id": 2,
      "btc": 0,
      "eth": 0,
      "usdt": 137,
      "trx": 0,
      "sol": 0,
      "bnb": 0,
      "ltc": 0,
      "doge": 0,
      "bch": 0,
      "xrp": 0,
      "shib": 0,
      "ada": 0,
      "twt": 0,
      "busd": 0,
      "comp": 0,
      "created_at": "2023-08-09T18:27:44.000Z",
      "updated_at": "2023-08-29T18:06:30.000Z",
      "deleted_at": null
    }
  }
}
```