BalancePrivate API
회원이 보유한 자산 정보를 제공합니다.
POST https://api.bithumb.com/info/balance
Example Response
{
"status" : "0000",
"data" : {
"total_btc" : "665.40127447",
"total_krw" : "305507280",
"in_use_btc" : "127.43629364",
"in_use_krw" : "8839047.0000000000",
"available_btc" : "537.96498083",
"available_krw" : "294932685.000000000000",
"xcoin_last_btc": "505000"
}
}
Request Parameters
| 요청 변수 | 설명 | 타입 |
|---|---|---|
| apiKey | 사용자 API Key | String/필수 |
| secretKey | 사용자 Secret Key | String/필수 |
| currency | 가상자산 영문 코드, ALL(전체) 기본값 : BTC |
String |
Response
| 필드 | 설명 | 타입 |
|---|---|---|
| status | 결과 상태 코드 (정상: 0000, 그 외 에러 코드 참조) | String |
| total_{currency} | 전체 가상자산 수량 | Number (String) |
| total_krw | 전체 원화(KRW) 금액 | Number (String) |
| in_use_{currency} | 주문 중 묶여있는 가상자산 수량 | Number (String) |
| in_use_krw | 주문 중 묶여있는 원화(KRW) 금액 | Number (String) |
| available_{currency} | 주문 가능 가상자산 수량 | Number (String) |
| available_krw | 주문 가능 원화(KRW) 금액 | Number (String) |
| xcoin_last_{currency} | 마지막 체결된 거래 금액 ALL 호출 시 필드 명 – xcoin_last_{currency} |
Number (String) |
※ RESPONSE 필드 내 {currency} 부분은 화폐 영문 코드 소문자로 입력