API 레퍼런스

특정 자산 잔고 조회

고객이 보유한 특정 종목의 잔고 조회

Request Header

HeadersRequired/ OptionalDescription
X-COINONE-PAYLOADRequiredRequest body object -> JSON string -> base64
X-COINONE-SIGNATURERequiredHMAC(X-COINONE-PAYLOAD, SECRET_KEY, SHA512).hexdigest()

Request Body

fieldtyperequired/optionaldescription
access_tokenstringrequired사용자의 액세스 토큰 (access token)
noncestringrequiredUUID nonce (예: "022f53b2-8b2f-40c6-8e51-b594f562ee83")
currenciesarray of stringsrequired잔고 조회하려는 자산의 심볼 입력

Response Body

KeyTypeDescription
resultString정상 반환 시 success, 에러 코드 반환 시 error
error_codeNumberStringerror 발생 시 에러코드 반환, 성공인 경우 0 반환
balancesArray[Object]배열 형태의 잔고 정보
- availableNumberString가용 잔고 ('available’과 ‘limit’의 합이 전체 잔고)
- limitNumberString주문에 걸려있는 잔고
- average_priceNumberString구매한 종목의 평단가 (종목 단위로 표시)
- currencyString코인 심볼 (예: "BTC")
Language