> For the complete documentation index, see [llms.txt](https://docs.elven.com/v3/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.elven.com/v3/chinese/openapi/v3/cha-xun-zhang-hu-ji-suan-yu-e.md).

# 查询账户计算余额

### 接口概述

该接口用于查询系统中已有账户的计算余额数据。单次最多查询 20 个账户的余额数据。每个账户最多返回 100 个币种的余额数据。

* **请求方式**：`POST`
* **请求 URL**：`https://openapi.elven.com//open/v3/entityAccount/treasuryBalances`

### 请求头参数

<table><thead><tr><th width="202">参数名</th><th width="90">类型</th><th width="64">必填</th><th>说明</th></tr></thead><tbody><tr><td>elven-api-key</td><td>String</td><td>是</td><td>分配给您的API密钥</td></tr><tr><td>elven-api-sign</td><td>String</td><td>是</td><td>请求签名，用于验证请求合法性</td></tr><tr><td>elven-api-timestamp</td><td>String</td><td>是</td><td>请求时间戳，毫秒级</td></tr></tbody></table>

[查看详细说明](https://docs.elven.com/v3/openapi/jie-kou-shou-quan#elven-api-sign)

### 请求参数

#### Body 参数

<table><thead><tr><th width="214.921875">参数名</th><th width="94">类型</th><th width="91.96875">必填</th><th>说明</th></tr></thead><tbody><tr><td>entityAccountNameList</td><td>array</td><td>是</td><td>要查询的账户名称数组</td></tr></tbody></table>

#### 请求示例

```json
{
    "entityAccountNameList": [
        "B2C2",
        "Co bo",
        "BCB"
    ]
}
```

### 响应参数

<table><thead><tr><th width="209">参数名</th><th width="94">类型</th><th>说明</th></tr></thead><tbody><tr><td>status</td><td>String</td><td>请求状态，值为 “success” 或 “failed”</td></tr><tr><td>data</td><td>Object</td><td>返回的主要数据</td></tr><tr><td>requestId</td><td>String</td><td>请求的唯一标识符</td></tr></tbody></table>

#### data

<table><thead><tr><th width="209">参数名</th><th width="94">类型</th><th>说明</th></tr></thead><tbody><tr><td>entityAccountname</td><td>String</td><td>账户名称</td></tr><tr><td>entityAccountId</td><td>String</td><td>账户 id</td></tr><tr><td>currencyList</td><td>Array</td><td>账户余额信息</td></tr></tbody></table>

#### currencyList 数组元素

<table><thead><tr><th width="210">参数名</th><th width="91">类型</th><th>说明</th></tr></thead><tbody><tr><td>currency</td><td>String</td><td>币种名称</td></tr><tr><td>currencyId</td><td>String</td><td>币种AssetID</td></tr><tr><td>balance</td><td>String</td><td>原始币种数量</td></tr><tr><td>balanceFC</td><td>String</td><td>报告币种金额</td></tr></tbody></table>

#### 响应示例

```json
{
    "status": "success",
    "data": [
        {
            "entityAccountId": "yBKdI5FKAhz3Q9GPIVcXgWln8opYRDvx",
            "currencyList": [
                {
                    "currency": "BTC",
                    "currencyId": "BTC",
                    "balanceFC": 43568.076457664,
                    "balance": "0.4"
                },
                {
                    "currency": "ETH",
                    "currencyId": "ETH",
                    "balanceFC": 31319.96663412,
                    "balance": "12"
                },
                {
                    "currency": "USDT",
                    "currencyId": "USDT",
                    "balanceFC": 5000.63065,
                    "balance": "5000"
                },
                {
                    "currency": "TRX",
                    "currencyId": "TRX",
                    "balanceFC": 0,
                    "balance": "0"
                },
                {
                    "currency": "EUR",
                    "currencyId": "EUR",
                    "balanceFC": 3657.471606279999,
                    "balance": "3120.199999999999"
                },
                {
                    "currency": "USD",
                    "currencyId": "USD",
                    "balanceFC": -50000,
                    "balance": "-50000"
                }
            ],
            "entityAccountname": "B2C2"
        },
        {
            "entityAccountId": "Wufv1hsNsXviCQE81o7HhR2yZpwdnrjB",
            "currencyList": [
                {
                    "currency": "USD",
                    "currencyId": "USD",
                    "balanceFC": 200,
                    "balance": "200"
                },
                {
                    "currency": "EUR",
                    "currencyId": "EUR",
                    "balanceFC": 11721.914,
                    "balance": "10000"
                },
                {
                    "currency": "JPY",
                    "currencyId": "JPY",
                    "balanceFC": 20427.42,
                    "balance": "3000000"
                },
                {
                    "currency": "SGD",
                    "currencyId": "SGD",
                    "balanceFC": -156.257934,
                    "balance": "-200"
                },
                {
                    "currency": "CHF",
                    "currencyId": "CHF",
                    "balanceFC": 68791.6468766974,
                    "balance": "54785.53"
                }
            ],
            "entityAccountname": "BCB"
        },
        {
            "entityAccountId": "s3AEVolAlLGeum4yrNVUQvt58oxsbc0E",
            "currencyList": [
                {
                    "currency": "BTC",
                    "currencyId": "BTC",
                    "balanceFC": 21653.33399945901,
                    "balance": "0.1988"
                },
                {
                    "currency": "ETH",
                    "currencyId": "ETH",
                    "balanceFC": 13045.288102554881,
                    "balance": "4.9982"
                },
                {
                    "currency": "TRX",
                    "currencyId": "TRX",
                    "balanceFC": 0,
                    "balance": "0"
                },
                {
                    "currency": "USDT",
                    "currencyId": "USDT",
                    "balanceFC": 1005.12676065,
                    "balance": "1005"
                }
            ],
            "entityAccountname": "Co bo"
        }
    ],
    "requestId": "5faff672-8a38-4c56-a6e7-04c5dc693a01"
}
```

### 注意事项

* 请求头中的 **elven-api-key**、**elven-api-sign** 和 **elven-api-timestamp** 为必填参数，用于验证请求的合法性和安全性。
* 单次最多支持 20 个账户名称，超出将返回错误。
* entityAccountNameList 不能为空，不能包含重复项。
* 若有一个或多个账户未匹配到，接口调用失败，并返回未识别的账户名称。