코인베이스 API 연동 방법 — CDP 포털에서 View 권한 키 만들어 사토시노트에 넣기 (2026)

가이드 · 2026년 10월 27일 · Satoshi Note

다른 언어: English

미국·유럽에 살면서 코인베이스를 쓰고, 다른 거래소나 지갑의 코인과 한 표에서 보고 싶다면 코인베이스 API 키를 한 번 만들어 사토시노트에 넣으면 됩니다. 다만 코인베이스는 다른 거래소와 키 만드는 자리가 다릅니다. 거래소 설정 화면이 아니라 Coinbase Developer Platform(CDP) 포털에서 만들고, 키도 두 줄짜리 문자열이 아니라 API key name과 Private key(여러 줄) 한 쌍입니다. 이 글은 그 순서를 처음부터 끝까지 따라갑니다. 걸리는 시간은 5분 안팎이고, 비용은 없습니다.

먼저 두 가지만 짚고 갑니다. 하나, 여기서 만드는 키는 ‘View’ 권한만 켠 읽기 전용 키입니다. Trade·Transfer는 켜지 않으니, 이 키로는 코인을 팔거나 다른 곳으로 보낼 수 없습니다. 사토시노트는 저장하기 전에 키를 시험해 보고, 거래나 전송 권한이 켜진 키는 받지 않습니다(읽기 전용 키란?). 둘, 코인베이스는 한국·일본 거주자에게 거래를 제공하지 않습니다. 이 연동은 미국·유럽 등 지원 국가의 계정에서 쓰는 것입니다.

한눈에 보기

코인베이스 연동은 세 단계입니다. portal.cdp.coinbase.com에 코인베이스 계정으로 로그인해 API Keys › Secret API Keys › ‘Create API key’에서 권한은 ‘View’만, 키 종류는 ‘ECDSA’로 만들고, 화면에 뜬 ‘API key name’과 ‘Private key’를 사토시노트 설정 › 자산 연동 › 글로벌 › 코인베이스에 각각 넣고, 저장 전 “계정 확인”을 통과하면 끝입니다.
막히기 쉬운 곳: 옛 Coinbase Pro/Exchange의 Key+Secret+Passphrase(HMAC) 키는 받지 않음, Ed25519가 아니라 ECDSA를 골라야 함, Private key는 한 번만 보임(내려받은 JSON의 privateKey 값을 그대로 붙여도 됨), 한국·일본 거주자는 쓸 수 없음.
사토시노트(토큰포스트가 운영하는 무료 암호화폐 자산관리 앱, 거래소 18곳 읽기 전용 API 연동)에서는 코인베이스의 Advanced Trade 체결과 앱 간편 매수·매도·코인 입출금이 다른 거래소와 한 표에 모입니다.

시작 전에 알아둘 것 세 가지

키는 CDP 포털에서 만듭니다. coinbase.com 설정 화면이 아니라 portal.cdp.coinbase.com입니다. 코인베이스 계정으로 그대로 로그인되고, 따로 가입하거나 돈을 낼 필요는 없습니다.
옛 방식 키는 쓸 수 없습니다. 예전 Coinbase Pro/Exchange에서 쓰던 API Key + Secret + Passphrase(HMAC) 키는 사토시노트가 받지 않습니다. 그런 키가 있어도 CDP 포털에서 새로 만들어야 합니다. 키 종류(Signature algorithm)는 ECDSA를 골라야 하고, Ed25519 키는 쓸 수 없습니다.
Private key는 만든 순간 한 번만 보입니다. 화면에 여러 줄로 뜨는 -----BEGIN EC PRIVATE KEY-----로 시작하는 문자열이 그것입니다. 창을 닫으면 다시 볼 수 없습니다. 코인베이스가 같이 내려 주는 JSON 파일을 저장해 두면 그 안의 privateKey 값을 나중에 그대로 붙여 넣을 수 있습니다.

1단계 — CDP 포털에서 Secret API Keys로 가기

PC 브라우저로 portal.cdp.coinbase.com에 코인베이스 계정으로 로그인한 뒤, 왼쪽 메뉴 ‘API Keys’ → ‘Secret API Keys’ 탭 → ‘Create API key’로 들어갑니다. 사토시노트 앱 안 거래소 연동 가이드에서 코인베이스를 고르면 같은 경로와 체크할 권한이 한 화면에 나오니 그 화면을 옆에 띄워 두고 따라가면 편합니다.

2단계 — 권한은 View만, 키 종류는 ECDSA

‘Create API key’ 화면에서 정할 것은 셋입니다.

권한은 ‘View’만 체크합니다. Trade·Transfer는 끕니다. View 권한이면 거래 내역·잔고 조회가 다 됩니다.
키 종류(Signature algorithm)는 ‘ECDSA’를 고릅니다. Ed25519를 고르면 사토시노트에서 쓸 수 없습니다.
IP 허용 목록(IP allowlist)은 선택 사항입니다. 걸고 싶다면 사토시노트 가이드 화면의 “IP 복사하기” 버튼으로 복사한 서버 IP를 넣습니다. 안 넣어도 조회는 됩니다.

만들기를 누르면 화면에 API key name(organizations/…/apiKeys/… 꼴 한 줄)과 Private key(-----BEGIN EC PRIVATE KEY-----로 시작하는 여러 줄)가 뜹니다.

3단계 — API key name과 Private key 복사

두 조각을 각각 복사합니다. Private key는 줄바꿈까지 포함해 전부 복사해야 합니다. 첫 줄 -----BEGIN EC PRIVATE KEY-----부터 마지막 줄 -----END EC PRIVATE KEY-----까지입니다. 내려받은 JSON 파일이 있다면 그 안의 privateKey 값을 그대로 붙여도 됩니다(줄바꿈이 \n으로 적혀 있어도 사토시노트가 알아서 읽습니다).

4단계 — 사토시노트에 붙여넣기

사토시노트 앱(satoshinote.io)에 로그인한 뒤 설정 → 자산 연동으로 가서 글로벌 탭에서 코인베이스를 고르고, API key name과 Private key를 각각의 칸에 붙여넣습니다. 몇 초 안에 계정 확인 → 최근 체결 조회 → 투자 기록 정리 세 단계가 지나가고, 종목별 보유 수량·평균 단가·평가손익이 한 표에 채워집니다. 키는 사토시노트 서버에 암호화해 저장되고, 거래소에 조회 요청을 보낼 때만 씁니다.

연동이 끝나면 매일 아침 같은 숫자를 메일 보고서로도 받을 수 있습니다.

가져오는 범위 — Advanced Trade 체결과 앱의 간편 매매·입출금

코인베이스 연동에서 미리 알아 둘 것은 가져오는 범위입니다. 다른 거래소보다 넓은 편입니다.

Advanced Trade 체결(호가창에서 사고판 것)과 코인베이스 앱의 간편 매수·매도를 둘 다 가져옵니다.
코인 입출금(다른 지갑·거래소와 주고받은 것)도 가져옵니다. 들어온 코인은 코인베이스가 적어 둔 그 시각 평가액으로 매수, 나간 코인은 매도로 기록합니다. 앱 안에서 코인을 다른 코인으로 바꾼 전환은 나간 쪽 매도·들어온 쪽 매수로 적습니다.
이자·스테이킹 보상과 달러 등 법정화폐 입출금은 기록하지 않습니다.
체결가는 달러·유로·파운드라, 체결 날짜의 은행 환율(유럽중앙은행 고시)로 자동 환산해 원화로 저장합니다. USDC·USDT로 사고판 것은 달러와 같게 봅니다.
ETH/BTC처럼 코인끼리 바꾼 체결은 원가를 알 수 없어 건너뜁니다.

자주 막히는 곳

“계정 확인” 단계에서 “키가 틀립니다”라고 나와요.

세 가지를 보세요. ① Private key를 첫 줄부터 마지막 줄까지 전부 붙여넣었는지 ② 키 종류를 ECDSA로 만들었는지(Ed25519면 새로 만들어야 합니다) ③ 옛 Coinbase Pro/Exchange 키를 넣은 건 아닌지. CDP 포털의 키 목록에서 어떤 키인지 확인할 수 있습니다.

“View 권한이 없습니다”라고 나와요.

키를 만들 때 View를 빼고 다른 권한만 켠 경우입니다. CDP 포털에서 그 키를 지우고 View만 켠 새 키를 만들어 주세요. Trade·Transfer가 켜진 키는 사토시노트가 저장 전 시험 단계에서 거절합니다.

한국에서 쓸 수 있나요?

코인베이스가 한국·일본 거주자에게 거래를 제공하지 않아, 그 계정 자체가 없습니다. 미국·유럽 등 지원 국가에서 코인베이스 계정을 쓰는 분을 위한 연동입니다.

자주 묻는 질문

왜 거래소 화면이 아니라 CDP 포털에서 키를 만드나요?

코인베이스가 개인용 API 키 발급을 Coinbase Developer Platform으로 옮겼기 때문입니다. 옛 Pro/Exchange 방식의 HMAC 키는 더 이상 새로 만들 수 없고, 사토시노트도 받지 않습니다. CDP 포털은 코인베이스 계정으로 바로 로그인되며 비용은 없습니다.

다른 곳에서 받아 온 코인의 원가는 어떻게 잡히나요?

코인베이스가 입금 기록에 적어 둔 그 시각 평가액을 매수가로 씁니다. 원래 다른 거래소에서 더 싸게 산 코인이라면 그 원가와는 다르니, 정확히 맞추고 싶으면 캘린더에서 그 기록을 고치면 됩니다. 코인베이스 안에서 사고판 것은 체결가 그대로 잡힙니다.

이 키로 누가 내 코인을 출금할 수 있나요?

없습니다. View 권한만 켠 키는 잔고와 거래 내역을 볼 수만 있고, 주문이나 전송은 코인베이스 쪽에서 막힙니다. 사토시노트도 Trade·Transfer 권한이 켜진 키는 저장하지 않습니다.

다른 거래소도 같이 쓴다면

바이낸스·OKX·바이비트처럼 다른 거래소도 쓴다면 같은 방식으로 키를 하나씩 넣으면 한 표에 합쳐집니다. 거래소별 순서는 바이낸스 API 연동 방법, OKX API 연동 방법, 바이비트 API 연동 방법에 따로 적었고, 18개 거래소 전부의 그림 가이드는 앱 안 거래소 연동 가이드에 있습니다.

사토시노트는 무료이며 읽기 전용 API 키만 받습니다. 주소는 satoshinote.io입니다.