Binance Futures API의 일반적인 오류는 무엇입니까?

Binance Futures API 구조 이해

Binance Futures API는 거래자가 거래 전략을 자동화하고 직책을 관리하며 시장 데이터를 프로그래밍 방식으로 검색 할 수있는 강력한 도구입니다. HTTPS 및 WebSocket 프로토콜을 통해 작동하므로 RESTFUL 요청과 실시간 데이터 스트리밍이 모두 가능합니다. 문제 해결 오류를 해결하기 전에 API가 어떻게 구성되는지 이해하는 것이 필수적입니다. 각 엔드 포인트는 API 키 및 비밀 키를 사용하여 적절한 인증이 필요하며 HMAC SHA-256을 사용하여 요청에 서명했습니다. REST 엔드 포인트의 기본 URL은 https://fapi.binance.com 이며 모든 요청에는 X-MBX-APIKEY 와 같은 헤더가 포함되어야합니다. 이 구조를 따르지 않으면 일반적인 인증 및 연결 문제가 발생합니다.

인증 관련 오류

사용자가 발생하는 가장 빈번한 문제 중 하나는 유효하지 않은 API 키 또는 서명 오류 입니다. API 키가 잘못되었거나 만료되었거나 요청 헤더에 제대로 첨부되지 않은 경우에 발생합니다. 추가 공간이없는 'X-MBX-Apikey'헤더에 API 키가 추가되어 있는지 확인하십시오. 서명 오류는 일반적으로 요청 매개 변수가 올바르게 직렬화되지 않았거나 타임 스탬프가 동기화되지 않은 경우에 발생합니다. 시그니처는 비밀 키 와 요청 매개 변수를 특정 형식의 queryString + '×tamp=' + currentTimestamp 사용하여 생성해야합니다. 타임 스탬프는 서버 시간의 5000 밀리 초 이내에 있어야합니다. 이를 피하려면 /fapi/v1/time endpoint를 사용하여 서버 시간을 가져 와서 로컬 클록을 그에 따라 동기화하십시오.

요율 제한 및 요청 조절기

Binance는 시스템 안정성을 유지하기 위해 엄격한 속도 제한을 시행합니다. 이 제한을 초과하면 HTTP 429 (너무 많은 요청) 또는 418 (IP 금지) 응답이 발생합니다. 속도 제한은 IP 주소 와 사용자 계정을 기반으로하며 다른 엔드 포인트에 대한 임계 값이 다릅니다. 예를 들어, 대부분의 REST 엔드 포인트는 IP 당 분당 2400 개의 요청을 허용합니다. 이러한 한계에 부딪히지 않도록 :

• API 호출 사이의 요청 대기 또는 지연 메커니즘 을 구현하십시오
• 지원되는 경우 배치 요청을 사용하십시오
• 응답으로 X-MBX-USED-WEIGHT 헤더를 통해 사용량을 모니터링하십시오
• 중복 통화를 줄이기 위해 /fapi/v1/exchangeInfo 와 같은 엔드 포인트에 대한 캐시 응답

IP가 금지되면 요청을 재개하기 전에 재사용 대기 기간 (일반적으로 2 분)을 기다리십시오. 반복적 인 휴식 전화 대신 실시간 데이터에 WebSocket 스트림을 사용하여 공격적인 폴링을 피하십시오.

잘못된 매개 변수 및 기호 불일치

많은 오류가 잘못되거나 잘못된 매개 변수를 보내는 데 비롯됩니다. 일반적인 문제는 다음과 같습니다.

• 선물 기호 대신 스팟 거래 상징 사용 (예 : BTCUSDT vs BTCUSDT_210625 )
• 지원되지 않은 엔드 포인트에서 LIMIT_MAKER 와 같은 잘못된 주문 유형 으로 주문 제출
• 기호 필터를 충족하지 않는 가격 또는 수량 값 보내기

각 선물 계약 /fapi/v1/exchangeInfo 엔드 포인트에 정의 된 특정 필터가 있습니다. 여기에는 다음이 포함됩니다.

• price_filter : 최소/최대 가격 및 진드기 크기를 정의합니다
• lot_size : 최소/최대 수량 및 스텝 크기를 설정합니다
• Min_notional : 주문 값이 최소 요구 사항을 충족시킵니다

예를 들어, 진드기 크기가 0.1 인 경우 35000.05 의 가격을 보내는 것이 거부됩니다. 요청을 보내기 전에 항상 기호의 필터 규칙에 대해 매개 변수를 검증하십시오.

WebSocket 연결 고장

Binance 선물에 대한 WebSocket 연결 (예 : wss://fstream.binance.com )은 몇 가지 이유로 인해 실패 할 수 있습니다. 가장 일반적인 것은 잘못된 스트림 이름 형식 입니다. 스트림은 패턴 stream?streams=streamName , 구독 메시지는 올바르게 구성되어야합니다. 사용자 데이터 스트림의 경우 먼저 /fapi/v1/listenKey post endpoint를 통해 듣기 키를 얻어야합니다. 이 ListenKey는 WebSocket URL에 포함되어야합니다.

 wss://fstream.binance.com/ws/YOUR_LISTENKEY

또한 60 분 후에 청취 키가 만료됩니다. 연결을 유지하려면 풋 엔드 포인트를 사용하여 30 분마다 듣기를 갱신하십시오 . 이를 수행하지 않으면 사용자 데이터 업데이트가 연결이 끊어지고 손실됩니다. 네트워크 중단의 경우 항상 지수 백 오프로 재 연결 로직을 구현하십시오.

주문 실행 및 응답 처리

올바른 설정을하더라도 응답이 올바르게 처리되지 않으면 주문 배치가 조용히 실패 할 수 있습니다. Binance Futures API는 코드, MSG 및 OrderID 필드를 포함하는 JSON 응답을 반환합니다. 성공적인 주문은 code: 200 및 유효한 orderId . 그러나 일반적인 함정에는 다음이 포함됩니다.

• '주문이 포함될 수있는 msg 필드를 무시하는 것은 현재 가격에 너무 가까운 스톱 마켓 주문에 대해 즉시 트리거됩니다.
• 'ReduceOnly' 제약 조건을 잘못 해석 - 순서가 위치를 증가 시키면 reduceOnly=true 가 거부됩니다.
• 주문 상태 라이프 사이클을 설명하지 않음 - 주문은 NEW , PARTIALLY_FILLED 또는 REJECTED 될 수 있습니다.

항상 전체 응답을 구문 분석하고 에지 케이스를 처리하십시오. 예를 들어, code: -2010 이 msg: 'Account has insufficient balance' . 사용 가능한 여백을 확인하고 주문 크기를 적절하게 조정하십시오.

자주 묻는 질문

'이 요청에 대한 서명이 유효하지 않음'오류를 어떻게 수정합니까? 이 오류는 일반적으로 HMAC SHA-256 서명이 잘못 생성되었음을 의미합니다. 비밀 키를 사용하고, 쿼리 문자열을 알파벳 순서로 연결하고, 타임 스탬프를 추가하고, 결과를 소문자로 인코딩하는지 확인하십시오. 서명 문자열에 추가 문자 나 공간이 포함되어 있지 않다는 것을 두 번 확인하십시오.

미래 주문을 할 때 400 오류가 발생하는 이유는 무엇입니까? 400 오류는 종종 잘못된 요청을 나타냅니다. 해당 symbol , side , type , quantity 및 timestamp 모두 존재하고 올바르게 형식화되어 있는지 확인하십시오. symbol 선물 시장에 존재하고 quantity lot_size 필터 요구 사항을 충족하는지 확인하십시오.

'듣기 키가 찾지 못한'WebSocket 오류의 원인은 무엇입니까? 이것은 듣기가 만료되었거나 만들어지지 않았을 때 발생합니다. 연결하기 전에 새 제품을 생성하려면 /fapi/v1/listenKey 에 게시 해야합니다. 키가 만료되면 (60 분 후), 풋 요청을 동일한 엔드 포인트로 보내서 확장하십시오. 응용 프로그램 논리에서 항상 주요 갱신을 처리하십시오.

지점과 선물 거래에 동일한 API 키를 사용할 수 있습니까? 예, 단일 API 키는 스팟 및 선물 엔드 포인트 모두에 액세스 할 수 있습니다. 그러나 키에 Binance 계정 설정에서 선물 거래 권한이 활성화되어 있는지 확인하십시오. API 관리로 이동하여 키를 선택한 다음 '선물 활성화'가 토글되어 있는지 확인하십시오. 이 없으면 모든 선물 요청은 권한 오류로 거부됩니다.