# GetBtcBalance

<mark style="color:green;">`POST`</mark> /api/get-btc-balance

**Headers**

| Name          | Value              |
| ------------- | ------------------ |
| Content-Type  | `application/json` |
| Authorization | `Bearer <token>`   |

**Body**

| Name        | Type   | Description                                                |
| ----------- | ------ | ---------------------------------------------------------- |
| `wallet_id` | string | The end user's wallet id                                   |
| btc\_addr   | string | The returned BTC address when initially create this wallet |

**Request**

```json
{
  "wallet_id": "10e21d53-82d3-43d6-99bc-03ea6945d902",
  "btc_addr": "bc1qp9zm6x5q6y02036l2q93936c4fs3acjr546yly"
}
```

**Response**

{% tabs %}
{% tab title="200" %}

```json
{
    "code": 0,
    "data": {
        "addr": "bc1qp9zm6x5q6y02036l2q93936c4fs3acjr546yly",
        "balance": 169931100
    },
    "message": "",
    "traceid": "a73c5849-6a10-4bda-a411-d6c236277939"
}
```

{% endtab %}

{% tab title="400" %}

```json
{
  "error": "Invalid request"
}
```

{% endtab %}
{% endtabs %}
