> ## Documentation Index
> Fetch the complete documentation index at: https://developer-cn.cregis.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 查询地址余额

> 查询项目子地址余额

### 接入 API

POST /api/v1/sub\_address\_balance

### 请求

#### 请求参数

| 名称               | 类型             | 是否必须 | 描述                           |
| ---------------- | -------------- | ---- | ---------------------------- |
| pid              | integer(int64) | 是    | 项目编号                         |
| currency         | string         | 是    | 查询的代币标识，chain\_id\@token\_id |
| address          | string         | 否    | 查询的子地址，不传则查询项目中所有有余额的地址      |
| maximum\_balance | string         | 否    | 查询地址最大余额，包含                  |
| minimum\_balance | string         | 否    | 查询地址最小余额，包含                  |
| page\_num        | integer(int32) | 否    | 分页页数，如果不填，默认为1               |
| page\_size       | integer(int32) | 否    | 分页每页数量，如果不填默认为10，限制最大值为100   |
| nonce            | string         | 是    | 6位随机字符串                      |
| timestamp        | integer(int64) | 是    | 时间戳                          |
| sign             | string         | 是    | 签名串                          |

###### 请求示例

```json theme={null}
{
  "pid": 1382528827416576,
  "address": "",
  "currency": "195@195",
  "minimum_balance":"1"
  "maximum_balance":"10"
  "page_num": 1,
  "page_size": 10,
  "nonce": "hwlkk6",
  "timestamp": 1688004243314,
  "sign": "d6eef2de79e39f434a38efb910213ba6"
}
```

### 返回

#### 返回结果

| 名称   | 类型     | 描述   |
| ---- | ------ | ---- |
| code | string | 返回码  |
| msg  | string | 返回信息 |
| data | object | 返回数据 |

#### 返回数据 `data` 对象

| 名称         | 类型             | 描述                         |
| ---------- | -------------- | -------------------------- |
| pid        | integer(int64) | 项目编号                       |
| currency   | string         | 币种标识, chain\_id\@token\_id |
| address    | string         | 查询的地址                      |
| total      | string         | 总余额（可用+处理中）                |
| available  | string         | 可用余额                       |
| processing | string         | 处理中余额                      |

###### 返回示例

```json theme={null}
{
    "code": "00000",
    "msg": "ok",
    "data": {
        "total": 1,
        "rows": [
            {
              "pid":1395142548643840,
              "address":"TKDxZEycaxNosmH1V9x6hEacKgWF3RRZ7h",
              "currency":"198@TG3XXyExBkPp9nzdajDZsozEu4BkaSJozs",
              "total":"7",
              "available":"7",
              "processing":"0"
            }
        ],
        "pageNum": 1,
        "pageSize": 10
    },
}
```