바이낸스 (Binance) API 다뤄보기 #2

바이낸스 (Binance) API 다뤄보기 #2편입니다.

2편에서는 "Error codes for Binance (2017-12-01)"에 대해 다뤄 보겠습니다.

 

 

아주 상세한 번역은 아니고 입맛대로 변환한 내용이며 대략 어떤 내용인지 이해만 할 수 있을 정도이니 감안하고 보기 바랍니다.

Binance API를 이용한 각종 요청에 대해 에러가 발생하게 되면 아래와 같은 형태의 에러 코드와 메시지의 값을 리턴하며 에러 코드는 정해져 있지만 메시지값은 상황에 따라 다를 수 있습니다.

 

{
  "code":-1121,
  "msg":"Invalid symbol."
}

10xx - 일반적으로 발생되는 서버나 네트워크 문제

-1000 알 수 없음

• 요청을 처리하는 동안 알 수없는 오류가 발생했습니다.

-1001 접속 해제

• 내부 에러; 요청을 처리 할 수 ​​없습니다. 다시 시도하십시오..

-1002 비공인

• 실행할 수 있는 권한이 없습니다.

-1003 너무 많은 요청

• 너무 많은 요청을 할 수 없습니다.
• 너무 많은 요청이 대기중입니다.
• 단위 시간당 처리할 수 있는 요청 제한을 확인해주세요.
• 너무 많은 요청이 대기중이며 심할 경우 IP Ban 당할 수 있습니다.

-1006 예상치 못한 응답

• 예상치 못한 응답이 메시지 버스에서 수신되었습니다.
• 실행 상태를 알 수 없습니다.

-1007 시간제한

• 응답 대기 시간 제한 초과입니다.
• 요청 상태를 알 수 없습니다.
• 실행 상태를 알 수 없습니다.

-1013 잘못된 메시지

• 잘못된 메시지

-1014 주문표 구성 에러

• 지원되지 않는 주문 조합입니다.

-1015 너무 많은 주문 요청

• 너무 많은 주문 요청을 할 수 없습니다.
• 너무 많은 주문 요청을 할 수 없습니다. 단위 시간당 처리할 수 있는 주문 요청 제한을 확인 해주세요.

-1016 서비스 종료

• 이 서비스는 더 이상 제공되지 않습니다.

-1020 지원되지 않는 작업

• 이 작업은 지원되지 않습니다.

-1021 잘못된 TIMESTAMP

• 잘못된 TIMESTAMP

-1022 유효하지 않은 서명

• 이 요청에 대한 서명이 유효하지 않습니다.

11xx - 요청 문제

-1100 잘못된 문자가 입력됨

 -1101 너무 많은 매개 변수

• 너무 많은 매개 변수가 전달 되었습니다.
• 중복된 매개 변수가 전달 되었습니다.

-1102 필수 매개 변수가 없는 문제

• 필수 매개 변수가 전송되지 않았거나 널 (null)이거나 형식이 잘못되었습니다.

-1103 알 수 없는 매개 변수가 전달 됨

 -1104 일치하지 않는 매개 변수

-1105 매개 변수가 없거나 비어 있음

-1106 응답 할 수 없는 매개 변수

• 불필요하거나 응답 할 수 없는 매개 변수가 전송되었습니다.

-1114 TimeInForce(TIF) 값이 불 필요한데 입력 되었음

-1115 TimeInForece(TIF) 값이 잘못 되었음

-1116 주문 타입이 잘못 입력 되었음

-1117 매수(BUY) / 매도(SELL) 구분이 잘못 되었음

-1118 OrderID가 누락되었음

 -1119 원주문의 OrderID가 누락되었음 (취소/정정 등에 필요)

 -1120 잘못된 Interval 값이 입력 되었음

-1121 잘못된 symbol이 입력되었음

-1125 잘못되거나 유효하지 않은 Listen Key 가 입력되었음

 -1128 Params 조합이 잘못됨

 -1130 잘못된 매개변수가 전달 됨

20xx - Processing Issues

-2008 잘못된 API-Key가 입력됨

 -2013 입력된 주문이 없음 (OrderID를 기준으로 정정, 수정 등의 경우에 발생)

-2014 API-Key 입력 형식이 잘못 됨

-2015 MBX-Key (API-Key, IP, 권한)이 잘못 됨

Messages for -1010 ERROR_MSG_RECEIVED, -2010 NEW_ORDER_REJECTED, and -2011 CANCEL_REJECTED

Error message	Description
"Unknown order sent."	주문에 필요한orderId, clOrdId, origClOrdId가 잘못 입력됨
"Duplicate order sent."	중복된 주문임
"Market is closed."	입력한 symbol은 현재 거래 가능한 상태가 아님
"Account has insufficient balance for requested action."	주문에 필요한 잔고가 충분하지 않음
"Market orders are not supported for this symbol."	시장가 주문이 불가능한 symbol 임
"Iceberg orders are not supported for this symbol."	IceBerg 설정이 불가능한 symbol 임
"Stop loss orders are not supported for this symbol."	STOP_LOSS 설정이 불가능한 symbol 임
"Stop loss limit orders are not supported for this symbol."	STOP_LOSS_LIMIT 설정이 불가능한 symbol 임
"Take profit orders are not supported for this symbol."	TAKE_PROFIT 설정이 불가능한 symbol 임
"Take profit limit orders are not supported for this symbol."	TAKE_PROFIT_LIMIT 설정이 불가능한 symbol 임
"Price * QTY is zero or less."	주문 총액(가격 * 수량)이 기준치 미달임
"IcebergQty exceeds QTY."	icebergQty 수량이 주문에 필요한 최소 수량에 미달됨
"This action disabled is on this account."	해당 처리가 불가능한 계좌임
"Unsupported order combination"	orderType, timeInForce, stopPrice 그리고(또는)icebergQty 조합이 불가능함
"Order would trigger immediately."	생략
"Cancel order is invalid. Check origClOrdId and orderId."	origClOrdId 또는orderId가 이미 전송 되었음
"Order would immediately match and take."	입력한 LIMIT_MAKER 주문 타입은 최근 체결 가격과 일치하지 않음.

-9xxx Filter failures

Error message	Description
"Filter failure: PRICE_FILTER"	입력한 가격이 너무 낮/높거나 symbol의 exchange tick size에 맞지 않음
"Filter failure: LOT_SIZE"	입력한 수량이 너무 낮/높거나 symbol의 exchange의 step size에 맞지 않음
"Filter failure: MIN_NOTIONAL"	입력한 가격 * 수량에 의한 주문 총액이 너무 작은 규모임
"Filter failure: MAX_NUM_ORDERS"	이미 너무 많은 주문이 입력되어 있음
"Filter failure: MAX_ALGO_ORDERS"	이미 너무 많은 청산 주문이 존재함
"Filter failure: EXCHANGE_MAX_NUM_ORDERS"	이미 너무 많은 주문이 입력 되어 있음
"Filter failure: EXCHANGE_MAX_ALGO_ORDERS"	이미 너무 많은 청산 주문이 존재함

 

 

대충 입력한 것이므로 잘못된 내용이 있거나 누락된 내용이 있을 수 있음을 감안하고 보시고 추가로 궁금한 내용은 Comment 남겨 주세요.