> 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/tapd-api/btcbalance.md).

# BtcBalance

### 1.1.\[总数]链上BTC排行

#### 请求

<mark style="color:green;">`GET`</mark> `/btc_balance/get/rank/count`

示例

/btc\_balance/get/rank/count

#### 参数

无

#### 响应

```json
{"errno":0,"errmsg":"","data":6636}
```

### 1.2.\[分页]链上BTC排行

#### 请求

<mark style="color:green;">`GET`</mark> `/btc_balance/get/rank`

示例

/btc\_balance/get/rank?<mark style="color:orange;">limit</mark>=<mark style="color:blue;">10</mark>&<mark style="color:orange;">offset</mark>=<mark style="color:blue;">0</mark>

#### 参数

* `limit` 限制数据条数
* `offset` 跳过数据条数

#### 响应

* `id` <mark style="color:orange;">uint</mark> ID
* `username` <mark style="color:orange;">string</mark> 用户名
* `total_balance` <mark style="color:orange;">int</mark> 总余额
* `confirmed_balance` <mark style="color:orange;">int</mark> 已确认余额
* `unconfirmed_balance` <mark style="color:orange;">int</mark> 未确认余额
* `locked_balance` <mark style="color:orange;">int</mark> 锁定余额

```json
{"errno":0,"errmsg":"","data":[{"id":775,"username":"npub33VtvBa7yjXJjYm3bU4vjrD3pZjzTj7qWbYDsBACy1uDVFdfhtGapDFmcv2CpzuGYYTmWU9X919m6sdCPT9tC3jr","total_balance":11984130,"confirmed_balance":1990040,"unconfirmed_balance":9991090,"locked_balance":9998020},{"id":778,"username":"npub25suufr36xXTt2DjmGwrotybZSGRC8CQLYwTFPm7zaY7RRzdJhkhyKscHzguE6W7WfPbH9RQ94wDSeinLP7VJf4A","total_balance":10000000,"confirmed_balance":10000000,"unconfirmed_balance":0,"locked_balance":0},{"id":182,"username":"npub31QWosdoeHyM2jZHbzaQ99xnRqKcxde4sxzZorDdrNcpmjxm4uTeLC4XmvtmYTgtDM9H4VhzSsb768saJER8AJnC","total_balance":2079176,"confirmed_balance":2083176,"unconfirmed_balance":0,"locked_balance":4000},{"id":779,"username":"npub31R3amR4SaFSYiV4sshhW7K2uReu85xwLduW2HyNLPg4BNAPsBECmchmVT5zxZ7iAKhtisuQWCopzhS7VNnPtifX","total_balance":1000000,"confirmed_balance":1000000,"unconfirmed_balance":0,"locked_balance":0},{"id":242,"username":"npub29LdwFpEKt28RM9N33cQvNfEJNrn88nvuxo1RSXbuJ1goJBPGgknZPidTJXNzD6bv2sTNgvv1JW88iTXmUCX5Kjz","total_balance":167145,"confirmed_balance":174145,"unconfirmed_balance":0,"locked_balance":7000},{"id":1720,"username":"npub32MRJM7kKrSR5PT8UhEXuBdXKyssACWLBW3imHpQ8S6AE862TAAjB8j68kpBHdPWoiaDvSH1hUpZWsrPpXyhdFzx","total_balance":99518,"confirmed_balance":102518,"unconfirmed_balance":0,"locked_balance":3000},{"id":194,"username":"npub25r5EW2xpDiasQuWrPpxHSdFsun1eYSW9Fu4UwEeeqESF3p6SmXxnG22UejQJYpjh96mjdbVAKCdYYTGRmm1zkz5","total_balance":62457,"confirmed_balance":66457,"unconfirmed_balance":0,"locked_balance":4000},{"id":21,"username":"npub21RSreApu57EFjeU2eCB9JP37GtEQkkVzFnGXUB2pkhYg7zZCV1yifaYjhoSnKfD1o5E2nMotCzu5nmqQD7TtuA2","total_balance":57920,"confirmed_balance":59920,"unconfirmed_balance":0,"locked_balance":2000},{"id":3404,"username":"npub29MUWSPwW2E2CWd18EHc9C6qEkK45EZrKyddZi4BWzj2Zk89zJdFzZnWiHJhSnGPYiod2WbCC1SvAmo1JPbP8wyv","total_balance":49157,"confirmed_balance":62146,"unconfirmed_balance":0,"locked_balance":12989},{"id":747,"username":"npub272SCn6fwUNuPHKk8zU6oQDj4DqyzVJ68iWnyF8E446utdzKU5kCz4qYe1h2zzw9ATjnJoVZPjBCKQKmyKWKXUgf","total_balance":40000,"confirmed_balance":41000,"unconfirmed_balance":0,"locked_balance":1000}]}
```