Bitfinex API 거래 : 개발자를위한 최고의 가이드.

Bitfinex API 기본 사항 이해

1. BitFinex는 개발자가 거래 엔진, 계정 데이터 및 시장 정보와 상호 작용할 수 있도록 포괄적 인 휴식 및 WebSocket API를 제공합니다. API는 공개 및 개인 엔드 포인트를 모두 지원하여 실시간 시세 데이터, 주문서, 역사적 거래 및 개인 지갑 잔액에 대한 액세스를 가능하게합니다. 시작하려면 개발자는 읽기, 주문 배치 또는 자금 인출과 같은 적절한 권한으로 Bitfinex 계정에서 API 키를 생성해야합니다.

2. 나머지 API는 계정 정보를 가져 오거나 단일 주문을하는 것과 같은 일회성 요청에 이상적입니다. HTTPS에서 작동하고 데이터를 JSON 형식으로 반환합니다. 각 개인 요청은 HMAC-SHA384 암호화로 생성 된 API 키, 비밀 키 및 JWT (JSON Web Token)를 사용하여 인증해야합니다. 인증 프로세스는 사용자 별 데이터 및 트랜잭션 기능에 대한 안전한 액세스를 보장합니다.

3. WebSocket API는 라이브 가격 업데이트, 주문 실행 보고서 및 위치 변경을 포함하여 실시간 데이터 스트리밍에 선호됩니다. 지연 시간을 줄이고 고주파 거래 전략을 가능하게하는 지속적인 연결을 유지합니다. 개발자는 Ticker, Book, Raw Book 및 Candles와 같은 다양한 채널을 구독하여 지속적인 데이터 피드를받을 수 있습니다.

4. 시스템 안정성을 유지하기 위해 속도 제한이 적용됩니다. 공개 엔드 포인트는 분당 최대 90 개의 요청을 허용하는 반면 개인 엔드 포인트는 분당 50 개의 요청으로 제한됩니다. 이러한 제한을 초과하면 임시 IP 차단이 발생할 수 있습니다. 지수 백 오프 및 요청 대기열 메커니즘을 구현하면 속도 제약을 효과적으로 관리하는 데 도움이 될 수 있습니다.

Bitfinex는 BTC, ETH 및 USDT와 같은 Stablecoin과 같은 주요 암호 화폐를 포함하여 여러 거래 쌍을 지원합니다. 각 쌍은 가격과 금액에 대한 특정 정밀 수준을 가지고 있으며, 이는 주문을 구성 할 때 존중해야합니다. 개발자는 올바른 형식을 보장하기 위해 /Symbols Endpoint를 통해 기호 세부 사항을 검색해야합니다.

개발 환경 설정

1. HTTP 요청 및 WebSocket 연결을 지원하는 프로그래밍 언어를 선택하십시오. 인기있는 옵션에는 Python, JavaScript (node.js) 및 Go가 포함됩니다. Axios, WebSocket-Node 또는 CCXT와 같은 라이브러리는 인증 및 메시지 형식을 처리하여 API 통합을 단순화합니다.

2. PIP, NPM 또는 GO MOD와 같은 패키지 관리자를 사용하여 필요한 종속성을 설치하십시오. 예를 들어, Python에는 REST 및 WebSocket Communications를 처리하기 위해 요청 및 WebSocket-Client 라이브러리를 설치하십시오. 가상 환경을 사용하여 프로젝트 종속성을 분리하고 충돌을 피하십시오.

3. 환경 변수 또는 구성 파일 외부 버전 제어를 사용하여 API 자격 증명을 안전하게 저장하십시오. 소스 파일의 하드 코드 키는 없습니다. 개발 중에 민감한 데이터를 관리하기 위해 DOTENV와 같은 도구를 활용하십시오.

4. BTC/USD의 현재 시세를 검색하는 것과 같은 간단한 공개 요청을하여 API 연결을 테스트하십시오. 성공적인 응답은 네트워크 액세스 및 올바른 엔드 포인트 URL을 확인합니다. 테스트 중에 의도하지 않은 라이브 거래를 피하기 위해 사용 가능한 경우 샌드 박스 환경을 사용하십시오.

5. API 요청 및 응답을 모니터링하기위한 로깅 구현. 문제를 신속하게 진단하기 위해 타임 스탬프, 엔드 포인트 호출 및 오류 메시지 로그를 기록합니다. 로그를 정기적으로 회전시켜 과도한 디스크 사용을 방지합니다.

거래 실행 및 주문 관리

1. V2 주문 제출 엔드 포인트를 사용하여 시장, 제한, 정지 및 후행 중지 주문을 장소 장소. 각 순서에는 기호 (예 : TBTCUSD), 금액 (구매에 대해 양수, 판매에 대한 음수) 및 유형 (예 : 교환 한도)과 같은 매개 변수가 필요합니다. 거부를 피하기 위해 금액 정밀도가 기호의 구성과 일치하는지 확인하십시오.

2. WebSocket 알림 또는 정기적 인 휴식 폴링을 통한 주문 상태를 모니터링합니다. API는 부분 채우기, 전체 실행 또는 취소를 포함하여 실행 업데이트를 방출합니다. 'Orders'채널에 가입하면 알고리즘 전략에 중요한 실시간 업데이트를 제공합니다.

3. 주문 취소 엔드 포인트를 사용하여 개별적으로 또는 대량으로 주문을 취소합니다. 단일 취소에 대한 주문 ID를 제공하거나 질량 취소에 대한 기호 및 측면과 같은 필터를 사용하십시오. 주문이 제거되었다고 가정하기 전에 항상 취소 확인을 확인하십시오.

4. 위치 추적 로직을 조정하여 부분 채우기를 처리합니다. 일부 주문은 여러 거래에서 실행되므로 평균 충전 가격과 남은 수량을 결정하기 위해 집계가 필요합니다. Bitfinex 상태와 동기화 할 로컬 주문서 거울을 유지하십시오.

5. 자금이 불충분 한 일반적인 문제, 유효하지 않은 매개 변수 또는 네트워크 타임 아웃과 같은 일반적인 문제에 대한 오류 처리를 구현합니다. 수정 조치를 트리거하기 위해 10300 (키를 찾지 못한) 또는 10001 (유효하지 않은 순서)과 같은 오류 코드를 구문 분석합니다. 계단식 오류를 방지하기 위해 지연으로 과도 실패를 재 시도합니다.

자주 묻는 질문

개인 요청에 대한 유효한 API 서명을 어떻게 생성합니까? HMAC-SHA384를 사용하여 비밀 키와 함께 요청 경로, Nonce 및 신체 (있는 경우)로 구성된 연결된 페이로드에 서명하십시오. Base64에서 결과를 인코딩하여 'X-BFX-SIGNATURE'헤더에 포함시킵니다. Nonce는 재생 공격을 방지하기 위해 엄격하게 증가하는 정수 여야합니다.

WebSocket 피드의 RAW 책과 L2 책의 차이점은 무엇입니까? Raw Book (Book/R0)은 주문서의 모든 개별 주문을 보여 주어 전체 시장 깊이를 제공합니다. L2 Book (Book/P0)은 가격 수준별로 주문을 집계하여 데이터 볼륨을 줄입니다. 정밀도가 필요한 두피 전략에는 RAW Book을 사용하고 일반 시장 모니터링에는 L2를 사용하십시오.

Bitfinex API를 사용하여 선물과 여백 위치를 거래 할 수 있습니까? 예, API는 마진 거래 및 파생 상품을 지원합니다. 선물 (예 : FBTCF0)에 'f'로 접두사를 사용하고 레버리지 위치에 대한 마진 접미사가있는 't'를 사용하십시오. 계정이 충분한 마진을 가지고 있고 API 키에 거래 권한이 활성화되어 있는지 확인하십시오.

Bitfinex는 WebSocket을 통해 촛대 데이터를 얼마나 자주 업데이트합니까? 양초 업데이트는 각 간격의 끝에 게시됩니다. 지원되는 기간에는 1m, 5m, 15m, 30m, 1H, 3H, 6H 및 1D가 포함됩니다. WebSocket 스트림은 개방, 높음, 낮음, 가까이 및 볼륨 값을 포함하여 기간이 끝나면 새로운 촛불을 방출합니다.