API 주요 에러 코드 목록

개요

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

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

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

코드	설명
create_ask_error create_bid_error	주문 요청 정보가 올바르지 않습니다. 파라미터 값이 올바른지 확인해주세요. 특히, 시장가 주문임에도 가격을 입력하여 오류가 발생하는 경우가 많습니다. 주문하기 문서를 참조해주세요.
insufficient_funds_ask insufficient_funds_bid	매수/매도 가능 잔고가 부족합니다.
under_min_total_ask under_min_total_bid	주문 요청 금액이 최소주문금액 미만입니다.
withdraw_address_not_registerd	허용되지 않은 출금 주소입니다. 허용 목록에 등록된 주소로만 출금이 가능합니다.
validation_error	잘못된 API 요청입니다. 누락된 파라미터가 없는지 확인해주세요.

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

코드	설명
invalid_query_payload	JWT 헤더의 페이로드가 올바르지 않습니다. 서명에 사용한 페이로드 값을 확인해주세요.
jwt_verification	JWT 헤더 검증에 실패했습니다. 토큰이 올바르게 생성, 서명되었는지 확인해주세요.
expired_access_key	API 키가 만료되었습니다.
nonce_used	이미 요청한 nonce값이 다시 사용되었습니다. JWT 헤더 페이로드의 nonce 값은 매번 새로운 값을 사용해야합니다.
no_authorization_i_p	허용되지 않은 IP 주소입니다.
out_of_scope	허용되지 않은 기능입니다.