Coinbase API를 사용하여 계약을 거래하려면 어떻게해야합니까?

Coinbase Advanced Trade API는 미래 나 영구 계약이 아닌 실제 암호화를 구축하고 판매하는 스팟 거래 만 지원합니다.

2025/08/12 17:14

코인베이스 API 및 그 기능을 이해합니다

Coinbase API는 개발자와 거래자가 Coinbase의 금융 서비스와 프로그래밍 방식으로 상호 작용할 수있는 강력한 도구입니다. Coinbase는 스팟 거래, 지갑 관리 및 가격 데이터 검색을 포함한 광범위한 기능을 제공하지만 Coinbase가 현재 표준 API를 통해 거래 선물 또는 영구 계약을 지원하지 않는다는 것을 명확히하는 것이 중요합니다. Coinbase Advanced Trade API의 주요 초점은 현물 거래 에 관한 것입니다. 이는 현재 시장 가격으로 실제 암호 화폐를 구매하고 판매하는 것을 의미합니다.

그럼에도 불구하고 많은 사용자가 코인베이스를 Coinbase 파생 상품 또는 Coinbase International Exchange 와 혼동하는데, 이는 선물 거래를 제공하는 별도의 단체입니다. 이 플랫폼은 다른 규제 프레임 워크 및 API에 따라 작동합니다. 미래 나 옵션과 같은 계약을 거래하는 것이 목표라면 올바른 코인베이스 계통 서비스를 사용하는지 확인해야합니다. 현재 Coinbase Advanced Trade API는 한계 주문, 시장 주문 및 암호 화폐 쌍의 중지 주문을 포함한 현물 시장 운영 만 지원합니다.

API 사용을 시작하려면 먼저 Coinbase Advanced Trade 에 계정을 만들고 API 키를 생성해야합니다. 이 키는 신청서에 거래 계좌에 대한 액세스 권한을 부여하므로 신중하게 권한을 관리해야합니다. 키를 생성 할 때 'View', 'Trade'또는 'Transfer'와 같은 특정 역할을 할당 할 수 있습니다. 거래 목적으로 '거래'권한이 활성화되어 있는지 확인하십시오.

Coinbase API 키 설정

거래를하기 전에 API 자격 증명을 사용하여 요청을 인증해야합니다. 키를 생성하고 구성하는 방법은 다음과 같습니다.

• Coinbase Advanced Trade 계정에 로그인하십시오
• 설정> API 로 이동하십시오
• + 새 API 키를 클릭하십시오
• 적절한 권한 선택 : '보기'및 '무역'
• 키 이름을 입력하십시오 (예 : 'Trading Bot')
• 2 요인 인증 완료 (2FA)
• 생성 된 API 키 , 비밀 및 암호를 복사하십시오.

이 자격 증명을 단단히 저장하십시오. 비밀 과 암호는 한 번만 표시되며 손실되면 검색 할 수 없습니다. 클라이언트 측 코드 또는 공개 리포지토리에 노출하지 마십시오.

키가 있으면 응용 프로그램에 키를 통합하기 시작할 수 있습니다. API는 HMAC-SHA256 인증을 사용합니다. 각 요청에는 다음 헤더가 포함되어야합니다.

• CB-ACCESS-KEY : API 키
• CB-ACCESS-SIGN : 메시지의 HMAC 서명
• CB-ACCESS-TIMESTAMP : 요청의 Unix 타임 스탬프
• CB-ACCESS-PASSPHRASE : 설정 한 암호화

시그니처는 비밀을 사용하여 타임 스탬프, HTTP 방법, 요청 경로 및 신체 (있는 경우)의 연결을 해시하여 생성됩니다.

Coinbase API를 통해 스팟 거래

계약 거래는 지원되지 않지만 Advanced Trade API를 사용하여 지점 거래를 실행할 수 있습니다. 이러한 거래에는 현재 시장 가격으로 암호 화폐를 즉시 교환하는 것이 포함됩니다. 주문을하기 위해 '순서 작성' 엔드 포인트를 사용합니다.

다음은 BTC-USD에 대한 제한 구매 주문을 하는 예입니다.

• HTTP 방법 : POST
• 끝점 : https://api.coinbase.com/api/v3/brokerage/orders
• 요청 본문 :

   {
   'client_order_id': 'unique-id-123',
   'product_id': 'BTC-USD',
   'side': 'BUY',
   'order_configuration': {
   'limit_limit_gtc': { 'base_size': '0.001', 'limit_price': '30000.00'

  }
  }
  }

주요 매개 변수는 다음과 같습니다.

• client_order_id : 주문을위한 고유 식별자입니다
• product_id : 거래 쌍 (예 : BTC-USD)
• side : '구매' 또는 '판매'
• base_size : 거래 할 암호 화폐의 양
• limit_price : 지불하고자하는 최대 가격

귀하의 계정에 매도에 대한 BUY 또는 BTC 잔액 에 대한 USD 잔액이 충분한 지 확인하십시오. 주문은 시장 가용성에 따라 실행되며 부분적으로 채워질 수 있습니다.

순서 상태를 확인하려면 응답에서 반환 된 order_id 와 함께 'Order get'endpoint 를 사용하십시오. 또한 '목록 주문' 엔드 포인트를 사용하여 모든 주문을 상태로 나열 할 수도 있습니다 (Open, CLOMED, CANCELD).

시장 데이터 검색 및 모니터링 가격

성공적인 거래에는 최신 시장 정보가 필요합니다. Coinbase API는 실시간 및 과거 데이터를 검색하기위한 몇 가지 엔드 포인트를 제공합니다.

최신 입찰을 받고 제품에 대한 가격을 요청하려면 :

• 엔드 포인트 : GET /api/v3/brokerage/product/book?product_id=BTC-USD&limit=1
• 응답은 다음과 같습니다.
  • 최고 입찰에 대한 price 및 size
  • 최고 요청의 price 과 size

촛대 데이터 (기술 분석에 사용)의 경우 사용하십시오.

• 엔드 포인트 : GET /api/v3/brokerage/market/products/BTC-USD/candles
• 쿼리 매개 변수 : type=1_MINUTE , start=1700000000 , end=1700003600

이것은 지정된 시간 범위 및 간격에 대해 OHLC (개방, 높음, 낮음, 가까운) 값을 반환합니다.

여러 레벨로 주문서를 검색 할 수도 있습니다.

• limit=50 상위 50 개 입찰을 제공하고 묻습니다
• 이 데이터를 사용하여 시장 깊이를 분석하고 가격 변동을 예상하십시오.

이러한 엔드 포인트를 정기적으로 폴링하면 라이브 트레이딩 대시 보드를 구축하거나 의사 결정 논리를 자동화 할 수 있습니다.

처리 오류 및 요율 제한

Coinbase API는 학대를 방지하기 위해 요율 제한을 시행합니다. 거래 엔드 포인트의 경우 한도는 일반적으로 API 키 당 초당 10 개의 요청 입니다. 이를 초과하면 429 Too Many Requests 응답이 발생합니다. 이것을 피하기 위해 :

• 재시험 논리에서 지수 백 오프를 구현하십시오
• 가능하면 응답을 캐시합니다
• 자주 폴링 대신 실시간 데이터에 WebSockets를 사용하십시오

일반적인 오류 코드에는 다음이 포함됩니다.

• 401 Unauthorized : API 자격 증명이 잘못되거나 누락되었습니다
• 403 Forbidden : 불충분 한 권한
• 404 Not Found : 유효하지 않은 제품 ID 또는 주문 ID
• 400 Bad Request : 기형 JSON 또는 유효하지 않은 매개 변수

항상 입력을 검증하고 오류를 처리하십시오. 예를 들어, 주문을하기 전에 ETH-USD 와 같은 제품 ID가 지원되는지 확인하십시오.

자주 묻는 질문

API를 사용하여 코인베이스에서 선물을 거래 할 수 있습니까?

아니요, Coinbase Advanced Trade API는 선물 또는 영구 계약을 지원하지 않습니다. 스팟 거래 만 제한됩니다. 미래 거래는 별도의 API 인터페이스를 가질 수있는 코인베이스 파생 상품 에서 사용할 수 있습니다.

Coinbase와 Coinbase Advanced Trade API의 차이점은 무엇입니까?
Coinbase.com은 Fiat와 함께 암호화를 구매하기위한 소비자를위한 플랫폼입니다. Advanced Trade API 는 자동 거래를위한 전문가 급 인터페이스로, 스팟 시장, 주문서 및 가격 데이터에 대한 프로그래밍 방식 액세스를 제공합니다.

API를 통해 열린 주문을 어떻게 취소합니까?

DELETE /api/v3/brokerage/orders/{order_id} endpoint를 사용하십시오. {order_id} 실제 주문 식별자로 바꾸십시오. 응답은 주문이 이미 채워 지거나 유효하지 않은 경우 취소를 확인하거나 오류를 반환합니다.

자동 거래에 API 키를 사용하는 것이 안전합니까?

예, 모범 사례를 따르는 경우. 강력하고 독특한 암호를 사용하고, 필요한 것만 권한을 제한하고, 암호화 된 환경 에 키를 저장하고, 스크립트에서 하드 코딩하지 마십시오. 사용 가능한 경우 IP 화이트리스트 사용을 고려하십시오.