# Balance

## Make a request (mainnet)

For mainnet a valid apikey is needed and needs to be send as a query parameter. You can [create a temporary mainnet api key](https://api.bitcoin-balance-api.com/keys) for testing the api. The correct url for mainnet is:

```
https://api.bitcoin-balance-api.com/v1/address/34xp4vRoCGJym3xR7yCVPFHoCNxv4Twseo?apikey=$SECRET
```

Where `$SECRET` needs to be replaced with your own apikey.

## Response

The response from the api contains two fields, `status` and `balance`. When status is `200` the request was successful and it will contain the value in the `balance` field. E.g.:

```json
{ "status": 200, "balance": 19989726659 }
```

The `status` field can contain different responses like [400, 401, 404, 422 or 500](https://docs.bitcoin-balance-api.com/error-codes) depending on the request.

### Balance Calculation

The `balance` is in satoshi's and if you want to change it to BTC, it needs to be divided by **100000000**. E.g.:

```python
# Python Example
balance=7821967447
balance_btc=balance/100000000
print(f'Balance in Bitcoin: %s' % (balance_btc))
```