API 자주 묻는 질문 (FAQ)
Binance
2018-06-05 09:38

API 문서비공식 API 예시 

한도가 어떻게 되나요?

개요
세 가지 유형의 한도가 있으며 모두 언제든지 변경될 수 있습니다:
  1. 하드 리밋
  2. 머신 러닝(ML) 한도
  3. WAF (웹 애플리케이션 방화벽) 한도
하드 리밋:
  • 분당 요청 비중 1,200개 (이는 요청 1,200개와 반드시 동일하지는 않다는 점을 유의해주시기 바랍니다)
  • 10초당 주문 50개
  • 24시간당 주문 160,000개
하드 리밋은 [/api/v3/exchangeInfo] 엔드 포인트에 열거되어 있습니다.
머신 러닝 한도:
거래 행위는 일반 사용자를 기준으로 평가되며 너무 많이 벗어나면 5분에서 3일 범위 내의 정해진 시간 동안 거래가 금지됩니다.
거래 남용 점수가 있다고 가정해보겠습니다. 다음과 같은 경우에 점수가 증가합니다: 
  • 반복적으로 오더북에서 "한 호가 위" 또는 "선행" 매수/매도 주문을 제출합니다.
  • 거래를 실행하지 않고 주문 생성 및 취소를 매우 빠르게 진행합니다.
  • "전환율"이 낮습니다. "전환율"은 24시간 동안 총 거래 수를 총 주문 생성 및 취소 수로 나눈 값으로 정의됩니다(거래 수 / (주문 + 취소)).
  • "비중"이 낮습니다. "비중"은 24시간 동안 총 거래량을 총 주문 생성 및 취소 수로 나눈 값으로 정의됩니다(총 거래량 / (주문 + 취소)).
  • BNB를 기본 또는 견적 자산으로 사용하는 쌍을 거래할 때 남용 점수가 가중됩니다.
위의 정보보다 더 구체적인 정보는 제공되지 않습니다. 시행 착오를 통해 이상적인 거래 패턴을 달성하거나 다른 API 사용자와 최적의 행동을 논의해주시기 바랍니다.
WAF (웹 애플리케이션 방화벽) 한도:
WAF 규칙에 대해 정확한 세부 정보를 제공하지는 않지만 HTTP 403 오류를 수신한다면 규칙을 위반한 것입니다. 대부분의 경우 5분 이내에 과도한 요청으로 발생했을 가능성이 높습니다. 그러나 악성으로 인식될 수 있는 요청을 전송하는 경우 더 긴 기간 동안 차단될 수 있습니다.

한도를 초과하면 계정, API 키 또는 IP 주소가 제한되나요?

하드 리밋의 경우 분당 총 요청 비중 한도(현재 1,200번)를 초과하면 IP가 차단됩니다. 주문 한도(현재 10초당 50번, 24시간 동안 160,000번)는 계정에 따라 다릅니다. 주문 한도를 초과하는 경우 사용자는 웹사이트(또는 다른 애플리케이션)에서 새로운 주문을 생성할 수 없습니다.
머신 러닝 한도의 경우 계정에 제한이 적용됩니다. 사용자가 머신 러닝 시스템에 의해 제한을 받는 경우 [/sapi/v1/account/status] 엔드포인트 (당사의 API 문서에 명시)를 통해 이유와 기간을 확인할 수 있습니다.
웹 애플리케이션 방화벽 제한은 IP에만 적용됩니다. 일반적으로 WAF 금지는 5분 동안 지속됩니다. 그러나 서버가 사용자의 요청을 악성으로 해석하는 경우 연장될 수 있습니다.

한도를 초과하여 제한을 받았지만 코드를 수정했습니다. 차단을 일찍 해제해줄 수 있나요?

아니요. 차단이 끝날 때까지 기다려야 합니다.

API를 사용할 때 HTTP 403 오류가 발생합니다. 이유가 무엇인가요?

WAF (웹 애플리케이션 방화벽) 규칙을 위반했습니다. 대부분의 경우 속도 제한을 위반하거나 악의적인 요청을 전송하여 발생합니다(이 문서의 한도 부분에 설명되어 있음). 일반적으로 이러한 차단은 5분 동안 지속됩니다.

웹소켓(WebSocket) 연결이 끊어지는 이유는 무엇인가요?

활성화된 웹소켓 연결은 3분 마다 핑을 수신합니다. 제대로 프레임된 퐁으로 응답하지 않으면 연결이 종료됩니다.
사용자 데이터 스트림의 경우 연결 유지가 60분 마다 한 번 이상 수신되지 않으면 수신 키가 만료됩니다. 이는 API 문서에도 자세히 설명되어 있습니다.

타사 서비스/랩퍼를 사용하고 있으며 작동하지 않습니다. 도움을 받을 수 있나요?

안타깝게도 타사 서비스 또는 도구에 지원을 제공하지 않습니다. 추가 지원이 필요한 경우 해당 서비스 및/또는 개발자에게 문의해주시기 바랍니다.
또한 타사 플랫폼에 바이낸스 API 키 및/또는 비밀 키를 입력하면 보안 위험을 야기할 수 있습니다. 귀하의 판단에 따라 해당 서비스를 사용해주시기 바랍니다.
또한 당사는 일반적인 프로그래밍 지원을 제공하지 않고 있습니다.

아무런 변경을 하지 않았는데 갑자기 오류가 발생합니다. 무슨 일이 생긴건가요?

안타깝게도 귀하가 개인적으로 구현한 부분에서 발생하는 문제에 대해서는 지원을 제공할수 없습니다. 타사 랩퍼/툴을 사용하는 경우 해당 지원/개발 팀에 지원을 요청해주시기 바랍니다.

비밀 키에 접근해야 하지만, "***"가 표시됩니다. 어떻게 되찾을 수 있나요? 

보안을 위해 비밀 키는 API 키가 생성될 때에만 표시되도록 설계되었습니다. 그 이후에는 항상 가려져 있습니다. 분실했거나 기록하지 않은 경우 새 API 키를 생성하고 새 키와 새 비밀 키를 사용해야 합니다.

한도 또는 전용 스트림/대역폭을 늘릴 수 있나요?

안타깝게도 현재 이 부분을 제공하고 있지 않습니다. 당사가 제공하는 한도 내에서 작업할 수 있어야 합니다. 

API 키가 사라졌습니다. 도와주세요!

API 키가 "사라지는 것"에 대해 가능한 설명은 두 가지 뿐입니다:
  1. 최근에 활동하지 않았고 2018년 3월 7일 이전에 API를 사용했다면 계정 보안을 위해 API 키가 삭제되었을 수 있습니다.
  2. 그렇지 않았다면, 계정을 비활성화한 경우 모든 활성 API 키가 삭제됩니다.
문제 없이 새 API 키를 생성할 수 있어야 합니다.

"오류 - 1021 (메시지: 이 요청의 타임스탬프가 recvWindow를 벗어납니다)"를 수신하고 있습니다. 어떻게 해결하나요?

일반적으로 이 오류는 서버 시간과 귀하의 시스템 시간이 동기화되지 않았을 경우에만 발생합니다. 시스템 시간을 동기화해야 할 수도 있습니다. 그러나 이 절차는 운영 체제에 따라 다릅니다.
윈도우의 경우 사용자 재량에 따라 "아토믹 시계"와 같은 도구를 사용할 수 있습니다. 리눅스와 맥 사용자는 커맨드 라인을 통해 "ntpupdate"로 동기화를 시도할 수 있습니다.
문제를 해결할 수 없는 경우 지연 시간과 관련된 문제(네트워크 문제)일 수 있으며 recvWindow를 조정해야 할 수도 있습니다.

새로운 API 기능을 요청할 수 있나요?

문서에 요청한 기능이 보이지 않는다면 해당 기능을 제공하지 않을 가능성이 높습니다. 기능을 제안하고 싶다면 제안과 함께 지원 티켓을 제출해주시면 검토하도록 하겠습니다.

API에 문제가 있다고 생각합니다. 어떻게 보고하나요?

귀하가 구현한 것이 아닌 시스템에 문제가 있다고 생각되면 텔레그램 API 채팅에 문의하여 주장을 뒷받침할 수 있는 증거를 제공하면 조사하도록 하겠습니다. 당사는 모호한 메시지는 타당한 문제 제기로 받아들이지 않습니다. 또한 이 그룹은 공식 프로그래밍 지원을 위한 그룹이 아닙니다. 이는 바이낸스 API 사용자를 위한 커뮤니티 그룹입니다.