> For the complete documentation index, see [llms.txt](https://bitlong.gitbook.io/api-doc/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://bitlong.gitbook.io/api-doc/btcbalance/btcblance-rest-api.md).

# BtcBlance REST API

## 1.查询BTC余额

<mark style="color:green;">`GET`</mark> `http://132.232.109.84:8095/btc_balance/get`

#### 请求参数

无

#### 请求响应

* `total_balance` 总余额
* `confirmed_balance` 已确认余额
* `unconfirmed_balance` 未确认余额
* `locked_balance` 锁定余额
* `device_id`设备ID

```json
{
    "success": true,
    "error": "",
    "code": 200,
    "data": {
        "ID": 1,
        "CreatedAt": "2024-06-24T16:24:42.795+08:00",
        "UpdatedAt": "2024-06-24T17:20:39.467+08:00",
        "DeletedAt": null,
        "username": "bob",
        "total_balance": 12,
        "confirmed_balance": 23,
        "unconfirmed_balance": 34,
        "locked_balance": 45,
        "status": 1
    }
}
```

## 2.上传BTC余额

<mark style="color:orange;">`POST`</mark> `http://132.232.109.84:8095/btc_balance/set`

#### 请求参数

JSON

* `total_balance` 总余额
* `confirmed_balance` 已确认余额
* `unconfirmed_balance` 未确认余额
* `locked_balance` 锁定余额
* `device_id`设备ID

```json
{
        "total_balance": 12,
        "confirmed_balance": 23,
        "unconfirmed_balance": 34,
        "locked_balance": 45,
        "device_id" : "qwrtyuiop"
}
```

#### 请求响应

```json
{
    "success": true,
    "error": "",
    "code": 200,
    "data": null
}
```