Coinbase 고급 거래 API를 사용하는 방법은 무엇입니까? (봇 개발)

인증 및 API 키 설정

1. Coinbase Advanced Trade 대시보드로 이동하여 사용자 메뉴에서 API 설정을 선택합니다.

2. API 키 생성을 클릭하고 권한을 신중하게 선택하세요. 거래 , 보기 및 전송 범위는 봇 기능에 필수적입니다.

3. 설명이 포함된 이름을 할당하고, 고정 서버에서 실행 중인 경우 IP 주소를 제한하고 생성을 확인합니다.

4. API 키, 비밀 및 암호 문구를 암호화된 환경 변수 시스템에 저장합니다. 절대 소스 파일에 하드코딩하지 마세요.

5. HTTP 메서드, 요청 경로 및 본문을 사용하여 타임스탬프가 지정된 메시지를 구성한 다음 암호를 사용하여 HMAC-SHA256으로 서명하여 서명 생성을 확인합니다.

주문 수명주기 관리

1. POST /api/v3/brokerage/orders 를 통해 product_id(예: BTC-USD), 측면(구매/판매), client_order_id 및 크기를 지정하여 지정가 주문을 제출합니다.

2. GTC 또는 GTT와 같은 time_in_force 값을 사용하여 주문 기간을 제어합니다. 봇은 오래된 배치를 피하기 위해 만료 시간이 60초인 GTT에 의존하는 경우가 많습니다.

3. DELETE /api/v3/brokerage/orders/{order_id}를 사용하여 대기 중인 주문을 취소하거나 필터와 함께 DELETE /api/v3/brokerage/orders를 사용하여 일괄 취소합니다.

4. 로컬 상태에 대해 실행된 채우기를 조정하기 위해 페이지 매김을 사용하여 GET /api/v3/brokerage/orders/historical 을 폴링합니다.

5. 상태 필드를 엄격하게 구문 분석합니다. open , done , 거부됨 및 보류 중에는 실행 논리에서 고유한 처리 경로가 필요합니다.

실시간 시장 데이터 통합

1. wss://ws-feed.exchange.coinbase.com 에서 WebSocket 피드에 연결하여 실시간 입찰/요청 업데이트를 위한 레벨2 또는 티커 채널을 구독하세요.

2. REST 호출에 사용된 것과 동일한 자격 증명에서 파생된 product_ids , 채널 및 서명이 포함된 JSON 구독 메시지를 보냅니다.

3. 누락된 메시지를 감지하기 위해 채널당 시퀀스 번호를 유지합니다. 간격이 허용 임계값을 초과하는 경우 삭제하고 다시 구독합니다.

4. 스프레드, 깊이 또는 변동성 지표를 계산하기 전에 들어오는 가격 및 크기 필드를 소수 유형으로 정규화합니다.

5. 하트비트 메시지를 사용하여 연결 활성 상태를 확인하고 간격이 30초를 초과하는 경우 재연결 논리를 트리거합니다.

오류 처리 및 속도 제한

1. HTTP 상태 코드: 429 신호 속도 제한 소진을 검사합니다. Retry-After 헤더를 존중하고 지수 백오프를 구현합니다.

2. 401을 자격 증명 무효화로 처리합니다. 로컬 변경 없이 반복되는 경우 키를 회전합니다.

3. 400개의 응답을 특정 유효성 검사 실패(필드 누락, 잘못된 product_id 또는 잘못된 타임스탬프)에 매핑하고 Invalid_client_order_id 와 같은 정확한 오류 코드를 기록합니다.

4. 500 시리즈 오류를 일시적인 인프라 문제로 포착합니다. 멱등성 키를 사용하여 나중에 재생하기 위해 실패한 요청을 대기열에 추가했습니다.

5. X-Request-ID 헤더에 반환된 모든 요청 ID를 기록하여 사건 해결 중에 로그를 Coinbase 지원 티켓과 연관시키십시오.

자주 묻는 질문

Q: 샌드박스 환경과 프로덕션 환경 모두에 동일한 API 키를 사용할 수 있습니까? 아니요. 샌드박스와 프로덕션에는 각각 고유한 기본 URL, 자격 증명 및 권한 범위가 있는 별도의 API 키 생성이 필요합니다.

Q: Coinbase Advanced Trade는 API를 통해 지정가 주문을 지원합니까? 예. stop_limit 로 설정된 order_type 과 함께 주문 페이로드에 stop 및 stop_price 매개변수를 사용하세요.

Q: 내 봇의 서명이 Coinbase의 기대와 일치하는지 어떻게 확인합니까? 서명을 단계별로 재현합니다. 타임스탬프 + 메서드 + request_path + 본문을 연결한 다음 base64로 디코딩된 비밀로 HMAC-SHA256을 계산합니다. 출력을 CB-ACCESS-SIGN 헤더 값과 비교합니다.

Q: 과거 주문 엔드포인트를 폴링할 수 있는 빈도에 제한이 있습니까? 예. /historical 엔드포인트는 표준 주문 엔드포인트보다 더 엄격한 속도 제한을 적용합니다. 일반적으로 API 키당 분당 요청 30개입니다.