> 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/ru-ru/valyuta/zapros-balansa.md). # Запрос баланса {% hint style="info" %} ПОДСКАЗКА (TIP) Проверьте баланс счета и статус в режиме реального времени. {% endhint %} #### Адрес интерфейса (Interface address) ``` POST https://api.tokenpay.me/v1/merchant/balance ``` #### Параметры интерфейса (Interface parameters) | Имя | Расположение | Тип | Обязательно | Описание | | -------- | ------------ | ------ | ----------- | -------------------------------------------------------------------------------------------------------- | | mch\_id | body | string | Да | ID продавца, пример значения:`12345678` | | chain | body | string | Да | Принадлежащая публичная сеть, пример значения: `TRON` | | currency | body | string | Да | Валюта, пример значения: `TRX`. [Просмотр поддерживаемых валют](/ru-ru/valyuta/informaciya-o-valyute.md) | #### Возврат интерфейса (Interface return) | **Имя** | **Тип** | **Описание** | **Описание** | | ----------- | ------- | --------------------------------------------------------------- | --------------------------------------------------------------------------------- | | code | integer | [Код состояния сервиса](/ru-ru/kod-oshibki/kod-sostoyaniya.md) | Код состояния сервиса. 0: успех, не 0: указывает на конкретную причину, см. `msg` | | msg | string | Сообщение службы состояния | Сообщение службы состояния | | request\_id | string | ID запроса | ID запроса | | data | array | [Объект баланса продавца](/ru-ru/opisanie/struktura-dannykh.md) | Содержимое | #### Пример возврата (Return example) ```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 } } ``` #### Пример кода (Example code) {% 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 %}