Gemini API를 시작하는 방법?

Gemini API를 통해 개발자는 안전한 실시간 상호 작용을 위해 HMAC-SHA384 인증을 사용하여 REST 및 WebSocket을 통해 거래 및 시장 데이터에 안전하게 액세스 할 수 있습니다.

2025/08/05 12:35

Gemini API와 그 목적을 이해합니다

Gemini API 는 Cryptocurrency Exchange Gemini가 제공하는 강력한 인터페이스로 개발자가 거래, 계정 및 시장 데이터와 프로그래밍 방식으로 상호 작용할 수 있도록합니다. 이 API는 REST 및 WebSocket 프로토콜을 모두 지원하여 사용자가 실시간 시장 데이터를 검색하고 거래를 배치하고 주문 관리 및 계정 잔액을 모니터링 할 수 있습니다. 구현하기 전에 API는 HTTP 요청, JSON 형식 및 HMAC-SHA384와 같은 인증 메커니즘에 대한 경험이있는 개발자를 위해 설계되어 있음을 이해하는 것이 필수적입니다. 주요 사용 사례에는 알고리즘 거래 봇, 포트폴리오 추적 대시 보드 및 자동화 된 시장 분석 도구가 포함됩니다.

안전한 액세스를 보장하기 위해 Gemini는 Gemini 웹 포털을 통해 생성되는 API 키 및 비밀 키를 사용해야합니다. 이러한 자격 증명은 각 요청에 서명하는 데 사용되므로 공인 사용자 만 교환에서 조치를 실행할 수 있습니다. API는 샌드 박스 및 생산 환경을 모두 지원하므로 개발자가 실제 자금을 위험에 빠뜨리지 않고 통합을 테스트 할 수 있습니다.

Gemini 계정 생성 및 API 키 생성

Gemini API를 사용하기 전에 Gemini 플랫폼에 등록 된 계정이 있어야합니다. 공식 웹 사이트로 이동하여 필요한 경우 신원 확인을 포함하여 등록 절차를 완료하십시오. 로그인하면 계정 설정 섹션에 액세스하고 메뉴에서 API를 선택하십시오. 여기서는 새로운 API 키를 생성하는 프로세스가 시작됩니다.

키를 생성 할 때 여러 설정을 구성하라는 메시지가 표시됩니다.

• API 키 이름을 선택하여 목적을 식별하는 데 도움이됩니다.
• 거래 권한을 선택하십시오 (예 :보기 전용, 주문, 주문 취소)
• 인출 가능 여부 결정 (대부분의 사용 사례에 권장되지 않음)
• 특정 IP 주소에 대한 액세스를 제한하여 보안을 향상시키기 위해 IP 제한을 지정하십시오.

선택을 확인한 후 Gemini는 공개 API 키 와 개인 비밀 키를 생성합니다. 개인 키는 한 번만 표시되므로 암호화 된 환경에 안전하게 복사하여 저장하십시오. 이 키를 잃어 버리려면 이전 쌍을 무효화하는 새로운 키를 생성해야합니다.

개발 환경 설정

Gemini API로 코딩을 시작하려면 필요한 도구로 지역 개발 환경을 설정하십시오. HTTP 요청 및 암호화 기능을 지원하는 프로그래밍 언어를 설치하십시오. Python은 단순성과 풍부한 라이브러리 생태계로 인해 인기있는 선택입니다. PIP를 사용하여 필요한 패키지를 설치하십시오.

• 요청 : HTTP 호출을위한
• HMAC 및 HASHLIB : 요청 서명을 생성합니다
• JSON : API 응답을 구문 분석합니다

전용 프로젝트 폴더를 작성하고 구성 파일 (예 : config.py )을 초기화하여 API 키를 안전하게 저장하십시오. 기본 스크립트에서는 하드 코드 자격 증명을 절대 절대하지 않습니다. 대신 환경 변수 또는 안전한 구성 관리 시스템을 사용하십시오.

구성 설정 예제 :

 import os
 API_KEY = os.getenv('GEMINI_API_KEY')
 API_SECRET = os.getenv('GEMINI_API_SECRET').encode()

이러한 환경 변수를 쉘에 설정하거나 Python-Dotenv 와 같은 패키지로 .env 파일을 사용하십시오. 이 관행은 실수로 민감한 데이터를 노출시키는 위험을 최소화합니다.

HMAC-SHA384로 요청 인증

Gemini API에 대한 모든 인증 요청에는 HMAC-SHA384를 사용하여 생성 된 디지털 서명이 포함되어야합니다. 이 서명은 개인 비밀 키와 요청 세부 정보가 포함 된 JSON 페이로드를 사용하여 작성됩니다. 프로세스에는 몇 가지 정확한 단계가 포함됩니다.

• 다음 필드로 JSON 객체를 구성하십시오.

  • 요청 : API 엔드 포인트 경로 (예 : /v1/balances )
  • NONCE : 독특하고 증분 정수 (일반적으로 밀리 초의 현재 타임 스탬프)
  • 기호 (해당되는 경우) : 거래 쌍 (예 : 'btcusd')

• JSON 페이로드를 ASCII로 인코딩하십시오

• 비밀 키를 사용하여 HMAC-SHA384 해시를 생성하십시오

• 결과 서명을 Base64 형식으로 인코딩하십시오

HTTP 요청에 다음 헤더를 포함시킵니다.

• 내용 유형 : 응용 프로그램/JSON
• 컨텐츠 길이 : 페이로드의 길이
• X-Gemini-Apikey : 공개 API 키
• x-gemini-payload : Base64에 인코딩 된 JSON 페이로드
• X-Gemini-Signature : Base64- 인코딩 된 HMAC 서명

이 정확한 형식을 따르지 않으면 인증 오류가 발생합니다. /v1/balances 같은 간단한 엔드 포인트로 서명 로직을 테스트하여 정확성을 확인하십시오.

첫 번째 API 요청을 실행합니다

인증이 구성되면 첫 번째 API 호출을 할 수 있습니다. 아래는 Python을 사용하여 계정 잔액을 검색하는 예입니다.

• 필수 라이브러리 가져 오기 :

   import requests
   import json
   import hmac
   import time

• 엔드 포인트 및 헤더 정의 :

   url = 'https://api.gemini.com/v1/balances'
   nonce = int(time.time() * 1000)
   payload = {'request': '/v1/balances', 'nonce': nonce}
   encoded_payload = json.dumps(payload).encode()
   b64_payload = base64.b64encode(encoded_payload).decode()
   signature = hmac.new(API_SECRET, b64_payload.encode(), hashlib.sha384).hexdigest()

• 헤더 설정 및 요청 보내기 :

   headers = { 'Content-Type': 'text/plain', 'Content-Length': '0', 'X-GEMINI-APIKEY': API_KEY, 'X-GEMINI-PAYLOAD': b64_payload, 'X-GEMINI-SIGNATURE': signature

  }
  응답 = requests.post (URL, 헤더 = 헤더)
  print (response.json ())

성공적인 응답은 귀하의 계정의 모든 자산 잔액을 나열하는 JSON 배열을 반환합니다. HTTP 상태 코드 및 오류 메시지를 검사하여 잘못된 서명 또는 요율 제한과 같은 문제를 해결하십시오.

실시간 데이터에 WebSocket 피드 사용

실시간 시장 데이터의 경우 Gemini API는 wss://api.gemini.com/v1/marketdata/SYMBOL 에서 WebSocket 스트림을 제공합니다. 상징을 거래 쌍 (예 : btcusd )으로 교체하십시오. 이 피드는 가격 업데이트, 주문서 변경 및 최소한의 대기 시간으로 거래 실행을 제공합니다.

연결하려면 :

• Python에서 WebSocket-Client 와 같은 WebSocket 클라이언트 라이브러리를 사용하십시오
• JSON 메시지를 사용하여 채널을 구독하십시오.

   {
   'type': 'subscribe',
   'subscriptions': [{'name': 'l2', 'symbols': ['btcusd']}]
   }

• 콜백 함수에서 들어오는 메시지를 처리하여 입찰을 처리/업데이트를 요청합니다.

WebSocket 피드는 실시간 대시 보드 또는 고주파 거래 전략을 구축하는 데 이상적입니다. 연결 시간 초과를 염두에두고 신뢰성을 위해 재 연결 로직을 구현하십시오.

자주 묻는 질문

손상된 경우 쌍둥이 자리 API 키를 어떻게 재설정합니까?

Gemini 계정에 로그인하고 API 설정 페이지로 이동하여 손상된 키를 찾은 다음 Revoke를 클릭하십시오. 새 키 쌍을 즉시 생성하고 응용 프로그램의 구성을 업데이트하십시오. 이전 키는 취소시 영구적으로 무효화됩니다.

거래 권한없이 Gemini API를 사용할 수 있습니까?

예. 키 생성 중에 권한 아래에서만 보기를 선택하십시오. 이를 통해 주문 배치 또는 인출을 활성화하지 않고 균형 점검 및 시장 데이터 액세스를 가능하게하여 응용 프로그램 모니터링을위한 보안을 향상시킵니다.

Gemini API는 어떤 비율 제한을 집행합니까?

API는 요청 유형에 따라 속도 제한을 부과합니다. 공개 엔드 포인트 (예 : 가격 데이터)는 더 높은 빈도를 허용하는 반면 개인 엔드 포인트는 초당 약 10 개의 요청 으로 제한됩니다. 한계를 초과하면 HTTP 429 응답이 발생합니다. 코드에서 지연 또는 지수 백 오프를 구현하여 준수를 유지하십시오.

샌드 박스 환경이 생산과 동일합니까?

샌드 박스는 기본 URL https://api.sandbox.gemini.com 으로 생산 엔드 포인트를 반영합니다. 테스트 펀드와 시뮬레이션 된 시장 데이터를 사용하여 주문 배치, 취소 및 균형 추적을 재무 위험없이 전체 테스트 할 수 있습니다. 코드가 환경을 원활하게 전환 할 수 있는지 확인하십시오.