> 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/ja-jp/tong-huo/can-gao-zhao-hui.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`。[サポートされている通貨を表示](/ja-jp/tong-huo/tong-huo-qing-bao.md) | #### インターフェースの戻り値 (Interface return) | **名前** | **タイプ** | **説明** | **説明** | | ----------- | ------- | ------------------------------------------ | --------------------------------------- | | code | integer | [サービスステータスコード](/ja-jp/erkdo/suttasukdo.md) | サービスステータスコード。0：成功、0以外：具体的な原因は `msg` を参照 | | msg | string | ステータスサービスメッセージ | ステータスサービスメッセージ | | request\_id | string | リクエストID | リクエストID | | data | array | [加盟店残高オブジェクト](/ja-jp/yue-ming/dta.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 %}