Gemini API에서 사용할 수있는 WebSocket 피드는 무엇입니까?

Gemini의 WebSocket API는 LOW LATENCY 거래 앱에 대한 JSON 메시지와 함께`wss : // api.gemini.com/v1/marketdata`를 통해 주문서 업데이트, 거래 및 티커와 같은 실시간 시장 데이터를 제공합니다.

2025/08/03 19:43

Gemini WebSocket 피드의 개요

Gemini API는 WebSocket 피드를 통해 실시간 시장 데이터를 제공하여 개발자와 거래자가 주문서 변경, 거래 및 시세 정보에 대한 즉각적인 업데이트를받을 수 있습니다. 이러한 피드는 알고리즘 거래 시스템, 시장 모니터링 도구 및 가격 경고 서비스와 같은 저도 데이터가 필요한 응용 프로그램에 필수적입니다. 폴링이 필요한 REST API와 달리 WebSocket 연결은 지속적인 양방향 통신 채널을 유지하여 오버 헤드를 줄이고 적시에 데이터를 전달합니다.

Gemini의 기본 WebSocket 엔드 포인트는 wss://api.gemini.com/v1/marketdata 입니다. 이 엔드 포인트는 공개 시장 데이터를 스트리밍하며 기본 액세스를위한 인증이 필요하지 않습니다. 모든 메시지는 JSON 형식 으로 전달되므로 다양한 프로그래밍 환경에 쉽게 구문 분석하고 통합 할 수 있습니다.

사용 가능한 WebSocket 채널

Gemini는 여러 WebSocket 채널을 지원하는데, 각각의 특정 유형의 시장 데이터를 제공하도록 설계되었습니다. 사용 가능한 채널에는 다음이 포함됩니다.

• 시장 데이터 피드 : 입찰, 요청 및 거래 실행을 포함하여 주문서의 실시간 업데이트를 스트리밍합니다.
• 하트 비트 메시지 : 연결이 활성화되고 데이터가 전송되고 있음을 나타내는주기 신호.
• 시세 업데이트 : 마지막 가격, 볼륨 및 입찰/요청 스프레드를 포함한 요약 수준의 가격 정보.
• 거래 실행 알림 : 거래소에서 완료된 거래에 대한 실시간보고.

WebSocket 연결을 설정할 때 원하는 기호를 지정하여 각 채널에 액세스 할 수 있습니다. 예를 들어, BTCUSD 또는 ETHUSD 에 연결하면 해당 거래 쌍에 특정한 데이터가 스트리밍됩니다.

Gemini WebSocket에 연결

Gemini WebSocket 피드에 연결하려면 다음을 수행하십시오.

• Python의 websocket-client 또는 Node.js의 ws 같은 지원되는 라이브러리를 사용하여 WebSocket 클라이언트를 엽니 다.
• 끝점에 연결하십시오 : wss://api.gemini.com/v1/marketdata .
• 쿼리 문자열의 symbols 매개 변수를 사용하여 트레이딩 쌍을 지정하십시오. 예를 들어 : wss://api.gemini.com/v1/marketdata/BTCUSD .
• 들어오는 메시지를 듣고 그에 따라 JSON 페이로드를 처리하십시오.

다음은 Python을 사용하는 예입니다.

 import websocket
 import json def on_message (ws, message) :


data = json.loads(message) print(data) def on_error (WS, 오류) : data = json.loads(message) print(data)
 
def on_close (ws, close_status_code, close_msg) : print(f'Error: {error}')
 
def on_open (WS) : print('Connection closed')
 
연결을 설정하십시오 print('Connected to Gemini WebSocket')
 ws = websocket.websocketapp ( 'wss : //api.gemini.com/v1/marketdata/btcusd',
 
 on_open=on_open, on_message=on_message, on_error=on_error, on_close=on_close) ws.run_forever () on_open=on_open, on_message=on_message, on_error=on_error, on_close=on_close)

이 스크립트는 BTCUSD 시장 데이터 피드에 연결하고 모든 들어오는 메시지를 인쇄합니다. 수신 된 데이터에는 이벤트 유형 , 기호 , 입찰 , 요청 및 거래가 포함됩니다.

WebSocket 메시지 구조를 이해합니다

Gemini WebSocket에서받은 각 메시지에는 표준화 된 JSON 구조가 포함되어 있습니다. 주요 필드는 다음과 같습니다.

• 유형 : update , heartbeat 또는 initial 과 같은 메시지 범주를 나타냅니다.
• EventID : 이벤트의 고유 식별자입니다.
• 타임 스탬프 : 이벤트가 발생했을 때 밀리 초의 UNIX 타임 스탬프.
• 기호 : 거래 쌍 (예 : BTCUSD ).
• 입찰 및 요청 : 가격 수준 및 해당 수량의 배열.
• 변경 사항 : 주문서에 대한 업데이트 목록, 가격, 금액 및 측면 ( buy 또는 sell )을 표시합니다.

예제 업데이트 메시지 :

 {
 'type': 'update',
 'eventId': 123456789,
 'timestamp': 1717000000000,
 'symbol': 'BTCUSD',
 'changes': [ ['buy', '65000.00', '0.5'], ['sell', '65001.50', '0.3']

]]
}

이 예에서 변경 배열은 0.5 BTC에 대해 65000.00 에서 새로운 입찰을 표시하고 65001.50 에서 0.3 BTC에 대한 새로운 ASK를 보여줍니다. 고객은 주문서의 현지 사본을 유지하고 현재 시장 상태를 반영하기 위해 이러한 변경 사항을 점차적으로 적용해야합니다.

주문 장부 동기화

WebSocket 업데이트의 점진적 특성으로 인해 주문서를 올바르게 초기화하는 것이 중요합니다. Gemini는 연결시 초기 스냅 샷을 보낸 다음 업데이트 메시지를 보냅니다. 정확성을 보장하기 위해 :

• 초기 입찰을 저장하고 첫 번째 메시지를 받으면 묻습니다.
• 각 후속 changes 사항을 로컬 주문서에 적용하십시오.
• 입찰을 내림차순으로 정렬하고 가격별로 오름차순으로 묻습니다.
• 수량이 0에 도달하면 가격 수준을 제거하십시오.

예를 들어 ['buy', '65000.00', '0.0'] 와 같은 변경을 처리 할 때 65000.00 의 입찰가를 주문서에서 제거해야합니다. 이 논리를 유지하면 응용 프로그램이 시장의 실제 상태를 반영 할 수 있습니다.

요금 제한 및 연결 관리

Gemini는 지속적인 스트리밍을 위해 설계되었으므로 WebSocket 연결에 엄격한 속도 제한을 부과하지 않습니다. 그러나 비 활동 또는 과도한 메시지 백 로그로 인해 연결이 종료 될 수 있습니다. 신뢰성을 유지하려면 :

• 지수 백 오프로 재 연결 로직을 구현하십시오.
• Connection closed 이벤트를 모니터링하고 세션을 다시 시작하십시오.
• 하트 비트 메커니즘을 사용하여 연결 건강을 확인하십시오.
• 클라이언트를 압도하지 않도록 동시 구독 수를 제한하십시오.

각 연결은 하나의 기호 만 구독 할 수 있습니다. 여러 쌍을 모니터링하려면 각각에 대한 별도의 WebSocket 인스턴스를 설정하십시오.

자주 묻는 질문

여러 거래 쌍을 동시에 구독하려면 어떻게해야합니까?

여러 기호에 대한 데이터를 받으려면 각 거래 쌍에 대해 별도의 WebSocket 연결을 엽니 다. 예를 들어, BTCUSD 에는 하나의 연결과 ETHUSD 에 다른 연결을 사용하십시오. 단일 소켓에는 여러 기호에 대한 브로드 캐스트 모드가 없습니다.

변경 배열에서 '0'수량은 무엇을 의미합니까?

변경 필드에서 '0.0' 의 양은 해당 가격 수준이 주문서에서 제거되었음을 나타냅니다. 예를 들어, ['sell', '65001.50', '0.0'] 는 65001.50 의 요청이 완전히 채워 지거나 취소되었음을 의미합니다.

WebSocket 피드에 액세스하는 데 인증이 필요합니까?

아니요, Public Market Data WebSocket 피드에는 API 키나 인증이 필요하지 않습니다. 모든 사용자가 액세스 할 수 있습니다. 그러나 개인 피드 (예 : 주문 상태의 경우)에는 Gemini Exchange API를 통해 인증 된 WebSocket 연결이 필요합니다.

하트 비트 메시지가 얼마나 자주 보내십니까?

하트 비트 메시지는 약 5 초 마다 전송됩니다. 여기에는 type: 'heartbeat' 필드가 포함되어 있으며 연결이 활성화되어 있고 메시지가 실시간으로 전달되는지 확인하는 데 사용할 수 있습니다.