> 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/ko-kr/undefined-2/undefined-1.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`. [지원되는 통화 보기](/ko-kr/undefined-2/undefined.md) | #### 인터페이스 반환 (Interface return) | **이름** | **유형** | **설명** | **설명** | | ----------- | ------- | ---------------------------------------------- | ------------------------------------------ | | code | integer | [서비스 상태 코드](/ko-kr/undefined-5/undefined.md) | 서비스 상태 코드. 0: 성공, 0이 아님: 구체적인 원인은 `msg` 참조 | | msg | string | 상태 서비스 메시지 | 상태 서비스 메시지 | | request\_id | string | 요청 ID | 요청 ID | | data | array | [가맹점 잔액 객체](/ko-kr/undefined-1/undefined-6.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 %}