선물 거래에 Coinbase API를 사용하는 방법은 무엇입니까?

API를 통해 Coinbase에서 미래를 교환하려면 "거래"권한이있는 키를 만들고 고급 무역 API를 사용하며 순서에 레버리지 및 여백 유형을 포함시켜 청산 위험을 모니터링하십시오. (154 자)

2025/07/27 01:01

선물 거래를위한 코인베이스 API 이해

Coinbase API를 통해 개발자와 거래자는 선물 계약을 포함한 Coinbase의 금융 상품과 프로그래밍 방식으로 상호 작용할 수 있습니다. 스팟 거래와 달리, 선물에는 구매자 또는 판매자가 미리 정해진 미래 날짜와 가격으로 자산을 거래 할 수있는 계약이 포함됩니다. 선물에 API를 사용하려면 Coinbase가 Coinbase Advanced Trade API를 통해 REST 및 WebSocket 프로토콜을 모두 지원하는 기능을 제공한다는 것을 먼저 이해해야합니다. 거래를 시작하기 전에 올바른 권한을 가진 API 키를 생성해야합니다. 특히 미래의 '무역' 범위. 이 없으면 요청에 따라 403 오류가 반환됩니다.

선물 액세스를위한 API 키 설정

시작하려면 Coinbase 계정에 로그인하여 API 설정 섹션으로 이동하십시오. "새 API 키 만들기"를 클릭하고 "Futuresbot"과 같은 이름을 할당하십시오. 권한 패널에서 선택 :

• 보다
• 거래
• 옮기다
  추가 보안을 위해 IP 화이트리스트를 활성화하십시오. 일단 저장되면 Coinbase는 API 키, 비밀 및 암호를 표시합니다. 공개 리포지토리 또는 클라이언트 측 코드에 이들을 단단히 저장하십시오. API 키는 CB-ACCESS-KEY 헤더, CB-ACCESS-PASSPHRASE 의 암호를 통과하고 CB-ACCESS-TIMESTAMP 의 타임 스탬프에서 전달되어야합니다. 비밀 키는 HMAC SHA256을 사용하여 각 요청에 서명하는 데 사용됩니다.
  

  REST API를 통해 선물 주문을 배치합니다

  
  선물 명령을 내리려면 https://api.coinbase.com/api/v3/brokerage/orders 에 게시물 요청을 보내십시오. 시체에는 다음을 포함해야합니다.
• client_order_id : 생성하는 고유 식별자입니다
• product_id : BTC-USD-FUTURE 와 같은 형식
• side : 'BUY' 또는 'SELL'
• order_type : 가격 관리에 'LIMIT' 사용하십시오
• price : 문자열 형식, 예를 들어 '50000.00'
• size : 문자열로서의 수량, 예를 들어 '0.01'
• leverage : 1x에서 5x 사이의 문자열 (예 : '3' 로 설정
• margin_type : 선물을 위해 'ISOLATED' 해야합니다
  헤더에는 인증 토큰이 포함되어야합니다. 성공하면 응답이 order_id 반환합니다. 요청이 실패하면 message 필드를 점검하십시오. 예를 들어 마진이 충분하지 않은 마진이 'Insufficient margin available' .
  

  API 엔드 포인트로 위치 및 마진을 관리합니다

  
  주문을 한 후 엔드 포인트를 사용하여 위치를 모니터링하십시오 GET https://api.coinbase.com/api/v3/brokerage/positions . 이것은 다음을 포함하여 활성 선물 위치를 반환합니다.
• size : 현재 위치 크기
• entry_price : USD의 평균 항목
• unrealized_pnl : 부동 이익/손실
• liquidation_price : 포지션이 자동 클로즈하는 가격
  열린 위치에서 레버리지를 조정하려면 POST /api/v3/brokerage/positions/leverage 사용하십시오. 시체에는 다음을 포함해야합니다.
• product_id : 열린 위치와 동일합니다
• leverage : 문자열로서의 새로운 레버리지 (예 : '2' )
  귀하의 위치가 청산 가격에 가까워지면 레버리지를 줄이면 강제 폐쇄를 방지 할 수 있습니다.
  

  미래 주문을 취소하고 폐쇄합니다

  
  채워지지 않은 주문을 취소하려면 /api/v3/brokerage/orders/{order_id} 에 삭제 요청을 보내십시오. {order_id} 초기 순서 응답에서 ID로 바꾸십시오. 위치를 마감하려면 반대쪽과 일치하는 크기로 새 주문을 제출하십시오. 예를 들어, 0.01 BTC의 긴 위치를 유지하는 경우 size: '0.01' 의 SELL 주문을 배치하십시오. API는 원 클릭 위치 폐쇄를 지원하지 않습니다. 이는 상대 주문을 통해 수동으로 수행해야합니다. 부분 폐쇄 또는 과도한 판매를 피하기 위해 닫기 전에 위치 엔드 포인트를 통해 위치 크기를 항상 확인하십시오.
  

  처리 오류 및 요율 제한

  
  Coinbase API는 속도 제한을 시행합니다. API 키 당 초당 10 개의 요청 . 이를 초과하면 429 오류가 반환됩니다. 코드에서 지수 백 오프를 구현합니다. 코드는 각각 고장 후 1 초, 2, 4 등을 구현하십시오. 일반적인 오류는 다음과 같습니다.
• 400 Bad Request : JSON 서식 확인 - 모든 필수 필드 확정이 문자열입니다.
• 401 Unauthorized : 타임 스탬프 및 서명 생성을 확인하십시오
• 403 Forbidden : API 키에 '거래'범위가 있음을 확인합니다
• 422 Unprocessable Entity : 유효하지 않은 Product_ID 또는 1 ~ 5 배 외부 레버리지
  디버그 문제에 모든 응답을 기록하십시오. Postman 또는 Curl과 같은 도구를 사용하여 실시간 거래 봇에 통합하기 전에 엔드 포인트를 테스트하십시오.
  

  자주 묻는 질문

  지점과 선물 거래에 동일한 API 키를 사용할 수 있습니까?
  
  예,하지만 키에 '보기'와 '무역' 권한이 모두있는 경우에만 가능합니다. 선물 별 엔드 포인트는 여전히 Spot의 ETH-USD 와 다른 올바른 Product_ID 형식 (예 : ETH-USD-FUTURE )이 필요합니다.

  내 선물 포지션이 청산되면 어떻게됩니까?
  
  마크 가격이 청산 수준에 도달하면 API가 자동으로 위치를 닫습니다. API를 통해 알림을받지 않으며 위치 엔드 포인트에서 Monitor liquidation_price 외부로 설정하고 외부에서 알림을 설정합니다.

  TestNet은 선물 API 개발에 사용할 수 있습니까?
  
  아니요, Coinbase는 선물 Testnet을 제공하지 않습니다. 배치하기 전에 샌드 박스 계정에 소량의 실제 자본을 사용하거나 로컬로 주문 로직을 시뮬레이션하십시오.

  선물 주문에 필요한 마진을 어떻게 계산합니까?
  
  필수 마진 = (가격 × 크기) / 레버리지. 3 배의 레버리지로 $ 50,000의 0.01 BTC 주문 : (50000 × 0.01) / 3 = $ 166.67 . 귀하의 계정에 최소한이 금액이 USD 또는 Stablecoins로 보유하고 있는지 확인하십시오.