> For the complete documentation index, see [llms.txt](https://docs.topay.mobi/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.topay.mobi/cn/reference/api-reference/balance.md).

# 余额

查询指定资产的余额信息。

{% hint style="warning" %}
每个请求都必须包含[公共参数](/cn/reference/api-reference/common-parameters.md)。
{% endhint %}

## **商户余额** <a href="#partner-balance" id="partner-balance"></a>

## 商户账户余额 <a href="#partner-account-balance" id="partner-account-balance"></a>

<mark style="color:green;">`POST`</mark> `https://api.topay.mobi/v1/balance/partner`

#### 请求体 <a href="#request-body" id="request-body"></a>

| 名称                                         | 类型     | 说明             |
| ------------------------------------------ | ------ | -------------- |
| currency<mark style="color:red;">\*</mark> | String | 要查询余额的数字货币资产名称 |

{% tabs %}
{% tab title="200: OK " %}

```javascript
{
"data":
   { 
    "currency":"TRX",        
    "balance":"0.200000000000000000",
    "availableBalance":"0.200000000000000000",
    "freezeBalance":"0.000000000000000000",
    "pendingSettleBalance":"0"
   },
"code":"200",
"message":"Success"
}
```

{% endtab %}
{% endtabs %}

<details>

<summary>代码示例</summary>

```java
// Some code
String respStr = client.queryPartnerBalance(
                "USDT_TRC20",                                //currency
                "2000051",                                   //partner_id
                String.valueOf(System.currentTimeMillis())   //nonce
                );
 System.out.println(respStr);
```

</details>

{% hint style="info" %}
示例代码请参阅 [GitHub](/cn/reference/api-reference.md#demo-client)。
{% endhint %}