빗썸 API 연동 방법 — API 2.0 읽기 전용 키 발급부터 사토시노트 등록까지 (2026)
가이드 · · Satoshi Note
다른 언어: English
빗썸과 업비트를 같이 쓰는 분이 많습니다. 두 거래소 잔고를 한 화면에서 보려면 빗썸 쪽에도 API 2.0 키를 하나 만들어 자산관리 앱에 넣으면 됩니다. 이 글은 그 순서를 처음부터 끝까지 따라갑니다. 5분 안팎, 비용은 없습니다.
여기서 만드는 키는 자산조회·주문조회만 켠 읽기 전용 키입니다. 출금·주문 권한은 켜지 않으니 이 키로는 코인을 팔거나 보낼 수 없습니다. 자세한 설명은 읽기 전용 키란? 출금은 못 하는 안전한 거래소 연동 방법에 있습니다.
시작 전에 알아둘 것 세 가지
- 새 키 발급은 PC 웹에서만 됩니다. 빗썸 앱에서는 발급이 안 됩니다. PC 브라우저로 bithumb.com에 로그인하세요.
- IP 주소 등록은 필수입니다. 등록한 IP가 아니면 호출이 막히고, 최대 5개까지 넣을 수 있습니다. 넣어야 할 주소는 여러분 PC가 아니라 여러분 대신 빗썸에 조회 요청을 보내는 사토시노트 서버의 IP입니다. 앱 안 연동 가이드에 "IP 복사하기" 버튼과 함께 적혀 있습니다.
- Secret Key는 발급 순간 한 번만 보입니다. 바로 복사해 두세요.
1단계 — 계정관리 → API 관리 → API 2.0
PC 브라우저로 bithumb.com에 로그인한 뒤 계정관리 → API 관리로 들어가 API 2.0 탭을 고릅니다. 옛 API 1.0 탭이 아닌 2.0이어야 사토시노트와 맞습니다. 아래는 사토시노트 앱 안 연동 가이드의 빗썸 절로, 발급 순서 네 단계와 등록할 IP, 꼭 확인할 항목이 한 장에 들어 있습니다.
2단계 — 권한은 자산조회·주문조회만
API 2.0 발급 화면에는 권한 체크박스가 여러 개 있습니다.
- 자산조회와 주문조회 두 칸만 체크합니다.
- 주문하기, 출금하기, 입금하기는 비워 둡니다.
- 자산조회가 있어야 입금·출금으로 들어오고 나간 수량까지 합쳐 지금 보유 수량이 맞게 잡힙니다. 주문조회는 체결 내역(언제 얼마에 몇 개를 사고팔았는지)을 읽는 권한입니다. 자산관리 앱이 평균 단가와 손익을 계산하는 데는 이 둘로 충분합니다.
3단계 — IP 등록, 모두 동의, 생성
- IP 주소 칸에 사토시노트 가이드의 "IP 복사하기"로 복사한 주소를 붙여넣습니다. 5개까지 넣을 수 있지만 하나만 있으면 됩니다.
- 아래 '모두 동의'를 눌러 개인정보 수집과 API 이용 주의사항에 동의해야 API Key 생성 버튼이 눌립니다.
- 버튼을 누르면 Access Key와 Secret Key가 나옵니다. 둘 다 바로 복사하세요. Secret Key는 이 화면을 벗어나면 다시 볼 수 없습니다.
4단계 — 사토시노트에 붙여넣기
사토시노트 앱에 로그인한 뒤 설정 → 자산 연동 → 코리아 탭에서 빗썸을 고르고 Access Key와 Secret Key를 붙여넣습니다. 계정 확인 → 최근 체결 조회 → 투자 기록 정리가 몇 초 안에 끝나고, 빗썸 보유 종목이 수량·평균 단가·평가손익과 함께 업비트 등 다른 거래소 옆에 한 표로 나옵니다. 키는 서버에 암호화해 저장하고 빗썸 조회에만 씁니다.
연동이 끝나면 같은 숫자를 매일 아침 메일 보고서로도 받을 수 있습니다.
자주 막히는 곳
"API Key 생성" 버튼이 눌리지 않아요. '모두 동의'를 아직 안 누른 경우가 대부분입니다. IP 칸이 비어 있어도 안 눌릴 수 있습니다.
키를 넣었는데 "계정 확인" 단계에서 실패해요. 등록 IP가 다르거나 빠진 경우가 가장 흔합니다. 빗썸 API 관리에서 그 키의 IP를 확인하고, 사토시노트 가이드의 IP와 같은지 보세요. API 1.0 탭에서 만든 키도 안 됩니다. 2.0으로 다시 만들어 주세요.
빗썸 잔고가 업비트와 합쳐져 보이나요? 네. 같은 종목(예: BTC)이면 거래소별 수량과 평균 단가가 따로 보이고, 자산 합계는 하나로 묶입니다.
입출금 내역은요? 사토시노트는 빗썸 현물 체결과 잔고를 가져옵니다. 다른 곳에서 옮겨 온 코인은 잔고에는 잡히지만 체결 내역이 없어, 그 수량만큼은 입금으로 따로 기록됩니다.
다른 거래소도 같이 쓴다면
업비트 API 연동 방법, 바이낸스 API 연동 방법도 같은 꼴로 써 두었습니다. 코인원·코빗·고팍스를 포함한 13개 거래소 전부의 그림 가이드는 앱 안 거래소 연동 가이드에 있습니다.
사토시노트는 무료이며 읽기 전용 API 키만 받습니다. 주소는 satoshinote.io입니다.