post https://api.coinone.co.kr/v2.1/account/balance
고객이 보유한 특정 종목의 잔고 조회
Permission: 잔고조회 (Balance)
Request Header
| Headers | Required/ Optional | Description |
|---|---|---|
| X-COINONE-PAYLOAD | Required | Request body object -> JSON string -> base64 |
| X-COINONE-SIGNATURE | Required | HMAC(X-COINONE-PAYLOAD, SECRET_KEY, SHA512).hexdigest() |
Request Body
| field | type | required/optional | description |
|---|---|---|---|
| access_token | string | required | 사용자의 액세스 토큰 (access token) |
| nonce | string | required | UUID nonce (예: "022f53b2-8b2f-40c6-8e51-b594f562ee83") |
| currencies | array of strings | required | 잔고 조회하려는 자산의 심볼 입력 |
Response Body
| Key | Type | Description |
|---|---|---|
| result | String | 정상 반환 시 success, 에러 코드 반환 시 error |
| error_code | NumberString | error 발생 시 에러코드 반환, 성공인 경우 0 반환 |
| balances | Array[Object] | 배열 형태의 잔고 정보 |
| - available | NumberString | 가용 잔고 ('available’과 ‘limit’의 합이 전체 잔고) |
| - limit | NumberString | 주문에 걸려있는 잔고 |
| - average_price | NumberString | 구매한 종목의 평단가 (종목 단위로 표시) |
| - currency | String | 코인 심볼 (예: "BTC") |