TVExtBot가이드
시작하기

처음 시작하기

설치부터 첫 자동주문까지, 확장프로그램 「시작하기」 화면과 같은 순서로 안내합니다.

처음이라면 5분 따라 하기로 테스트넷에서 먼저 주문해 보세요. 이 문서는 한 단계씩 따라 하면 첫 자동주문까지 끝납니다.

시작하기 전에 필요한 것

  • 트레이딩뷰 유료 요금제(Essential 이상)
  • 트레이딩뷰 2단계 인증 (웹훅 알림에 필요)
  • 처음에는 무료 인증키로 한 달 동안 테스트넷에서 연습할 수 있습니다.

전체 순서

확장프로그램 설치

크롬 웹 스토어에서 설치합니다. → 설치하기

인증키 등록

처음이라면 무료 인증키로 시작합니다. → 인증키 받기

거래소 API키 등록

거래소에서 API키를 만들어 등록합니다. → API키 등록

주문메시지 만들기

매수·매도 메시지 2개를 만들어 저장합니다. → 메시지 만들기

트레이딩뷰 얼러트 연결

전략 코드에 메시지를 연결하고 얼러트를 1개 만듭니다. → 얼러트 연결

텔레그램 알림 (선택)

주문 결과와 에러를 바로 받습니다. → 알림 연결

끝낸 단계는 「시작하기」 화면에 자동으로 체크됩니다.

1. 확장프로그램 설치

크롬 웹 스토어에서 TVExtBot을 찾아 [Chrome에 추가]를 누릅니다. → 크롬 웹 스토어로 바로가기

브라우저 오른쪽 위 확장프로그램 아이콘을 누릅니다. TVExtBot 옆의 고정핀을 눌러 툴바에 고정합니다.

TVExtBot 아이콘을 누르면 팝업이 열립니다. 팝업 오른쪽 위 설정을 누르면 설정 화면이 열립니다.

처음 열면 「시작하기」 화면이 나옵니다.

① 시작하기 메뉴(배지는 끝낸 단계 수) ② 위에서부터 차례로 할 일 — 인증키 → API키 → 주문메시지 → 얼러트 연결, 텔레그램 알림은 선택

왼쪽 메뉴 구성

  • 자동매매: 메시지 작성 · 전략 변환 · 퀵주문
  • 기록: 주문내역 · 에러 메시지
  • 설정: API키 등록 · 인증키 등록 · 기본설정 · 기본정보

설정을 마치면 「시작하기 숨기기」로 메뉴에서 숨길 수 있습니다. 「기본정보」에서 다시 켤 수 있습니다.

2. 인증키 받기·등록

「인증키 등록」 화면에서 인증키를 받습니다.

  1. [무료 인증키 발행하기]를 누릅니다.
  2. 이메일을 넣고 [발행]을 누릅니다.
  3. 메일로 인증키가 옵니다.

무료 인증키는 테스트넷 전용, 한 달입니다. 이때 쓸 API키는 IP 등록 없이 만들어 주세요.

① [무료 인증키 발행하기] → 이메일 입력 → [발행]

받은 메일의 이메일과 인증키를 「내 인증키」 칸에 붙여넣습니다. [인증하기]를 누르면 끝입니다.

처음에는 「사용 전 확인해 주세요」 창이 뜹니다. 내용을 읽고 [위 내용에 동의하고 시작하기]를 누릅니다.

① 이메일 ② 인증키 → [인증하기] ③ 인증 완료 메시지

3. 거래소 API키 등록

API키 발급 방법은 거래소마다 다릅니다. → 거래소 API키 발급

「API키 등록」 화면에서 거래소 줄의 [+ 키 등록]을 누릅니다. API키와 비밀키를 넣고 [저장]을 누릅니다.

① 거래소 선택 ② API키·비밀키 입력 ③ [저장] (IP와 키는 가렸습니다)

연결되면 "연결에 성공하였습니다"가 뜹니다. 주문 허용 스위치도 켜집니다.

① 연결 성공 메시지 ② 켜진 주문 허용 스위치

IP 등록이 필요한 거래소

「API키 등록」 화면 위의 거래소에 등록할 IP주소를 모두 등록하세요. IP와 웹훅 URL은 인증키 버전마다 다릅니다. 꼭 내 확장프로그램에 나온 값을 쓰세요.

4. 주문메시지 만들기

「메시지 작성」에서 매수·매도 메시지 2개를 만들어 리스트에 저장합니다. 여기서는 슈퍼트렌드가 롱이면 매수, 숏이면 매도하는 예제로 설명합니다.

예제에서 쓰는 값

  • 거래소: Bybit 선물 · 종목: BTC/USDT
  • 주문유형: 시장가 · 수량: 잔액 대비 30%
  • 레버리지: 1배(격리)
  • 「포지션 청산후 주문실행」 켬 — 반대 포지션을 먼저 정리하므로 청산 메시지가 따로 필요 없습니다.

무료 인증키로 연습한다면

거래소를 Bybit 선물 테스트넷으로 고르세요. 데모 계정은 교차 마진이라 마진모드를 교차로 바꿔야 합니다. 격리로 두면 주문이 거절됩니다. → 바이빗 테스트넷 사용법

매수 메시지

  1. 주문방법을 매수로 고릅니다.
  2. 「포지션 · 리스크 관리」에서 레버리지 1배(격리)를 고릅니다.
  3. 「포지션 청산후 주문실행」을 켭니다.
  4. [메시지 만들기]를 누릅니다.
  5. 메모에 「슈퍼트렌드 롱주문」을 적고 [+ 리스트에 저장]을 누릅니다.
① 주문수량 ② 포지션 청산후 주문실행 ③ [메시지 만들기] ④ [+ 리스트에 저장]

매도 메시지

주문방법만 매도로 바꿉니다. 나머지는 그대로 둡니다. 메모에 「슈퍼트렌드 숏주문」을 적고 저장합니다.

① 주문수량 ② 포지션 청산후 주문실행 ③ [메시지 만들기] ④ [+ 리스트에 저장]

저장하기 전에 오른쪽 아래 「지금 바로 주문」으로 시험해 볼 수 있습니다. 테스트넷에서 해 보세요.

한 거래소에서 1분에 실행되는 주문 수는 인증키마다 다릅니다(TRIAL 1회, STANDARD 10·15·20회). 넘는 주문은 무시되고, 1분 뒤부터 다시 주문됩니다.

5. 트레이딩뷰 얼러트 연결

「전략 변환」을 쓰면 전략 코드에 주문메시지가 자동으로 연결됩니다. 코드를 직접 고칠 필요가 없고, 얼러트도 1개면 됩니다.

전략 코드 변환

아래 슈퍼트렌드 전략을 복사합니다. 설명용이니 실거래에는 쓰지 마세요.

슈퍼트렌드 전략 (Pine Script v6)
//@version=6
strategy("슈퍼트렌드 전략", overlay = true,
     initial_capital   = 10000,
     default_qty_type  = strategy.percent_of_equity,
     default_qty_value = 10,
     commission_type   = strategy.commission.percent,
     commission_value  = 0.05,
     slippage          = 1)

atrPeriod = input.int(10, "ATR 기간", minval = 1)
factor    = input.float(3.0, "ATR 배수", minval = 0.1, step = 0.1)

[st, dir] = ta.supertrend(factor, atrPeriod)
plot(dir < 0 ? st : na, "상승 추세", color.green, style = plot.style_linebr)
plot(dir > 0 ? st : na, "하락 추세", color.red,   style = plot.style_linebr)

if ta.change(dir) < 0
    strategy.entry("Long", strategy.long)
if ta.change(dir) > 0
    strategy.entry("Short", strategy.short)
  1. 왼쪽 메뉴 「전략 변환」에 코드를 붙여넣고 [코드 확인]을 누릅니다.
  2. 「진입 2 · 청산 0」, 「롱·숏(반전 전략)」으로 나오면 [다음: 주문메시지 연결]을 누릅니다.
  3. 롱 진입에 「슈퍼트렌드 롱주문」, 숏 진입에 「슈퍼트렌드 숏주문」을 고릅니다.
  4. [변환하기] → [코드 복사] → [다음: 트레이딩뷰 설정]을 누릅니다.
① 롱 진입 ② 숏 진입에 메시지 선택 ③ [변환하기]
① [인증키 복사] ② [웹훅URL 복사] — 화면 안내 순서대로 진행합니다

트레이딩뷰에 전략 추가

  1. Pine 에디터에 변환한 코드를 붙여넣습니다.
  2. 저장 → 차트에 추가(▷)를 누릅니다.
① 변환한 코드 붙여넣기 ② 차트에 추가
  1. 전략 설정(⚙) → Inputs 탭을 엽니다.
  2. 「TVExtBot」 그룹의 인증키 칸에 복사한 인증키를 붙여넣고 [Ok]를 누릅니다.

주문ID는 이미 채워져 있습니다.

① 인증키 ② 주문ID(자동 입력) ③ [Ok]

얼러트 만들기

위쪽 Alert를 눌러 Create alert 창을 엽니다.

항목설정
Condition변환한 전략 (지표가 아닙니다)
Message기본값 {{strategy.order.alert_message}} 그대로
Notifications → Webhook체크하고 복사한 웹훅 URL 붙여넣기
① 조건에서 전략 선택 ② 메시지 ③ Webhook ④ [Create]

이제 신호가 나오면 TVExtBot이 자동으로 주문합니다. 첫 주문이 들어오면 「시작하기」의 얼러트 단계가 체크됩니다.

① Alerts 목록에 Active로 표시됩니다

웹훅 URL 주의

웹훅 URL은 인증키 버전마다 다릅니다. 반드시 [웹훅URL 복사]로 내 URL을 쓰세요. 다른 버전의 URL을 쓰면 주문 에러가 납니다.

알아 두면 좋은 것

  • 익절·손절(strategy.exit)이 있으면 청산에도 메시지를 연결합니다. → 전략 변환
  • 지표(alertcondition)로 매매하려면 얼러트마다 메시지를 넣습니다. → 웹훅 URL 자동매매
  • 전략 설정이나 코드를 바꾸면 얼러트를 다시 만들어야 합니다.
  • 수량·레버리지만 바꿀 때는 「메시지 작성」에서 고치면 바로 반영됩니다.

6. 텔레그램 알림 연결 (선택)

주문 실패를 놓치지 않도록 연결해 두기를 권합니다.

  1. 「기본설정」 → 텔레그램 개인 알림의 [연결]을 누릅니다.
  2. 열린 텔레그램 봇 대화창에서 시작을 누릅니다.
  3. 상태가 연결됨으로 바뀌면 끝입니다.

자세한 내용은 개인 알림봇을 보세요.

마지막 점검

  • 「시작하기」의 단계가 모두 체크되어 있다
  • 사용할 거래소의 주문 허용이 켜져 있다
  • 얼러트의 웹훅 URL이 내 확장프로그램의 URL과 같다
  • 매수·매도 메시지를 리스트에 저장했다
  • 텔레그램이 연결됨이다 (선택)
  • 실거래 전에 테스트넷이나 소액으로 확인했다

주문이 안 들어가면 「에러 메시지」 화면을 먼저 보세요. 그다음 주문이 안 될 때를 순서대로 점검합니다.

유의사항

  • 주문메시지는 꼭 「메시지 작성」에서 만드세요. 오류가 있으면 주문되지 않습니다.
  • 트레이딩뷰 점검이나 거래소 API 장애 때는 주문되지 않을 수 있습니다.
  • 사용 중 생긴 장애나 손해는 책임지지 않습니다. 동의하는 경우에만 사용해 주세요.

다음에 읽을 것

이 페이지에서