바이낸스 API 연동 방법 — 읽기 전용 키 만들기부터 사토시노트 등록까지 (2026)
가이드 · · Satoshi Note
다른 언어: English
업비트에는 원화로 산 코인, 바이낸스에는 USDT로 산 코인이 따로 있다면 두 거래소를 오가며 합산하는 일이 매번 반복됩니다. 바이낸스 API 키를 한 번 만들어 자산관리 앱에 넣으면 그 수고가 끝납니다. 이 글은 바이낸스에서 읽기 전용 키를 만들고 사토시노트에 등록하는 순서를 처음부터 따라갑니다. 5분 정도 걸리고 비용은 없습니다.
바이낸스 API 키 사고 이야기는 거의 전부 거래나 출금 권한이 켜진 키에서 나옵니다. 여기서 만드는 키는 둘 다 없습니다. 잔고와 체결 내역을 읽는 것만 됩니다. 읽기 전용 키가 무엇이고 왜 안전한지는 읽기 전용 키란? 출금은 못 하는 안전한 거래소 연동 방법에 따로 적어 두었습니다.
준비물
- 2단계 인증(구글 OTP 등)이 켜진 바이낸스 계정. 바이낸스는 2단계 인증 없이는 API 키를 만들 수 없게 막아 둡니다.
- PC 브라우저. 앱에서도 되지만 API Management 화면은 웹이 훨씬 편합니다.
- 다른 탭에 사토시노트 연동 가이드(설정 → 자산 연동 → 글로벌 → 바이낸스)를 열어 두면 키가 나오자마자 붙여넣을 수 있습니다.
1단계 — API Management로 가기
binance.com에 로그인한 뒤 우측 상단 프로필 아이콘을 누르고 API Management를 고릅니다. 아래는 사토시노트 앱 안 연동 가이드의 바이낸스 절로, 세 단계 순서와 꼭 확인할 항목이 들어 있습니다.
2단계 — 시스템 생성 키 만들기
- Create API 버튼을 누릅니다.
- 키 종류는 System generated(시스템 생성)를 고릅니다. 다른 선택지인 Self-generated는 Ed25519 키 쌍을 직접 만들어 올려야 하는 방식인데, 사토시노트는 바이낸스가 만들어 주는 일반(HMAC) 키를 씁니다.
- 라벨에
satoshinote-readonly처럼 나중에 알아볼 이름을 적고 Next를 누릅니다. - 바이낸스가 요구하는 이메일 인증과 OTP 인증을 끝냅니다.
그러면 API Key와 Secret Key가 나옵니다. 둘 다 바로 복사하세요. Secret Key는 이 한 번만 보여 주고, 화면을 벗어나면 키를 지우고 새로 만들어야 합니다.
3단계 — 권한 확인
만든 키를 열어 API restrictions 항목을 봅니다. 기본 상태가 바로 우리가 원하는 상태입니다.
| 권한 | 설정 |
|---|---|
| Enable Reading(읽기) | 켬 |
| Enable Spot & Margin Trading(현물·마진 거래) | 끔 |
| Enable Futures(선물) | 끔 |
| Enable Withdrawals(출금) | 끔 (회색 그대로 두기) |
체크가 필요한 건 Enable Reading 하나뿐입니다. 자산관리 용도의 키에 거래·출금 권한을 켤 이유는 없습니다. 바이낸스는 키를 특정 IP에서만 쓰게 제한하는 기능도 제공합니다. 사토시노트는 바이낸스 연동에 IP 등록을 필수로 요구하지 않지만, 켜고 싶다면 앱 안 가이드의 "IP 복사하기" 버튼으로 서버 주소를 넣으면 됩니다.
4단계 — 사토시노트에 붙여넣기
사토시노트 설정 → 자산 연동 → 글로벌 탭에서 바이낸스를 고르고 API Key와 Secret Key를 붙여넣습니다. 계정 확인 → 최근 체결 조회 → 투자 기록 정리가 몇 초 안에 끝나고, 바이낸스 보유 종목이 수량·평균 단가·평가손익과 함께 업비트·빗썸 같은 다른 거래소 옆에 한 표로 나옵니다. 키는 서버에 암호화해 저장하고 바이낸스 조회에만 씁니다.
바이낸스만의 특징
체결 조회는 종목마다 따로 이뤄집니다. 바이낸스 체결 내역 API는 거래쌍 하나씩 묻는 방식이라, 사토시노트는 잔고와 기록에 이미 있는 종목 위주로 체결을 가져옵니다. 예전에 사고 전부 팔아 지금 잔고에 없는 코인은 기록에 한 번 직접 넣어 주면 다음 동기화 때 내역이 채워집니다.
체결가는 USDT 기준입니다. 사토시노트는 기록을 한 기준 통화로 묶어 둡니다. USDT 체결은 체결 시점의 업비트 KRW-USDT 환율로 원화 환산해 저장하고, 한국어 화면에서는 원화로 보여 줍니다.
현물만 가져옵니다. 거래소 연동으로 들어오는 건 현물 잔고와 체결입니다. 선물 포지션은 키로 가져오지 않습니다. 큰 선물 트레이더들이 지금 어디에 베팅하는지 보고 싶다면 키가 아예 필요 없는 사토시 인덱스를 보면 됩니다.
자주 막히는 곳
"Invalid API-key, IP, or permissions for action" 오류가 나요. Secret Key를 붙여넣을 때 앞뒤 공백이 섞였거나, 키에 IP 제한이 걸려 있는데 사토시노트 서버 주소가 안 들어간 경우입니다. API Management에서 그 키의 IP 설정을 확인하거나 제한을 풀어 보세요.
새 키가 바로 안 돼요. 바이낸스는 새 키가 활성화되는 데 1분쯤 걸리기도 합니다. 잠시 뒤 다시 시도하세요.
분명 거래한 코인인데 안 들어와요. 위 "체결 조회는 종목마다"를 보세요. 그 코인을 기록에 한 번 넣으면 다음 동기화에서 내역을 가져옵니다.
다른 거래소도 같이 쓴다면
거래소마다 키를 하나씩 넣으면 한 표에 합쳐집니다. 업비트 API 연동 방법, 빗썸 API 연동 방법도 같은 꼴로 써 두었고, OKX·바이비트·코인베이스·크라켄·일본 거래소까지 13곳 전부는 앱 안 거래소 연동 가이드에 그림과 함께 있습니다.
사토시노트는 무료이며 읽기 전용 API 키만 받습니다. 주소는 satoshinote.io입니다.