API 에러코드

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

{
    "result": "error",
    "error_code": "105",
    "error_msg": "Price is not correct"
}

{
    "result": "error",
    "errorCode": "105",
    "errorMsg": "Price is not correct"
}

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

Code	Return Message	Description
4	Blocked user access	제한된 사용자의 접근입니다.
8	Request Token Parameter is needed	토큰 파라미터 요청이 필요 합니다.
10	This IP address is not allowed.	접근이 제한된 IP로부터의 요청입니다.
12	Invalid access token	유효하지 않은 액세스 토큰입니다.
20	This service does not exist	존재하지 않은 API 서비스입니다.
21	Customers who need to register for API usage	API 사용을 위한 등록이 필요 합니다.
22	This service is not approved	승인되지 않은 서비스입니다.
23	Invalid App Secret	유효하지 않은 App Secret 입니다. 코인원 웹 > Open API 메뉴에서 상태 확인 부탁드립니다.
24	Invalid App Id	유효하지 않은 APP ID 입니다. 코인원 웹 > Open API 메뉴에서 상태 확인 부탁드립니다.
25	Request Token does not exist	존재하지 않은 Request Token 입니다.
26	Failed to delete Request Token	Request Token 삭제를 실패 하였습니다.
27	Access Token does not exist	존재하지 않은 Access Token 입니다.
28	Failed to delete Access Token	Access Token 삭제 실패 하였습니다.
29	Failed to refresh Access Token	Access Token을 리프레쉬 하는데 실패 하였습니다.
40	Invalid API permission	승인되지 않은 API 권한입니다.
50	You can use the API after complete Coinone identity verification by web or app	코인원 웹이나 앱을 통한 KYC 인증 이후 API 이용이 가능합니다.
51	This API is no longer available	더 이상 유효하지 않은 API 입니다.
52	Customers who did not complete the real name account verification are not allowed to use this service	실명 계좌 인증을 완료하지 않은 고객 입니다. 코인원 앱을 통해 실명 계좌 인증이 필요 합니다.
53	Order is rejected by market monitoring. Please contact CS center	이상거래 의심 내역이 탐지되어 거래를 할 수 없는 상태입니다. 고객 센터로 연락 부탁드립니다.
101	Invalid format	유효하지 않은 포맷입니다.
103	Lack of Balance	잔고가 부족 합니다.
104	Order id is not exist	존재하지 않은 주문입니다.
105	Price is not correct	올바르지 않은 가격입니다.
107	Parameter error	파라메터 에러입니다.
108	Unknown cryptocurrency	존재하지 않은 종목 심볼입니다.
109	Unknown cryptocurrency pair	존재하지 않은 거래 종목입니다.
111	The order unavailable due to significant price difference between the order price and the current price	주문 가격과 현재 가격의 현격한 차이로 주문이 불가 합니다.
116	Already Traded	이미 체결된 주문입니다.
117	Already Canceled	이미 취소된 주문입니다.
118	Already Submitted.	이미 등록된 주문입니다.
120	V2 API payload is missing	V2 API payload 값 입력이 필요 합니다.
121	V2 API signature is missing	V2 API signature 값 입력이 필요 합니다.
122	V2 API nonce is missing	V2 API nonce 값 입력이 필요 합니다.
123	V2 API signature is not correct	V2 API signature 값이 올바르지 않습니다.
130	V2 API Nonce value must be a positive integer	V2 API Nonce 값은 양의 숫자 값이어야 합니다.
131	V2 API Nonce is must be bigger then last nonce	V2 API Nonce 값은 이전 Nonce 값보다 커야 합니다.
132	Nonce already used	이미 사용된 Nonce 값 입니다.
133	Nonce must be in the form of a UUID	Nonce값은 UUID 포맷이어야 합니다.
151	It's V2 API. V1 Access token is not acceptable	V1의 Access Token으로는 V2 API 이용이 불가합니다.
152	Invalid address	유효하지 않은 주소입니다.
153	The address is detected by FDS. Please contact our customer center	FDS에 의해 제한된 주소입니다. 고객 센터로 연락 부탁드립니다.
154	The address is not registered as an API withdrawal address	API 출금 주소 등록이 필요한 주소입니다.
155	Withdrawal through the 'CODE Solution' requires registration of the deposit address	CODE 솔루션을 통한 출금을 위해서는 입금 주소 생성이 필요합니다. 코인원 웹/앱에서 입금주소 생성 후 요청하시기 바랍니다.
156	The withdrawal address does not exist	존재하지 않은 출금 주소입니다.
157	Insufficient balance	잔액이 부족합니다.
158	Minimum withdrawal quantity insufficient	최소 출금 가능 금액보다 부족합니다.
159	Required the memo to proceed with the withdrawal	출금을 위해서는 Memo 입력이 필요합니다.
160	Withdrawal/Deposit id is invalid	단일 입출금 내역 조회 시 올바르지 않은 입출금 내역 식별 ID가 입력된 경우입니다.
161	price is required for LIMIT or STOP_LIMIT order.	지정가, 예약 지정가 주문시 필수정보인 가격필드가 입력되지 않은 경우입니다.
162	qty is required for LIMIT or STOP_LIMIT or MARKET(SELL) order.	지정가, 예약 지정가, 시장가(매도), 주문시 필수정보인 수량필드가 입력되지 않은 경우입니다.
163	post_only is required for LIMIT order.	지정가 주문시 필수정보인 post_only필드가 입력되지 않은 경우입니다.
164	trigger_price is required for STOP_LIMIT order	예약 지정가 주문시 필수정보인 trigger_price 필드가 입력되지 않은 경우입니다.
165	amount is required for MARKET(BUY) order.	시장가(매수) 주문시 필수정보인 총액필드가 입력되지 않은 경우입니다.
166	Not Supported Order Type.	V2.1 Order API 요청시 입력한 주문타입이 지원하지 않는 주문타입인 경우입니다. 가능한 주문 타입 : LIMIT, MARKET, STOP_LIMIT (대문자만 가능)
167	trigger price and current price can not be same.	예약지정가 주문시 trigger_price 에 입력하신 값이 해당 코인의 현재가와 동일한 경우입니다.
202	Withdrawal quantity is not correct	옳바르지 않은 출금 수량입니다. (최소 출금 수량 미만 혹은 지원하지 않는 자릿수)
300	Invalid order information	유효하지 않은 주문 정보입니다.
305	Invalid quantity	잘못된 수량이 입력되었습니다.
306	Cannot be process the orders below the minimum amount	최소 수량 이하로는 주문이 불가 합니다.
307	Cannot be process the orders exceed the maximum amount	최대 수량 이상으로는 주문이 불가 합니다.
308	Price is out of range.	주문 요청 시 입력한 가격이 최소 주문 가능 가격~최대 주문 가능 가격 범위를 벗어날 경우 발생합니다.
309	Qty is out of range.	주문 요청 시 입력한 수량이 최소 주문 가능 수량~최대 주문 가능 수량을 벗어날 경우 발생합니다.
310	Unavailable price unit. Please check the Range unit API to get the price_unit.	가격 단위가 유효하지 않을 때 발생합니다.
312	Duplicated user_order_id	중복된 user_order_id
313	user_order_id and order_Id cannot be requested together. Otherwise, neither was entered	order_id 와 user_order_id 가 함께 요청되거나, 둘다 입력되지 않았을 경우
314	Invalid user_order_id (It must be lower case)	잘못된 user_order_id (대문자 혹은 지원하지 않는 특문, 150자 초과)
315	The API does not support a portfolio.	포트폴리오를 지원하지 않는 API 입니다.
316	Invalid range	조회 범위가 올바르지 않을 경우
317	Invalid size	조회 사이즈가 올바르지 않을 경우
405	Server error	서버 에러가 발생하였습니다.
1201	The V2 order API only supports limit order types.	v2의 특정 주문 조회 시(v2/order/query_order) 조회하려는 주문이 지정가 주문이 아닌 경우 발생합니다. (v2는 시장가, 예약 지정가를 지원하지 않아 발생하는 에러입니다.)
1202	This API is deprecated and only supports limit order type.	v21의 특정 주문 정보 조회 시(v2.1/order/info) 조회하려는 주문이 지정가 주문이 아닌 경우 발생합니다. (v2.1/order/info는 시장가, 예약 지정가를 지원하지 않아 발생하는 에러입니다.)
1206	User not found	존재하지 않은 고객입니다.
3001	Withdrawal of the virtual asset has been suspended. Please check our notice	출금이 일시적 혹은 영구적으로 정지된 가상자산입니다. 공지사항을 확인 부탁드립니다.
3002	Withdrawal is rejected	출금이 특정 사유로 인해 거절된 상태입니다.
3003	Exceed daily withdrawal limit	일일 출금 가능 수량을 초과 하였습니다.
3005	Try again after complete phone verification	휴대폰 번호 인증 완료 하신 후에 재시도 부탁드립니다.
3006	Withdrawal is restricted for 72 hours after the first KRW deposit	최초 원화 입금 후 72시간 동안은 가상자산 출금이 제한됩니다.
3007	An error in the balance. Please contact CS center	잔고에 오류가 발생하였습니다. 고객 센터에 연락 부탁드립니다.
3009	Account was detected through FDS system monitoring	이상거래에 탐지되어 이용할 수 없는 상태입니다.
3010	Account is locked	계정 잠금으로 인해 출금이 불가한 경우입니다. 잠금 해제는 최신 버전의 앱 또는 웹페이지에서 로그인을 통해 진행할 수 있습니다.
3012	CODE error: withdrawal was rejected by CODE solution	CODE 솔루션에서 출금을 거절한 경우입니다.
3013	CODE error: invalid parameter	CODE 거래소 정보 또는 수취인 정보에서 에러가 발생한 경우입니다.
3014	CODE error: This address does not exist. Please confirm the withdrawal address.	입금 주소가 상대 Vasp 에서 찾을 수 없는 경우
3015	CODE error: Recipient information does not match. Please check the information registered in either the Coinone withdrawal address list or the beneficiary VASP.	코인원에 설정된 수취인 정보와 상대 Vasp 에 설정된 수취인 정보가 다를 경우
3016	CODE error: Recipient information is invalid. Please check the registered information in the Coinone withdrawal address list.	코인원 주소록에 설정된 수취인 정보 수정이 필요한 경우.
3017	Re-verification of the whitelisted address is required on the website or app.	KYC 재이행으로 인해 APP 또는 Web에서 출금주소 재확인이 필요한 경우입니다. 웹 혹은 앱의 주소록에서 화이트리스트 주소 사용확인에 대한 동의가 필요합니다.