코인베이스 선물을위한 API 키를 만드는 방법은 무엇입니까?

안전한 프로그램 거래 액세스를 위해 적절한 권한, 암호 및 IP 화이트리스트로 코인베이스 선물 API 키를 생성하십시오.

2025/07/22 20:28

코인베이스 선물 API 키 이해

Coinbase 선물의 API 키를 사용하면 선물 거래 계정과 프로그래밍 방식으로 상호 작용할 수 있습니다. 여기에는 주문 배치, 잔액 확인 및 시장 데이터 검색이 포함됩니다. Spot Trading API와 달리 선물 API는 특정 권한이 필요하며 Coinbase 계정의 올바른 섹션에서 생성되어야합니다. 각 API 키는 귀하의 계정에 연결되어 있으며 비밀번호처럼 취급해야합니다. 타협하면 자금 및 거래 능력에 대한 무단 액세스 권한을 부여 할 수 있습니다.

API 관리 섹션으로 탐색

시작하려면 [pro.coinbase.com] (https://pro.coinbase.com)의 Coinbase 계정에 로그인하십시오. 오른쪽 상단 코너의 프로필 아이콘 위로 가져 가서 드롭 다운에서 '설정'을 선택하십시오. 왼쪽 탐색 메뉴에서 'API'를 클릭하십시오. API 관리 대시 보드로 이동합니다. 미래 거래를 활성화 한 검증 및 안전한 Coinbase Pro 계정을 사용하고 있는지 확인하십시오. 선물을 사용할 수 없음을 나타내는 배너가있는 경우 신원 확인을 완료하고 선물 액세스를 별도로 신청해야합니다.

새 API 키 생성

API 섹션에 한 번 :

• Blue 'New API 키' 버튼을 클릭하십시오
• 'API 키 이름'아래에서 'Futures Bot'또는 'Trading Script'와 같은 설명 레이블을 입력하십시오.
• '선물 거래' 라는 상자를 확인하십시오 - 이것은 선물 기능에 필수적입니다.
• 계정 잔액 및 위치를 검색하려는 키를 원한다면 선택적으로 '보기'를 활성화하십시오.
• 신청서가 주문을 배치하거나 취소 해야하는 한 '거래'를 선택하지 않음
• 강력한 암호 설정 - 모든 API 요청을 인증해야합니다.
• 2FA (SMS 또는 Authenticator 앱)를 사용하여 신원 확인
  

  패스 프레이즈 나 API 비밀을 다른 사람과 공유하지 마십시오. 이러한 자격 증명은 요청에 서명하는 데 사용되며 손실되면 복구 할 수 없습니다.

  IP 화이트리스트 구성 (권장) 구성

  
  추가 보안의 경우 API 액세스를 특정 IP 주소로 제한합니다.
• 'IP Whitelist'섹션에서 'IP 주소 추가'를 클릭하십시오.
• API를 사용하는 기계 또는 서버의 공개 IP를 입력하십시오.
• 신뢰할 수있는 각각의 IP에 대해 반복하십시오
• 구성을 저장하십시오
  

  IP 화이트리스트가 없으면 API 키를 어느 위치에서나 사용할 수있어 위험이 증가 할 수 있습니다. 로컬로 테스트하거나 동적 IP를 사용하는 경우 생산 사용을 위해 정적 IP가있는 VPS를 사용하는 것을 고려하십시오.

  CURL로 API 키를 테스트합니다

  
  생성 후 API 키, 비밀 및 암호를 볼 수 있습니다. 이것들을 단단히 보관하십시오 - 한 번만 표시됩니다. 키 작품을 확인하려면 :
• 터미널 또는 명령 프롬프트를 엽니 다
• 다음 컬 명령을 실행하십시오.
  

   curl -H 'CB-ACCESS-KEY: YOUR_API_KEY' \
   -H 'CB-ACCESS-SIGN: $(echo -n 'GET/accounts' | openssl dgst -sha256 -hmac YOUR_API_SECRET)' \
   -H 'CB-ACCESS-TIMESTAMP: $(date +%s)' \
   -H 'CB-ACCESS-PASSPHRASE: YOUR_PASSPHRASE' \
   https://api.pro.coinbase.com/futures/accounts

  YOUR_API_KEY , YOUR_API_SECRET 및 YOUR_PASSPHRASE 실제 값으로 바꾸십시오. 성공적인 응답은 선물 계정에 대한 JSON 데이터를 반환합니다. 401 오류는 필드 중 하나가 부정확하거나 키에 선물 권한이 부족하다는 것을 의미합니다.

  일반적인 오해 및 수정

• '권한 거부'오류가 발생하면 키에 '선물 거래'가 활성화되어 있는지 확인하십시오.
• 타임 스탬프가 서버 시간과 너무 멀리있는 경우 NTP를 사용하여 시스템 클럭을 동기화하십시오.
• 서명이 유효하지 않은 경우 HMAC-SHA256 인코딩 프로세스를 다시 확인하십시오.
• IP가 차단되면 화이트리스트 IPS가 요청 소스와 일치하는지 확인하십시오.
  

  라이브 거래 시스템에서 사용하기 전에 API 키를 샌드 박스 환경에서 항상 테스트하십시오. 주요 구성의 실수는 주문 실패 또는 무단 액세스로 이어질 수 있습니다.

  ---

  자주 묻는 질문

  지점과 선물 거래에 동일한 API 키를 사용할 수 있습니까?
  
  예,하지만 주요 창출 중에 '스팟 트레이딩'과 '선물 거래'를 모두 활성화하는 경우에만. 각 권한은 명시 적으로 확인해야합니다. 스팟 권한 만있는 키는 선물 엔드 포인트에 액세스 할 때 실패합니다.

  API 비밀을 잃으면 어떻게해야합니까?
  
  잃어버린 API 비밀을 복구 할 수 없습니다. 손상된 키를 삭제하고 새 키를 생성해야합니다. 이전 키를 사용하는 모든 응용 프로그램은 새 자격 증명으로 업데이트 될 때까지 작동이 중단됩니다.

  내 API 요청이 올바른 자격 증명으로도 403 오류를 반환하는 이유는 무엇입니까?
  
  403 오류는 종종 키에 필요한 권한이 부족하다는 것을 의미합니다. '선물 거래'가 활성화되어 있는지 확인하십시오. 또한 IP 화이트 리스트링이 활성화되어 있는지, 현재 IP가 허용되는지 확인하십시오.

  환경 변수에 API 키를 저장하는 것이 안전합니까?
  
  예, 환경 변수에 열쇠를 저장하는 것은 개발의 표준 관행입니다. 스크립트에서 하드 코딩을하지 않거나 버전 제어에 커밋하지 마십시오. 적절한 파일 권한이있는 .env 파일과 같은 도구를 사용하여 보호합니다.