← 가이드 목록

🔗 거래소 API 연동하기 (자동 알림)

약 6분 읽기 · 참고용, 예측 아님

API 연동이 뭔가요?

Baro에서 포지션은 두 가지 방법으로 추적할 수 있어요. (1) 손으로 직접 진입가·방향을 입력하는 방법, (2) 거래소 API를 연동해 내 실제 포지션을 자동으로 읽어오는 방법이에요.

API 연동은 '읽기 전용 열쇠'를 Baro에 한 번 맡겨두는 거예요. 그러면 Baro가 2~3분마다 내 거래소 포지션을 대신 확인하고, 위험 신호가 보이면 텔레그램으로 알려줘요. 매번 손으로 넣을 필요가 없어지는 거죠.

이건 프리미엄 기능이에요. → 'Baro 사용법'과 '선물 거래 하는 법'을 먼저 보면 이해가 쉬워요.

연동하면 좋은 점

  • 자동 추적: 손으로 진입가를 넣지 않아도 내 실제 포지션을 그대로 읽어와요.
  • 위험 알림: 청산가에 가까워지거나, 레버리지가 과하거나, 손실이 커지면 텔레그램으로 즉시 알려줘요. 자리를 비워도 놓치지 않아요.
  • 여러 거래소 한 번에: HyperLiquid·Binance·Bybit·OKX·Bitget·Gate·KuCoin을 함께 모니터링할 수 있어요.
  • 안전한 범위: 읽기 전용이라 Baro는 잔고를 '보기'만 해요. 주문도 출금도 할 수 없어요.
💡 알림은 참고용이에요. 위험을 빨리 알아차리게 도와주는 거지, 대신 거래해주거나 청산을 막아주는 게 아니에요. 실제 대응은 본인이 거래소에서 직접 해야 해요.

read-only 키가 왜 안전한가요?

거래소 API 키는 권한을 골라서 만들 수 있어요. Baro에는 '조회 전용(read-only)' 키만 넣으면 돼요 — 잔고·포지션을 읽는 권한만 있고, 주문·출금 권한은 없는 키예요.

키를 넣을 때 불안하시죠? Baro는 이렇게 보관해요. 입력 즉시 Google Cloud KMS로 암호화돼 저장되고, 데이터베이스엔 암호문만 남아요. 평문 키는 격리된 '읽기 전용' 서버가 포지션을 조회하는 그 순간에만 메모리에서 잠깐 풀고 곧바로 버려요(로그에도 안 남겨요). 저장하는 쪽과 복호화하는 쪽의 권한이 분리돼 있어서, 운영자가 데이터베이스를 열어봐도 보이는 건 암호문뿐이에요. 그리고 Baro 코드에는 주문·출금 기능 자체가 없어서, 설령 무슨 일이 생겨도 이 키로 할 수 있는 건 '읽기'밖에 없어요.

  • Baro는 읽기 전용 키만 받아요. 출금·거래 권한이 있는 키는 넣지 마세요.
  • 키는 암호화해서 보관해요(평문 저장 안 함). 복호화는 격리된 조회 서버 안에서만 일어나요.
  • Baro 코드에는 주문·출금을 실행하는 경로 자체가 없어요. 그래서 키가 새어도 누가 그 키로 돈을 옮길 수 없어요(읽기 전용이라 거래소가 거부).
⚠️ 절대 시드문구(복구 문구)나 거래소 로그인 비밀번호를 넣는 게 아니에요. 거래소에서 '새 API 키'를 만들 때 출금·거래 권한을 끄고, 그 API Key와 Secret만 넣는 거예요. 시드문구·비밀번호는 누구에게도(Baro 포함) 입력하지 마세요.

HyperLiquid 연동 (가장 쉬움 · 키 불필요)

HyperLiquid는 API 키조차 필요 없어요. 지갑주소만 넣으면 끝이에요(지갑주소는 공개 정보예요).

  1. 포지션 알림 열기Baro 사이드바에서 '포지션 알림'을 눌러요(프리미엄).
  2. 텔레그램 연결'텔레그램 봇 열고 연결' 버튼을 눌러 봇에서 시작을 누르면 연결돼요.
  3. 지갑주소 입력HyperLiquid에서 쓰는 0x… 지갑주소를 붙여넣고 저장하면 끝. 2~3분마다 자동 점검돼요.

CEX(중앙화 거래소) API 키 만들고 연동하기

Binance·Bybit·OKX·Bitget·Gate·KuCoin 같은 중앙화 거래소는 읽기 전용 API 키를 만들어 넣어요. 거래소마다 화면은 조금씩 달라도 흐름은 같아요.

  1. 거래소에서 새 API 키 생성거래소 앱/웹 → 'API' 또는 'API 관리' 메뉴 → 새 키 만들기.
  2. ★권한은 '읽기 전용'만★Read / 조회 권한만 켜고, 'Trade(거래)'와 'Withdraw(출금)'는 반드시 꺼요. 출금 권한이 켜진 키는 절대 만들지 마세요.
  3. API Key · Secret 복사생성하면 API Key와 Secret이 나와요. Secret은 그때 한 번만 보이니 복사해 두세요. OKX·Bitget·KuCoin은 Passphrase도 함께 정해요.
  4. Baro에 입력포지션 알림 → '다른 거래소(read-only API 키)'에서 거래소를 고르고 Key·Secret(필요시 Passphrase)을 붙여넣고 '이 거래소 연동'을 눌러요.
  5. 끝 — 자동 점검연동되면 2~3분마다 그 거래소 포지션도 자동으로 확인하고 위험 시 알려줘요. 여러 거래소를 동시에 연동할 수 있어요.
⚠️ 키를 만들 때 출금·거래 권한이 꺼져 있는지 꼭 확인하세요. 그리고 거래소가 'API 키에 허용 IP 지정' 옵션을 주면, 안내되는 IP만 허용으로 잠가두면 더 안전해요(곧 Baro가 고정 IP를 안내할 예정).
💡 키 종류를 묻는 화면이 나오면 'System generated'(HMAC)를 고르세요 — API Key와 Secret이 바로 나오는 가장 간단한 방식이고 Baro가 이걸 씁니다. 'Self-generated'(RSA/Ed25519)는 직접 키쌍을 만들어야 해서 고급 사용자용이에요.
⚠️ ★Binance만 예외예요.★ Binance는 '선물 포지션 읽기'를 켜려면 'Enable Futures'를 켜야 하는데, 이게 선물 '거래' 권한까지 같이 줘요(읽기만 따로 못 끔). 그래서 Binance 키는 ① 출금(Withdrawals)·현물거래는 반드시 끄고 ② 가능하면 'Restrict access to trusted IPs'로 허용 IP를 Baro가 안내하는 IP로 제한하세요. (현물 잔고만 볼 거면 Reading만 켜면 진짜 읽기 전용입니다.) Bybit·OKX·Bitget·Gate·KuCoin은 선물 포지션을 거래 권한 없이 읽는 깨끗한 '읽기 전용' 키가 돼요.
  1. Binance우상단 프로필 → 계정(Account) → API Management. (상단 메뉴의 'API'는 개발자 문서 페이지라 키를 못 만들어요.) → Create API → System generated.
  2. Bybit우상단 계정 → API → New Key → 'Read-Only' + Positions 읽기 선택.
  3. OKX프로필 → API → 키 생성 → 권한 'Read'만(Trade·Withdraw 끔) + Passphrase 설정.
  4. Bitget / Gate / KuCoinAPI 관리 메뉴 → 새 키 → 읽기 전용(read-only) 권한 + (Bitget·KuCoin은 Passphrase). 출금·거래 끔.

안전 체크리스트

  • ✅ 읽기 전용(Read) 권한만 — Trade·Withdraw는 꺼짐
  • ✅ 시드문구·로그인 비밀번호가 아니라, 새로 만든 API Key·Secret만 입력
  • ✅ 의심되거나 안 쓰면 거래소에서 그 API 키를 삭제(언제든 가능)
  • ✅ 알림은 참고용 — 실제 대응은 거래소에서 직접
포지션 알림 설정하러 가기 →
프리미엄 기능이에요. 거래소 가입이 처음이면 '거래소 가입 방법' 가이드부터 보세요.
다른 가이드
📘 코인·선물 기초 용어🏦 거래소 가입 방법 (레퍼럴)🦊 코인 전송 방법 (메타마스크)📈 선물 거래 하는 법🕯️ 차트 보는 법🔔 차트 신호들의 의미🧭 Baro 사용법