> For the complete documentation index, see [llms.txt](https://apidoc.tokenpay.me/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://apidoc.tokenpay.me/zh-cn/huo-bi/yuecha-xun.md).
# 余额查询
{% hint style="info" %}
说明
查询余额详情以及实时状态
{% endhint %}
## **接口地址**
```
POST https://api.tokenpay.me/v1/merchant/balance
```
## **接口参数**
| 名称 | 位置 | 类型 | 必选 | 说明 |
| -------- | ---- | ------ | -- | --------------------------------------------------------------- |
| mch\_id | body | string | 是 | 商户 ID，示例值：`12345678` |
| chain | body | string | 是 | 所属公链，示例值：`TRON` |
| currency | body | string | 是 | 币种，示例值：`TRX` [查看支持币种](/zh-cn/huo-bi/cha-xun-bi-zhong-xin-xi.md) |
## **接口返回**
| 名称 | 类型 | 说明 | 说明 |
| ----------- | ------- | ------------------------------------------------------------------- | ---------------------------- |
| code | integer | [业务状态码](https://ttpay.gitbook.io/api/cuo-wu-ma/ye-wu-zhuang-tai-ma) | 业务状态码 0 成功 非 0 表示具体原因参考`msg` |
| msg | string | 状态业务消息 | 状态业务消息 |
| request\_id | string | 请求 ID | 请求 ID |
| data | array | [merchantBalance](/zh-cn/shuo-ming/shu-ju-jie-gou.md#shang-hu-yu-e) | 内容 |
## **返回示例**
```json
{
"code": 0,
"msg": "ok",
"request_id": "08250916-a677-4a36-a090-323807ac644c",
"data": {
"merchant_id": 167,
"mch_id": "12345678",
"network": "TRC20",
"chain": "TRON",
"balance": "54670000",
"currency": "USDT",
"decimal": 6,
"create_time": 1724237814113,
"modify_time": 1724239248394,
"cash_time": 0
}
}
```
## **代码示例**
{% tabs %}
{% tab title="Shell" %}
```sh
curl --location --request GET 'https://api.tokenpay.me/v1/merchant/balance
--header 'Authorization: '
--header 'User-Agent: Tokenpay API (https://tokenpay.me)'
--header 'Content-Type: application/json'
--data-raw ''
```
{% endtab %}
{% tab title="Go" %}
```go
package main
import (
"fmt"
"strings"
"net/http"
"io/ioutil"
)
func main() {
url := "https://api.tokenpay.me/v1/merchant/balance"
method := "GET"
payload := strings.NewReader(``)
client := &http.Client {
}
req, err := http.NewRequest(method, url, payload)
if err != nil {
fmt.Println(err)
return
}
req.Header.Add("Authorization", "")
req.Header.Add("User-Agent", "Tokenpay API (https://tokenpay.me)")
req.Header.Add("Content-Type", "application/json")
res, err := client.Do(req)
if err != nil {
fmt.Println(err)
return
}
defer res.Body.Close()
body, err := ioutil.ReadAll(res.Body)
if err != nil {
fmt.Println(err)
return
}
fmt.Println(string(body))
}
```
{% endtab %}
{% tab title="PHP" %}
```php
'https://api.tokenpay.me/v1/merchant/balance',
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => '',
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 0,
CURLOPT_FOLLOWLOCATION => true,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => 'GET',
CURLOPT_POSTFIELDS =>'',
CURLOPT_HTTPHEADER => array(
'Authorization: ',
'User-Agent: Tokenpay API (https://api.tokenpay.me)',
'Content-Type: application/json'
),
));
$response = curl_exec($curl);
curl_close($curl);
echo $response;
```
{% endtab %}
{% tab title="Python" %}
```python
import http.client
import json
conn = http.client.HTTPSConnection("https://api.tokenpay.io")
payload = ""
headers = {
'Authorization': '',
'User-Agent': 'TokenpayAPI (https://tokenpay.io)',
'Content-Type': 'application/json'
}
conn.request("GET", "/v1/merchant/balance", payload, headers)
res = conn.getresponse()
data = res.read()
print(data.decode("utf-8"))
```
{% endtab %}
{% tab title="Java" %}
```java
OkHttpClient client = new OkHttpClient().newBuilder()
.build();
MediaType mediaType = MediaType.parse("application/json");
RequestBody body = RequestBody.create(mediaType, "");
Request request = new Request.Builder()
.url("https://api.tokenpay.me/v1/merchant/balance")
.method("GET", body)
.addHeader("Authorization", "")
.addHeader("User-Agent", "Tokenpay API (https://tokenpay.io)")
.addHeader("Content-Type", "application/json")
.build();
Response response = client.newCall(request).execute();
```
{% endtab %}
{% endtabs %}