> For the complete documentation index, see [llms.txt](https://teamhycon.gitbook.io/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://teamhycon.gitbook.io/docs/api-v1-4/api-v1/getting-the-balance.md).

# Getting the balance

**Path Parameter**

| Parameter | Type   | Required | Description            |
| --------- | ------ | -------- | ---------------------- |
| `address` | string | Yes      | A Hycon wallet address |

**Response - `200 OK, application/json`**

| Parameter | Type   | Description                       |
| --------- | ------ | --------------------------------- |
| `balance` | string | The balance in HYC of the address |

**Response Error Table**

| Status | Error             | Message                                              |
| ------ | ----------------- | ---------------------------------------------------- |
| 400    | `INVALID_ADDRESS` | invalid address                                      |
| 404    | `NOT_FOUND`       | the resource cannot be found / currently unavailable |

GET/api/v1/wallet/{address}/balance

**Example request**

```
$ curl -X GET http://localhost:2442/api/v1/wallet/H23fF8ktBWYwK7aHFbPSW52LtoHcbDvmT/balance \
    -H 'Content-Type: application/json;charset=utf-8'
```

**Response (Success)**

```
{ "balance": "76722.558742064" }
```