API 주요 에러 코드

개요

API 요청값이 유효하지 않거나 처리 중 오류가 발생한 경우, HTTP 상태 코드와 함께 다음과 같은 형태의 JSON body가 리턴됩니다.

{
  "error": {
    "message": "<오류에 대한 설명>",
    "name": "<오류 코드>"
  }
}

주요 오류 코드는 다음과 같습니다.

코드	설명
invalid_parameter	잘못된 파라미터 입니다.
invalid_price	주문가격 단위를 잘못 입력하셨습니다. 확인 후 시도해주세요.
under_price_limit_ask under_price_limit_bid	주문가격은 최소 %s 이상으로 주문 가능합니다.
invalid_price_ask invalid_price_bid	주문가격 단위를 잘못 입력하셨습니다. 확인 후 시도해주세요.
bank_account_required	실명확인 입출금 계좌 등록 후 이용가능합니다.
two_factor_auth_required	유효한 인증채널을 입력하세요.
currency does not have a valid value	빗썸에서 지원하지 않는 코인 입니다.

401 Unauthorized 오류는 대부분 JWT 서명이 올바르게 되지 않았을 때 발생합니다. 인증 헤더 만들기 문서를 참조하시어 서명이 올바르게 되었는지 확인해주세요.

코드	설명
order_not_found	주문을 찾지 못했습니다.
deposit_not_found withdraw_not_found	입출금 정보를 찾지 못했습니다.