API 연동

바이낸스 API 읽기 전용 권한은 어디에 쓰나요? 시세 조회와 자산 대조 활용법

바이낸스 API 읽기 전용 권한(Enable Reading)은 잔고, 주문, 체결 내역을 조회할 수 있지만 주문과 출금은 할 수 없습니다. 읽기 전용 키로 할 수 있는 일, 생성 방법, 시세 조회와 자산 대조 활용법, 위험 요소를 정리했습니다.

바이낸스 API의 읽기 전용 권한(화면에는 Enable Reading으로 표시됩니다)은 데이터를 읽기만 할 수 있고, 주문, 주문 취소, 출금은 할 수 없습니다. 따라서 시세 조회, 자산 대조, 타사 가계부 도구에 대한 권한 부여에 적합합니다. 키를 만들려면 먼저 바이낸스 공식 사이트에서 계정 관리 화면에 로그인해야 합니다. 모바일 사용자는 바이낸스 공식 앱에서도 이미 만든 키를 확인할 수 있으며, 아이폰 사용자는 iOS 설치 안내를 참고하시기 바랍니다. 읽기 전용 키는 자금을 움직일 수 없지만 잔고와 체결 내역은 볼 수 있으므로 여전히 민감한 정보에 해당합니다. 아무에게나 넘기지 않도록 주의하세요.

읽기 전용 권한으로 할 수 있는 일과 할 수 없는 일

A: 읽기 전용 권한으로는 계정 잔고, 현재 미체결 주문, 과거 주문, 체결 상세, 입금 내역, 출금 내역을 조회할 수 있습니다. 주문 생성, 주문 취소, 출금 요청은 할 수 없습니다. 바이낸스에서 API 키를 만들면 기본적으로 읽기 권한만 선택되어 있고, 거래, 출금, 선물 등의 권한은 직접 따로 켜야 합니다.

읽기 전용 권한의 가치는 "데이터를 보는 일"과 "자금을 움직이는 일"을 완전히 분리한다는 데 있습니다. 읽기 전용 키를 리포트 도구, 가계부 앱, 직접 만든 스크립트에 넘겨 두었다면 키가 유출되더라도 공격자는 자산을 이체하거나 시장에서 주문할 수 없으므로 피해는 개인정보 수준에 머뭅니다.

아래 표는 자주 쓰이는 권한 유형별 능력을 비교한 것입니다. 정확한 명칭과 선택지는 바이낸스 API 관리 페이지에 현재 표시되는 내용을 기준으로 하시기 바랍니다.

권한 유형 잔고·내역 조회 주문·취소 출금 유출 시 주요 위험
읽기 전용(Enable Reading) 가능 불가 불가 보유 자산과 거래 습관 노출
현물 및 마진 거래 가능 가능 불가 악의적 주문으로 손실 발생
선물 거래 가능 가능(선물 계정) 불가 악의적 포지션 진입 또는 강제 청산
출금 허용 가능 다른 선택에 따라 다름 가능 자산이 곧바로 이체됨

표에서 보듯 읽기 전용 키는 네 가지 설정 가운데 위험이 가장 낮습니다. 데이터를 보기만 하면 되는 용도라면 편하다는 이유로 모든 권한을 선택하지 말고 읽기 전용을 먼저 선택해야 합니다.

공개 시세와 읽기 전용 키는 무엇이 다른가

A: 공개 시세 엔드포인트는 키가 전혀 필요 없으며, 읽기 전용 키는 "내 계정 데이터를 보는 일"을 위한 것입니다. 최신 가격, 캔들, 호가 깊이, 24시간 통계 같은 바이낸스의 시세 엔드포인트는 공개 데이터여서 로그인 없이 누구나 호출할 수 있습니다.

초보자는 시세를 조회하는 데에도 API 키가 있어야 한다고 오해하는 경우가 많지만, 실제로는 HTTP 요청 한 번이면 충분합니다. 아래 명령으로 BTCUSDT의 최신 가격을 바로 조회할 수 있습니다.

curl "https://api.binance.com/api/v3/ticker/price?symbol=BTCUSDT"

반환되는 결과는 거래쌍 이름과 최신 체결 가격이 담긴 JSON입니다. 잔고, 미체결 주문, 체결 내역처럼 개인 계정과 연결된 데이터만 API Key를 포함하고 요청에 서명해야 합니다.

비교 항목 공개 시세 엔드포인트 읽기 전용 키 엔드포인트
API Key 필요 여부 불필요 필요
서명 필요 여부 불필요 필요(HMAC-SHA256)
얻을 수 있는 내용 가격, 캔들, 호가, 체결 잔고, 주문, 체결, 입출금 내역
개인정보 관련 여부 아니요 예
대표 용도 차트 확인, 시세 대시보드, 전략 백테스트 자산 대조, 가계부, 보유 자산 모니터링

읽기 전용 권한의 대표적인 세 가지 활용법

A: 읽기 전용 키의 대표적인 활용법은 자산 대조, 보유 자산 모니터링, 타사 도구에 대한 권한 부여 세 가지입니다. 세 경우 모두 자금을 움직일 필요가 없고, 계정 데이터를 안정적으로 읽을 수만 있으면 됩니다.

활용법 1: 자산 대조

자산 대조란 바이낸스 계정에 있는 실제 잔고를 자신의 장부나 스프레드시트와 항목별로 맞춰 보는 작업입니다. 읽기 전용 엔드포인트로 자산 목록을 읽어 오고, 직접 기록한 매수, 매도, 입금, 출금 내역을 합산해 비교하면 빠뜨린 수수료, 기록하지 않은 이체, 장부에 적지 않은 거래를 찾아낼 수 있습니다.

대조할 때는 보통 사용 가능 잔고, 동결 잔고, 평가액 세 가지 숫자에 주목합니다. 동결 잔고는 체결되지 않은 미체결 주문에서 생기는데 놓치기 쉬워서, 장부와 API가 반환한 값이 맞지 않는 원인이 되곤 합니다.

활용법 2: 보유 자산 모니터링

보유 자산 모니터링은 계정 자산을 주기적으로 가져온 뒤 공개 시세 가격을 곱해 총자산 평가액을 구하는 방식입니다. 개인 대시보드, 휴대폰 홈 화면 위젯, 알림 스크립트 상당수가 이 방식으로 동작합니다.

이런 스크립트는 데이터를 읽기만 하므로 읽기 전용 키로 충분합니다. 개인 컴퓨터, 라즈베리 파이, 클라우드 서버 중 어디에서 실행하더라도 거래 권한을 켤 필요가 없습니다.

활용법 3: 타사 가계부·세무 도구에 권한 부여

일부 가계부, 자산 집계, 세무 정리 도구는 거래 내역을 동기화하기 위해 읽기 전용 API 키를 요구합니다. 이런 도구는 직접 주문할 필요가 없으므로 읽기 전용 권한이면 충분합니다. 어떤 도구가 출금 권한을 켜 달라고 요구한다면 즉시 권한 부여를 중단하고 출처를 확인해야 합니다.

1단계부터 4단계까지: 읽기 전용 API 키 만들기

A: 읽기 전용 키 생성은 보통 로그인, API 관리 진입, 키 생성과 이름 지정, Secret 저장과 권한 확인의 네 단계로 이루어집니다. 바이낸스 웹과 앱의 메뉴 위치는 버전에 따라 바뀔 수 있으니 실제 화면을 기준으로 하시기 바랍니다.

1단계: 로그인하고 인증 준비하기

먼저 바이낸스 공식 사이트에 로그인하여 필요한 신원 인증이 끝났는지, 2단계 인증(2FA)이 켜져 있는지 확인합니다. API 키를 만들 때 바이낸스는 보통 2FA, 이메일, 문자 인증 코드 중 하나로 작업을 확인하도록 요구합니다.

2단계: API 관리 페이지 열기

계정 센터에서 "API 관리" 메뉴를 찾아 새 API 키 생성을 선택합니다. 바이낸스에서는 시스템이 생성하는 키 유형을 고르고 키에 라벨을 붙일 수 있습니다. 라벨에 "읽기 전용-가계부 도구"처럼 용도를 적어 두면 나중에 구분하기 쉽습니다.

3단계: 권한 확인하고 IP 연결하기

생성이 끝나면 키 페이지에 권한 목록이 표시됩니다. 읽기 전용 용도의 키는 "읽기 활성화"만 켜 두고, 거래와 출금 등 나머지 권한이 꺼져 있는지 확인해야 합니다. 아울러 IP 접근 제한을 입력해 본인의 서버나 고정된 발신 주소에서만 호출할 수 있게 해 두는 것이 좋습니다.

4단계: Secret Key 저장하기

API Key는 페이지에서 언제든 확인할 수 있지만, Secret Key는 보통 생성할 때 한 번만 전체가 표시됩니다. Secret은 즉시 비밀번호 관리자나 암호화한 파일에 저장하세요. 채팅방에 스크린샷을 보내거나 공개 코드 저장소에 적어 두어서는 안 됩니다. 구체적인 보관 방법은 이 사이트의 "바이낸스 API 키를 안전하게 보관하는 방법" 글을 참고하시기 바랍니다.

읽기 전용 키로 계정을 조회하는 기본 흐름

A: 서명이 포함된 읽기 요청은 API Key를 요청 헤더에 넣고, 매개변수에 타임스탬프를 포함하며, 서명을 쿼리 문자열 끝에 붙이는 세 부분으로 구성됩니다. 서명은 Secret Key로 매개변수 문자열에 HMAC-SHA256을 적용해 계산합니다.

아래 Python 예제는 환경 변수에서 키를 읽은 뒤 현물 계정 정보를 조회하는 방법을 보여 줍니다.

import os, time, hmac, hashlib, requests

API_KEY = os.environ["BINANCE_API_KEY"]
API_SECRET = os.environ["BINANCE_API_SECRET"]

query = f"timestamp={int(time.time() * 1000)}"
signature = hmac.new(API_SECRET.encode(), query.encode(), hashlib.sha256).hexdigest()

resp = requests.get(
    f"https://api.binance.com/api/v3/account?{query}&signature={signature}",
    headers={"X-MBX-APIKEY": API_KEY},
)
for item in resp.json()["balances"]:
    if float(item["free"]) > 0 or float(item["locked"]) > 0:
        print(item["asset"], item["free"], item["locked"])

이 코드는 잔고가 0이 아닌 자산만 출력합니다. 요청이 401이나 권한 오류를 반환하면 먼저 키에 읽기 권한이 선택되어 있는지, 호출하는 IP가 화이트리스트에 있는지 확인하세요. 서명의 나머지 세부 사항은 이 사이트의 "바이낸스 API 서명 생성 방법" 글에서 다룹니다.

자주 쓰는 읽기 계열 엔드포인트로는 계정 정보, 현재 미체결 주문, 주문 내역, 계정 체결 기록, 입금 내역, 출금 내역이 있습니다. 정확한 경로와 매개변수는 바이낸스 공식 API 문서를 기준으로 하시기 바랍니다.

자산 대조를 실제로 하는 방법

A: 자산 대조는 먼저 대조 시점을 고정한 뒤, API 데이터와 자신의 기록을 항목별로 맞춰 보는 방식으로 합니다. 이렇게 하면 데이터가 실시간으로 바뀌어서 생기는 불일치를 피할 수 있습니다.

아래 절차는 개인과 소규모 팀이 참고하기에 알맞습니다.

  1. 대조 시점을 정합니다. 예를 들어 매월 말일의 정해진 시각으로 하고, 그때의 타임스탬프를 기록합니다.
  2. 읽기 전용 엔드포인트로 그 시점의 자산별 사용 가능 잔고와 동결 잔고를 읽어 옵니다.
  3. 해당 기간의 체결 기록, 입금 기록, 출금 기록을 읽어 옵니다.
  4. 직전 기말 잔고에 당기 유입을 더하고 당기 유출을 빼서 이론상 잔고를 계산합니다.
  5. 이론상 잔고와 API가 반환한 실제 잔고를 비교해 자산별로 차이를 확인합니다.

차이가 생겼을 때 가장 흔한 원인은 수수료가 다른 자산으로 차감된 경우(예: BNB로 수수료 결제), 소액 자산 전환, 이벤트 보상 입금, 계정 간(현물, 펀딩, 선물) 이체를 기록하지 않은 경우입니다. 원인을 찾을 때는 전체를 한꺼번에 비교하지 말고 자산별로 하나씩 확인해야 합니다.

차이의 원인 전형적인 증상 확인 방법
수수료 차감 잔고가 예상보다 조금 적음 체결 기록의 수수료 자산 확인
계정 간 이체 현물 잔고가 갑자기 변함 이체 내역과 대조
이벤트 보상·에어드롭 잔고가 한 건 더 많음 자금 내역과 공지 확인
동결 잔고 사용 가능 잔고가 적어 보임 현재 미체결 주문 조회
소액 자산 전환 여러 소액 자산이 사라짐 전환 내역 대조

읽기 전용 키를 사용할 때의 위험과 보안 안내

A: 읽기 전용 키 때문에 자금이 이체되지는 않지만 보유 자산과 거래 행동이 노출되므로, 여전히 민감한 인증 정보로 보관해야 합니다. 보유 자산 정보가 다른 사람 손에 들어가면 사회공학적 공격과 피싱 사기의 소재로 쓰일 수 있습니다.

기본적인 보안 규칙은 다음과 같습니다.

  • 읽기 전용 용도의 키에는 거래, 선물, 출금 권한을 선택하지 마세요. 권한이 적을수록 안전합니다.
  • 키에 IP 접근 제한을 설정해 본인의 고정 주소에서만 호출할 수 있게 합니다.
  • 도구나 스크립트마다 별도의 키를 사용해 개별적으로 폐기할 수 있게 합니다.
  • 고객센터 직원이나 "운용 대행"을 자처하는 사람에게 키를 넘기지 마세요. 바이낸스는 공식적으로 Secret Key를 요구하지 않습니다.
  • 비정상적인 호출이 보이거나 특정 도구를 더 이상 쓰지 않게 되면 API 관리 페이지에서 해당 키를 즉시 삭제합니다.
  • 타사 도구가 출금 권한을 요구하면 고위험 신호로 보고 권한 부여를 거부하세요.

또한 이 사이트는 독립적인 제3자 안내 사이트이며 바이낸스 공식 웹사이트가 아니라는 점을 알려 드립니다. API의 권한 명칭, 페이지 진입 경로, 제한 규칙은 바이낸스 공식 페이지와 문서에 현재 표시되는 내용을 기준으로 하시기 바랍니다. 암호화폐 자산의 가격은 크게 변동하며 투자에는 위험이 따릅니다. 중국 본토 사용자는 관련 서비스를 이용할 때 현지 법령을 직접 확인하고 준수해야 합니다.

자주 묻는 질문

Q: 바이낸스 API 읽기 전용 권한으로 다른 사람이 출금할 수 있나요? A: 할 수 없습니다. 읽기 전용 권한에는 출금 기능이 포함되어 있지 않으며, 출금에는 별도의 "출금 허용" 권한이 필요합니다. 다만 읽기 전용 키가 유출되면 보유 자산과 체결 내역이 노출되므로 즉시 삭제하고 다시 만들어야 합니다.

Q: 시세만 보는 데에도 API 키를 신청해야 하나요? A: 필요하지 않습니다. 최신 가격, 캔들, 호가 깊이 같은 공개 시세 엔드포인트는 키도 서명도 필요 없으며 HTTP 요청만 보내면 받을 수 있습니다.

Q: 읽기 전용 키에 IP 화이트리스트를 설정하지 않아도 되나요? A: 설정하지 않아도 사용할 수는 있지만 권장하지 않습니다. IP 제한을 두면 키가 유출되더라도 다른 주소에서는 사용할 수 없습니다. 유동 IP를 쓰는 사용자는 발신 주소가 고정된 클라우드 서버를 거쳐 요청을 전달하는 방법이 있습니다.

Q: 읽기 전용 키로 선물 계정 데이터도 볼 수 있나요? A: 선물 계정 데이터를 API로 읽으려면 보통 키 권한에서 선물 관련 옵션을 별도로 켜야 합니다. 구체적인 옵션은 바이낸스 API 관리 페이지에 표시되는 내용을 기준으로 하시기 바랍니다.

Q: 타사 가계부 도구가 읽기 전용 키를 요구하는데 안전한가요? A: 권한 면에서는 읽기 전용이 비교적 안전하지만, 도구의 출처가 믿을 만하고 개인정보 처리에 대한 설명이 분명한지 확인해야 합니다. 그 도구 전용으로 키를 따로 만들고, 사용하지 않게 되면 바로 삭제하세요.

Q: 읽기 전용 호출에서 권한 오류가 반환되면 어떻게 하나요? A: 먼저 키에 읽기 권한이 선택되어 있는지 확인하고, 호출하는 IP가 화이트리스트에 있는지, 시스템 시간이 바이낸스 서버 시간과 크게 어긋나지 않는지 점검한 다음, 마지막으로 서명이 올바른지 확인하세요.

Q: 읽기 전용 키도 주기적으로 교체해야 하나요? A: 주기적으로 교체하기를 권장하며, 담당자 변경, 도구 사용 중단, 유출 의심이 있을 때는 즉시 교체하세요. 교체 주기에 통일된 기준은 없으므로 본인의 위험 감수 수준에 맞게 정하면 됩니다.

아직 바이낸스 계정이 없다면 먼저 바이낸스 공식 사이트에서 가입과 인증을 마친 뒤 이 글의 절차대로 읽기 전용 키를 만드세요. 모바일에서는 바이낸스 공식 앱을 설치해 두면 언제든 키 상태를 확인할 수 있습니다.

계속 둘러보기

바이낸스 사용에 대한 추가 질문이 있으신가요? 카테고리 페이지로 돌아가 같은 주제의 다른 가이드를 찾아보세요.

카테고리

관련 가이드

바이낸스 API 신청 방법? 키 및 서명 생성 가이드 2026-04-14 바이낸스 현물(Spot) API 사용법: 첫 주문까지 가능한 실행 코드 가이드 2026-04-14 바이낸스 선물(Futures)과 현물(Spot) API의 차이점은? 엔드포인트와 가중치 비교 2026-04-14 바이낸스 API 사용 시 IP 차단될까? 제한 정책 및 가중치 계산법 총정리 2026-04-14