SHARKRULE / 학습 가이드

Coinbase API 설정: 접근 권한과 보안

SharkRule의 영국 현물 출시를 위해 이용 자격이 있는 Coinbase Advanced 계정을 준비하세요. 지원 자산, 계정 접근, 권한 및 직접 승인하는 매수·매도 규칙을 확인하세요. 신규 실거래 활성화는 아직 열리지 않았으며 기존 연결과 복구 안내는 계속 제공됩니다.

SharkRule · 문서 확인일

먼저 연결 가능 여부를 확인하세요

이 가이드는 기존 연결의 수동 키 설정 안내를 보존합니다. 영국에서 신규 활성화를 열기 전에 신규 고객의 접근 방식에 대해 Coinbase의 확인이 필요합니다. 계정에서 제공하는 연결 방식만 이용하세요. 기술 검사에 통과한 키라고 해서 호스팅 서비스의 접근을 제공업체가 승인했다는 뜻은 아닙니다.

시작하기 전에: 본인 명의의 Coinbase 계정이 필요합니다. 계정이 없다면 해당 거래소에서 직접 가입하고, 거래소에서 요구하는 본인 인증과 계정 확인 절차를 마친 뒤 API 키를 만드세요. SharkRule은 사용자를 대신해 거래소 계정을 만들지 않습니다.

거래소 계정이 없어도 SharkRule 시뮬레이션을 체험할 수 있습니다.

초기 영국 서비스는 Coinbase Advanced 현물 거래를 위해 준비 중입니다. 자산 목록은 Bitcoin(BTC), Ethereum(ETH), Solana(SOL)이며, 고객의 Coinbase 계정에서 거래할 수 있는 경우 각각 GBP, USD 또는 USDC 거래쌍을 사용합니다. 자산, 금액, 진입, 청산 및 한도는 고객이 선택하고 승인합니다. 기존 매수 전용 전략에 자동 매도는 추가되지 않습니다.

현재 준비된 연결은 일반 소비자 계정의 기본 포트폴리오를 대상으로 합니다. View와 Trade를 허용하고 Transfer는 꺼야 합니다. Coinbase의 계정 자격 요건과 이용 가능한 상품 제한도 적용됩니다.

“비즈니스 인증” 화면이 나타나는 경우

Coinbase 포털에서는 여러 제품을 제공합니다. 수탁형 API의 비즈니스 인증 카드는 SharkRule에서 사용하는 개인 계정 API 키와 별개의 설정 절차입니다.

메뉴(휴대전화에서는 ☰)를 열고 API Keys → Secret API Keys를 선택하세요. 로그인한 뒤 키 페이지로 바로 가는 링크를 다시 열어도 됩니다. 개인 Coinbase 계정으로 진행하고 사용할 포트폴리오를 선택하세요. 표시된 이름이 Primary일 수도 있습니다.

Secret API Keys나 개인 포트폴리오를 사용할 수 없다면, 계속 진행하기 전에 Coinbase 고객 지원에 문의해 계정의 접근 권한을 확인하세요.

비밀 API 키 만들기

  1. Coinbase에 로그인한 뒤 공식 키 페이지를 여세요: https://portal.cdp.coinbase.com/api-keys/secret. API Keys에서 Secret API Keys를 선택하고 Create API key를 누르세요. 로그인 정보를 입력하기 전에 주소를 확인하세요.
  2. API key nickname에 SharkRule을 입력하면 나중에 키를 쉽게 구분할 수 있습니다. 다른 프로그램에서 사용하는 키와 별도로 만드세요.
  3. IP allowlist에는 로그인한 SharkRule 연결 화면에 표시된 서버 IP 주소만 입력하세요. Allow requests from any IP address는 선택하지 마세요. Coinbase에 예시로 표시된 192.168.1.0/24나 2001:db8::/32는 입력 형식을 보여 주는 자리표시자이며 SharkRule 주소가 아닙니다. 집이나 휴대전화의 IP를 사용하지 마세요. SharkRule에 서버 주소가 표시되지 않으면 설정이 활성화될 때까지 기다리세요.
  4. Advanced settings를 여세요. Coinbase App & Advanced Trade에서 사용할 포트폴리오를 선택하세요. 이름이 Primary일 수도 있습니다. View (read-only)와 Trade (execute trades on your behalf)를 선택하세요. Transfer (initiate transfer of funds)와 Receive (receive inbound payments)는 선택하지 마세요. Account → Non-custodial의 Export (export private key)와 Manage (modify policies)도 선택하지 마세요. SharkRule에는 이러한 추가 권한이 필요하지 않습니다.
  5. Signature algorithm에서 ECDSA (Legacy SDKs)를 선택하세요. Ed25519에 Recommended가 표시되어 있어도 SharkRule의 현재 연결에는 ECDSA / ES256이 필요합니다. Legacy SDKs라는 표시는 예전 Coinbase Pro 인증 정보를 사용하라는 뜻이 아닙니다.
  6. Create를 선택하고 Coinbase 보안 확인을 완료하세요. Save your API key 창의 API key ID와 Secret을 SharkRule의 해당 입력란에 복사하세요. API key ID는 organizations/…/apiKeys/…로 시작하는 전체 값이며, 닉네임 SharkRule은 구분을 위한 이름일 뿐입니다. Secret은 ECDSA 개인 키입니다. BEGIN 및 END 줄과 모든 줄바꿈을 그대로 유지하세요. 이 창은 한 번만 표시되므로 닫기 전에 두 값을 안전하게 보관하세요. Coinbase의 Download API key 기능을 이용할 수도 있습니다. 비밀 키를 스크린샷, 이메일, 고객 지원 메시지에 절대 포함하지 마세요.

Trade를 선택할 수 없다면 계속 진행하기 전에 Coinbase 고객 지원에 문의하여 계정과 포트폴리오의 접근 권한을 확인하세요. View 권한만 있는 키로는 거래를 자동화할 수 없으며, 다른 권한을 추가해도 해결되지 않습니다.

휴대전화에서 준비하기

휴대전화 브라우저에서 같은 CDP 주소를 여세요. 메뉴가 보이지 않으면 데스크톱 사이트 보기를 요청하거나 컴퓨터에서 마무리하세요. 이 절차는 Coinbase 앱의 자동 승인 버튼을 사용하는 방식이 아닙니다.

Secret을 복사할 때 개인 키의 줄바꿈과 BEGIN, END 줄을 그대로 유지하세요. 메신저로 보내거나 다른 사람이 접근할 수 있는 공유 클립보드를 사용하지 마세요. 키가 길어 화면에 일부만 보이더라도 전체 내용이 필요한 점을 확인하세요.

SharkRule에서 연결하고 검토하기

  1. SharkRule의 내 거래소에서 Coinbase를 선택하세요. Coinbase의 Save your API key 창에서 API key ID와 Secret의 전체 값을 복사해 해당 입력란에 붙여넣으세요. 확인 및 연결은 계정과 권한을 검증하며 주문을 전송하지 않습니다.
  2. 준비된 현물 거래쌍: BTC-GBP, BTC-USD, BTC-USDC, ETH-GBP, ETH-USD, ETH-USDC, SOL-GBP, SOL-USD, SOL-USDC. 각 거래쌍은 자격을 갖춘 계정에서 이용 가능하고 검토 단계에서 확인된 경우에만 사용할 수 있습니다. 연결한 포트폴리오에 해당 결제 통화를 준비하세요.
  3. 24시간 동안 가격을 관찰해 하락 시 한 번 구매하거나, 최소 한 시간 간격으로 정기 구매하도록 설정하세요. 수수료를 포함한 총예산, 구매당 최대 금액과 최대 100회의 정기 구매 한도를 정하세요.
  4. 정확한 거래쌍, 금액, 진입 조건, 매수 한도와 수수료를 검토하세요. 자동 매도를 원하면 검토 전에 직접 정한 상승 목표, 손절 비율 또는 둘 다 입력하세요. 매수만 하려면 두 항목을 비워 두세요. 각 조건은 해당 매수의 수수료 제외 평균 체결 가격을 기준으로 하며 이 전략으로 매수한 자산 수량에만 적용됩니다. 활성화가 가능할 때 시작하기 전에 표시된 규칙을 직접 승인하세요. 첫 정기 매수는 시작 후 실행될 수 있습니다.

자동 매도는 SharkRule이 조건을 확인하는 방식이며 Coinbase에 미리 걸어 둔 스톱 또는 브래킷 주문이 아닙니다. 서비스, 연결과 권한이 계속 이용 가능해야 합니다. 급격한 가격 변화, 유동성, 수수료, 거래소 최소 주문량과 장애로 매도가 이루어지지 않거나 소량이 남을 수 있습니다. 손절은 최대 손실을 보장하지 않습니다. 정기 매수는 승인한 횟수와 예산 한도를 따르며 매도 대금으로 한도가 늘어나지 않습니다.

주문은 지정가 또는 더 유리한 가격으로 전량 체결되거나 취소됩니다. 매수가 체결되지 않으면 추가 매수는 중단되지만, 이미 승인한 매도 조건은 계속 감시합니다. 매도 미체결이 확인되면 SharkRule은 최소 30초 간격으로 다시 시도할 수 있으며, 매수 건당 매도 시도는 총 3회까지입니다. 매수 한도에는 매수 시도 횟수가 포함됩니다. 결과가 불명확하면 다른 주문을 보내기 전에 확인합니다.

실제 수수료는 Coinbase가 결정합니다. 보고된 비용이 승인 금액을 초과하면 추가 구매를 중지하고 검토합니다. 수수료 한도는 거래소가 보장하는 금액이 아닙니다.

Coinbase를 SharkRule에 연결하기

연결 확인이 실패할 때

API key ID가 잘렸는지, Secret의 줄이 빠졌는지, ECDSA 대신 Ed25519를 선택했는지 확인하세요. 허용 IP, Transfer 권한, 선택한 포트폴리오도 확인해야 합니다. 키 자체가 유효해도 지원하지 않는 계정 유형이면 연결되지 않을 수 있습니다. 오류 내용을 읽기 전에 키를 계속 새로 만들지 마세요.

미체결 주문에 묶인 자금이나 다른 포트폴리오의 자산 때문에 사용 가능 잔액은 전체 자산 가치와 다를 수 있습니다. 최소 주문 수량과 수수료도 고려해야 합니다. 도움을 요청할 때는 비밀 정보를 제거한 오류 내용과 발생 시각만 보내세요.

거래소에서 접근 철회하기

연결을 해제하기 전에 SharkRule에서 전략을 중지하세요. 중지는 새 매수와 자동 매도를 멈추며 보유 자산을 매도하지 않습니다. 이미 보낸 주문은 체결될 수 있으므로 연결 해제 전에 결과를 확인해야 합니다. 불명확한 결과를 추측해 대체 주문을 보내지 마세요. 키가 노출되었다면 Coinbase에서 즉시 폐기하고 계정 활동을 확인하세요.

자주 묻는 질문

SharkRule에 Coinbase 계정 비밀번호를 입력해야 하나요?

아니요. 활성화된 연결의 CDP 키 입력 항목만 사용하세요. 계정 비밀번호, 인증 코드, 복구 문구는 SharkRule이나 고객 지원 대화에 입력하지 마세요.

한 번 누르면 자동으로 승인되나요?

아니요. 이 안내서는 API 키를 직접 준비하는 절차입니다. 다른 승인 방식이 제공되는지와 그 이용 가능 여부는 별도로 확인해야 합니다.

공식 자료와 출처

링크된 공식 문서를 바탕으로 AI의 도움을 받아 작성했습니다. 예시는 가상 상황이며 실제 계정 테스트나 수익률 비교를 수행하지 않았습니다.