바이비트 웹훅 연결, 코딩 몰라도 30분이면 끝납니다 (왕초보 완벽 가이드)
※ 이 글은 투자 권유가 아닌 개인 트레이딩 운용 기록입니다. 모든 투자 판단과 책임은 본인에게 있습니다.
💡 시작 전에 — 딱 3줄 요약
1️⃣ 웹훅은 "조건이 맞으면 자동으로 신호를 보내는 통로"일 뿐입니다.
2️⃣ 흐름은 단 3단계예요 → 트레이딩뷰가 신호 발사 → 봇 서버가 통역 → 바이비트가 주문 실행
3️⃣ 코딩 한 줄 몰라도 됩니다. 순서대로 따라 누르기만 하면 끝나요.
🤔 "웹훅"이 대체 뭔가요?
처음 이 단어 들으면 다들 겁먹어요. 저도 그랬습니다.
쉽게 비유할게요. 🛎️
식당 주방의 호출벨이라고 생각해보세요.
- 손님이 벨을 누르면 → 주방에 "주문 들어왔어요!" 신호가 감
- 직원이 계속 테이블을 쳐다보고 있을 필요가 없음
웹훅도 똑같아요.
내가 정한 조건(예: 차트가 특정 모양이 됨)이 발생하면,
트레이딩뷰가 알아서 "지금 사!" 신호를 거래소로 쏴줍니다.
내가 차트 보다가 손으로 주문 누를 필요가 사라지는 것. 이게 전부예요.
🔁 전체 그림부터 보고 갑시다
복잡해 보여도 신호는 딱 3칸만 이동합니다.
[1] 트레이딩뷰 차트
│ 조건 충족! 알림 발생
▼
[2] 봇 서버 (통역사 역할)
│ 신호를 바이비트 언어로 번역
▼
[3] 바이비트 거래소
│ 실제 매수/매도 실행
▼
✅ 포지션 진입 완료
📌 여기서 헷갈리는 포인트 하나.
"왜 [2] 봇 서버가 필요하죠? 트레이딩뷰가 바이비트로 바로 쏘면 안 되나요?"
→ 바이비트는 트레이딩뷰 신호를 직접 못 알아듣기 때문이에요. 언어가 다른 두 사람 사이에 통역사(봇 서버)가 필요한 거죠.
오늘은 이 통역사를 빼고, 신호를 보내는 쪽([1]번)과 거래소 연결([3]번) 세팅에 집중합니다.
1️⃣ 바이비트 API 키 발급받기
💬 API 키 = 봇이 내 계정에 주문을 넣을 수 있게 해주는 출입증이에요.
바이비트 로그인 후 순서대로 누르세요.
| 순서 | 할 일 |
|---|---|
| ① | 우측 상단 프로필 아이콘 클릭 → [API 관리] |
| ② | [새 키 생성] 클릭 |
| ③ | 키 유형: "시스템 생성 API 키" 선택 |
| ④ | 용도: "API 트랜잭션" 선택 |
| ⑤ | 권한 체크 (아래 참고) |
| ⑥ | 2FA 인증 후 API Key / Secret Key 저장 |
⑤ 권한 설정 — 이게 제일 중요합니다.
✅ 주문 → 체크 (필수)
✅ 포지션 → 체크 (필수)
🚨 출금 → 절대 체크 금지!!
출금 권한만 안 줘도, 키가 새어나가도 내 코인은 못 빼갑니다.
저는 이 원칙을 처음부터 지켰고 앞으로도 지킵니다.
💡 초보자 꿀팁
⑥번에서 Secret Key는 이 화면에서 딱 한 번만 보입니다.
창을 닫으면 다시 못 봐요. 메모장에 바로 복사해두세요. (남에게 절대 공유 금지)
IP 화이트리스트는 처음엔 건너뛰어도 됩니다. 익숙해지면 그때 추가하세요. (보안이 훨씬 강해집니다)
2️⃣ 트레이딩뷰 알림 메시지 만들기
💬 봇 서버에게 "이렇게 주문해줘"라고 적은 쪽지라고 보시면 돼요.
이 쪽지는 JSON이라는 형식으로 씁니다. 어렵게 생각 마세요. 그냥 정해진 양식에 빈칸 채우기예요.
제가 실제로 쓰는 매수(Buy) 알람 양식입니다. 그대로 복사해서 쓰세요. 👇
{
"category": "linear",
"symbol": "ETHUSDT",
"side": "Buy",
"orderType": "Market",
"qty": "0.04",
"timeInForce": "GoodTillCancel",
"positionIdx": 0
}
각 줄이 무슨 뜻인지 풀어드릴게요.
| 항목 | 뜻 | 바꾸는 부분 |
|---|---|---|
| category | 상품 종류 (linear = USDT 무기한) | 그냥 두세요 |
| symbol | 어떤 코인 | ETHUSDT, BTCUSDT |
| side | 사기 / 팔기 | Buy / Sell |
| orderType | 주문 방식 | Market(시장가) |
| qty | 수량 (몇 개 살지) | 0.04 → 원하는 수량 |
| timeInForce | 주문 유효 기간 (취소 전까지 유지) | 그냥 두세요 |
| positionIdx | 포지션 모드 (0 = 단방향) | 그냥 두세요 |
💡 바꿀 건 딱 3개예요 →symbol(코인),side(매수/매도),qty(수량). 나머지는 그대로 두면 됩니다.
🔄 매도(Sell) 알람은 위에서 side만 "Sell"로 바꾸면 됩니다. 👇
{
"category": "linear",
"symbol": "ETHUSDT",
"side": "Sell",
"orderType": "Market",
"qty": "0.04",
"timeInForce": "GoodTillCancel",
"positionIdx": 0
}
알림 설정하는 경로
1️⃣ 차트에서 내 전략(지표) 위에 우클릭 → [알림 추가]
2️⃣ 조건 설정 (전략 쓰는 경우 "주문 채움" 추천)
3️⃣ [알림 작업] 탭 → "웹훅 URL" 체크
4️⃣ URL 칸에 봇 서버 주소 입력 (3단계에서 설명)
5️⃣ 메시지 칸에 위 JSON 붙여넣기
비코더라면? 전략 로직을 AI(Claude 등)에게 말로 설명하고 Pine Script(트레이딩뷰 전략 코드)를 받아 붙여넣는 방식을 추천합니다. 제가 V9.x도 그렇게 만들었어요.
3️⃣ 웹훅 URL 연결하기 — 실수 없이!
💬 웹훅 URL = 통역사(봇 서버)의 주소예요. 신호를 여기로 보냅니다.
형태는 이렇게 생겼습니다. 👇
https://your-bot-server.com/webhook/bybit
🚨 초보자가 꼭 지켜야 할 3가지
✅ 반드시 https://로 시작 → http://는 트레이딩뷰가 차단합니다.
✅ 주소 끝 슬래시(/) → 봇 서버 설정과 똑같이 맞추세요.
✅ 트레이딩뷰 Pro 이상 구독 필요 → 무료 플랜엔 웹훅 기능이 없어요.
💡 "봇 서버 만드는 게 부담스러워요" 하는 분께
직접 서버를 안 만들고도 쓸 수 있는 중간 서비스가 있어요. (Alertatron, WunderTrading 등)
다만 저는 직접 서버 운용을 택했습니다. 외부 의존을 줄이고 제 로직을 정확히 제어하고 싶었거든요.
✅ 마지막 체크리스트
연결 전에 이것만 확인하세요.
☐ 출금 권한 체크 안 했는지 재확인 🚨
☐ Secret Key 메모장에 저장했는지
☐ URL이 https://로 시작하는지
☐ 트레이딩뷰 Pro 이상 구독인지
☐ JSON에서 symbol·side·qty 세 개만 맞게 넣었는지
여기까지 다 됐으면, 신호 한 번 테스트로 쏴보세요. 🎯
📌 다음 글 예고: 봇 서버([2]번 통역사) 직접 만드는 법 — 코딩 몰라도 OK
댓글
댓글 쓰기