거래 봇에 바이낸스 API를 사용하는 방법은 무엇입니까? (개발자 도구)

API 자격 증명 설정

1. 바이낸스 계정에 로그인하고 보안 아래 API 관리 섹션으로 이동하세요.

2. “API 생성”을 클릭하고 거래 범위에 따라 표준 API 또는 통합 거래 API 중에서 선택하세요.

3. 보안 강화를 위해 설명이 포함된 이름을 할당하고 IP 화이트리스트를 활성화합니다. 신뢰할 수 있는 서버만 요청을 시작할 수 있습니다.

4. 이메일과 2FA를 통해 생성을 확인한 후 API 키와 비밀 키를 모두 안전하게 저장하세요. 페이지 새로 고침 후에는 다시 검색할 수 없습니다.

5. 자격 증명이 손상된 경우 노출을 최소화하기 위해 "철회" 또는 "마진 전송"과 같은 사용하지 않는 권한을 비활성화합니다.

인증 흐름 이해

1. 모든 개인 끝점에는 비밀 키와 정식 요청 문자열을 사용하여 HMAC-SHA256 서명 생성이 필요합니다.

2. 타임스탬프 매개변수는 바이낸스 서버 시간의 1000ms 이내에 동기화되어야 합니다. 서명하기 전에 /api/v3/time 엔드포인트를 사용하여 정확한 서버 시간을 가져오세요.

3. X-MBX-APIKEY 헤더의 API 키와 함께 GET 요청의 경우 쿼리 문자열에 서명을 포함하고 POST 요청의 경우 요청 본문에 서명을 포함합니다.

4. Nonce 값은 엄격하게 증가하는 정수 또는 밀리초 타임스탬프여야 합니다. 값을 재사용하거나 건너뛰면 거부가 트리거됩니다.

5. IP 및 API 키별로 속도 제한이 적용됩니다. 이를 초과하면 Retry-After 헤더와 함께 HTTP 429가 반환됩니다. 봇에 지수 백오프 논리를 구현합니다.

현물 주문 작업 실행

1. POST /api/v3/order를 사용하여 기호, 측면, 유형, 수량 및 가격과 같은 정확한 매개변수를 사용하여 지정가, 시장, 손절매 또는 이익 실현 주문을 발주하세요.

2. 실제 실행 없이 주문 구조를 검증하려면 test=true 로 설정하여 테스트 모드를 활성화합니다. 이는 통합 테스트에 이상적입니다.

3. 채워진 수량, 평균 가격 및 현재 상태를 반환하는 clientOrderId 또는 orderId를 사용하여 GET /api/v3/order를 통해 실시간 주문 상태를 검색합니다.

4. DELETE /api/v3/order 를 사용하여 기호와 orderId 또는 origClientOrderId를 제공하여 보류 중인 주문을 취소합니다.

5. 기호 및 선택적 제한이 있는 GET /api/v3/myTrades를 사용하여 최근 거래 내역을 가져옵니다. 거래는 내림차순으로 반환됩니다.

계정 데이터 및 잔액 관리

1. GET /api/v3/account를 호출하여 현물 지갑 전체의 무료, 잠김 및 총 금액을 포함한 모든 자산 잔액을 검색합니다.

2. 구매/판매 로직을 시작하기 전에 잔액 배열을 확인하고 무료 > 0인지 확인하여 자산을 동적으로 필터링합니다.

3. 교차 또는 격리 마진 모드를 활용하는 경우 GET /sapi/v1/margin/account를 사용하여 마진 수준 변경 사항을 모니터링합니다.

4. updateTime 필드를 구문 분석하여 오래된 잔액 스냅샷을 감지합니다. 새로 고침 간격은 봇의 결정 대기 시간에 맞춰야 합니다.

5. myTrades 의 tradeId를 실행된 주문 ID와 연관시켜 주문 체결에 대한 잔액 업데이트를 교차 확인합니다.

자주 묻는 질문

Q: 여러 봇에서 동일한 API 키를 사용할 수 있습니까? A: 예, 하지만 위험 표면이 증가합니다. 하나의 봇이 손상되면 연결된 모든 작업이 노출됩니다. 최소한의 권한으로 봇당 전용 키를 선호합니다.

Q: 서명된 요청에 "잘못된 서명"이 반환되는 이유는 무엇입니까? A: 서명 생성 중 잘못된 문자열 연결, ±1000ms를 초과하는 시계 왜곡 또는 전송 전 서명 자체의 실수로 URL 인코딩으로 인해 가장 자주 발생합니다.

Q: 실시간 주문장 업데이트에 WebSocket 스트리밍이 지원됩니까? A: 예. 원시 L2 주문장 데이터를 보려면 wss://stream.binance.com:9443/ws/{symbol}@length 에 연결하거나 하나의 연결에서 여러 기호에 대해 결합된 스트림을 사용하세요.

Q: API 가동 중지 시간이나 503 응답을 어떻게 처리합니까? A: 회로 차단기 패턴을 구현합니다. 연속 실패를 추적하고, 구성 가능한 기간 동안 요청을 일시 중지하고, GET /api/v3/ping을 통해 상태 확인이 성공한 후에만 재개합니다.