> 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/assetbalance.md).

# AssetBalance

### 1.上传资产余额信息

*每次查询余额后调用*

```go
func UploadAssetBalanceInfo(token string, deviceId string) string
```

#### 参数

`token` <mark style="color:orange;">string</mark> 登录token

`deviceId`<mark style="color:orange;">string</mark> 设备ID

#### 响应

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

### 2.通过资产ID查询服务器保存的资产持有人信息

```go
func GetAssetHolderBalance(token string, assetId string) string
```

#### 参数

`token` <mark style="color:orange;">string</mark> 登录token

`assetId`<mark style="color:orange;">string</mark> 资产ID

#### 响应

**\[2024-7-19 13:47:19]**&#x589E;加username，之后也以此字段作为用户标识符

`username` <mark style="color:orange;">string</mark> 用户名，即公钥

`balance` <mark style="color:orange;">int</mark> 余额

```json
{"success":true,"error":"","code":200,"data":{"asset_id":"16f4e32dfe831e247786c5e00106b651085b8484c1e287f52b975870b03e512f","asset_balances":[{"version":0,"balance":42,"device_id":"123","user_id":1,"username":"npub27EjQpwLGPPBLEsNbSq4wcK5v19mcxGKFjQRkw2n7YsC3t8teA2ar4Ju3rShj83Xt77DTsBYKV4BfUr4TBKkDHMZ"}]}}
```

### 3.通过资产ID和每页数据条数查询服务器保存的资产持有人信息(分页)的页数

```go
func GetAssetHolderBalancePageNumber(token string, assetId string, pageSize int) string
```

#### 参数

`token` <mark style="color:orange;">string</mark> 登录token

`assetId`<mark style="color:orange;">string</mark> 资产ID

`pageSize` <mark style="color:orange;">int</mark> 每页数据条数

#### 响应

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

### 4.通过资产ID查询服务器保存的资产持有人信息(分页)

```go
func GetAssetHolderBalancePage(token string, assetId string, pageSize int, pageNumber int) string
```

#### 参数

`token` <mark style="color:orange;">string</mark> 登录token

`assetId`<mark style="color:orange;">string</mark> 资产ID

`pageSize` <mark style="color:orange;">int</mark> 每页数据条数

`pageNumber` <mark style="color:orange;">int</mark> 第几页

#### 响应

`username` <mark style="color:orange;">string</mark> 用户名，即公钥

`balance` <mark style="color:orange;">int</mark> 余额

```json
{"success":true,"error":"","code":200,"data":{"asset_id":"47ed120d4b173eb79ba46cd1959bb9c881cb69332cf8a21336110bda05402308","asset_balances":[{"version":0,"balance":1840000,"device_id":"cd7a4e21a7cfa900","user_id":98,"username":"npub29ZFHc5HE4BNCPQ8DWvYgf7MdnMyVTVqUnygfHu5XRZGn3LaJxasjQH9dg9WvLWvn3HxQE2BZ7LZNJzJ3nmSa8Mz"},{"version":0,"balance":10000000,"device_id":"44e461907c52f188","user_id":94,"username":"npubxvRDx46gLFz7YSvE1scB3erev5fhwsUKrTJFsG8i8M9W4ttWnJ1HV6Uo2whkBPicwY73wn7dXBoRGhzQoyAeich"},{"version":0,"balance":140000,"device_id":"3600b749585b7f3a","user_id":148,"username":"npuby797RTNVtcWVhD6aVxe8W7iC5HsF4VzopLFQr7fBC157Uv3XiWU1g3GrjXDFrj6Sq4XHVyJxsVdocURpAZXuDHc"},{"version":0,"balance":140000,"device_id":"a952313d24ce2970","user_id":124,"username":"npub28CRcAKVL7rpa6cdPMJiK18ee49M3JuMPHpqQtAWnc9ABezBLn3XS9zigiatoQ1jVDwQvZiEfkfEAZvgfqRoJPjD"},{"version":0,"balance":140000,"device_id":"dca025fddefc9b96","user_id":177,"username":"npub22avDoRsniwYShf2reAAnihRvwAM3oJXTLsU1KpHKgktyvxdBj1mRUTQy4DassMf1vxvGxMXmu7TNrWTjGdaCQ57"}]}}
```