트레이딩뷰와 OKX를 연동해 자동매매를 설정하려면 OKX에서 API 키를 발급받고, 트레이딩뷰 알림에 JSON 메시지를 구성해 시그널봇에 연결하면 돼요. USDT 기반과 계약 단위 기반 두 가지 주문 방식 중 전략 목적에 맞는 것을 선택해야 해요.
OKX API 키 발급 방법
자동매매 연동의 첫 번째 단계는 OKX에서 API 키를 발급받는 거예요. API 키가 있어야 외부 프로그램인 트레이딩뷰가 OKX 계정을 대신해서 주문을 넣을 수 있거든요.
발급 순서는 이렇게 해요.
- OKX에 로그인한 뒤 계정 메뉴에서 API 관리 항목으로 이동해요
- 새 API 키 생성 버튼을 눌러요
- API 이름을 원하는 대로 설정하고 읽기와 트레이딩 권한을 부여해요
- 생성이 완료되면 API 키와 시크릿 키가 나오는데, 이걸 반드시 안전한 곳에 저장해야 해요
중요한 점은 출금 권한은 절대 부여하지 않는 거예요. 자동매매에는 트레이딩 권한만으로 충분하고, 출금 권한까지 주면 API 키가 유출될 경우 자산이 빠져나갈 수 있어요. API 키와 시크릿 키는 최초 발급 시에만 확인할 수 있으니, 발급 직후 반드시 메모해 두세요.
트레이딩뷰 웹훅 JSON 메시지 구성
트레이딩뷰에서 전략 알림을 설정할 때 웹훅 URL에 OKX 시그널봇 주소를 입력하고, 메시지 본문에 JSON 형식의 데이터를 넣어야 해요. OKX가 이 JSON을 받아서 어떤 종목에 어떤 방향으로 얼마나 주문할지 판단하거든요.
기본 JSON 구조는 다음 네 가지 필드로 구성돼요.
- instrument: 거래 종목 티커, 트레이딩뷰 변수로 자동 입력돼요
- action: 전략이 만든 주문 방향, 매수 또는 매도가 자동으로 들어가요
- amount: 주문할 계약 수 또는 수량, 트레이딩뷰 변수를 사용해요
- signalToken: OKX 시그널봇 생성 시 발급받는 개인 신호 토큰이에요
여기서 instrument나 action 같은 값은 트레이딩뷰가 알림 발생 시점에 자동으로 채워주는 동적 변수예요. signalToken은 OKX에서 신호를 만들 때 발급받는 고유 식별 값으로, 이 토큰이 있어야 OKX가 어떤 봇에게 신호를 전달할지 알 수 있어요. 네 가지 필드가 모두 정확히 맞아야 주문이 정상적으로 실행돼요.
주문 크기 설정 두 가지 방식 비교
주문 크기를 어떻게 정하느냐에 따라 설정 방식이 두 가지로 나뉘어요. 어떤 방식이 더 낫다고 단정할 수 없고, 전략의 목적에 따라 선택하면 돼요.
USDT 기반 방식은 호가 통화인 USDT로 주문 금액을 직접 지정하는 방법이에요. OKX 시그널봇 설정에서 투자 유형을 기본으로 설정하고 금액란에 트레이딩뷰의 계약 수 변수를 넣으면 OKX와의 호환성이 안정적으로 유지돼요. 처음 연동해보는 분들에게 권장되는 방식이에요.
계약 단위 기반 방식은 트레이딩뷰에서 계산한 계약 수를 그대로 OKX에 전달하는 방식이에요. 단, 여기서 반드시 알아야 할 점이 있어요. 트레이딩뷰와 OKX가 계약을 다르게 정의하거든요. 트레이딩뷰에서는 BTCUSDT 1계약이 1 BTC를 의미하지만, OKX에서는 종목마다 계약 크기가 달라요. 그래서 투자 유형을 기본 또는 기준으로 설정할 때 이 계약 크기 차이를 반드시 확인하고 환산해야 해요.
| 구분 | USDT 기반 방식 | 계약 단위 기반 방식 |
|---|---|---|
| 금액 단위 | USDT 고정 금액 | 종목별 계약 수 |
| OKX 호환성 | 안정적 | 계약 크기 사전 확인 필요 |
| 설정 난이도 | 비교적 쉬움 | 종목마다 환산 계산 필요 |
처음이라면 USDT 기반 방식을 먼저 써보고 익숙해진 뒤 계약 단위 방식을 시도하는 게 실수를 줄이는 방법이에요.
OKX 시그널봇 5단계 설정 흐름
OKX 공식 가이드에 따르면 트레이딩뷰와의 연동을 위한 시그널봇 설정 순서는 크게 다섯 단계예요.
- 1단계 시그널봇 액세스: OKX 앱 또는 웹에서 시그널봇 메뉴에 들어가요
- 2단계 신호 만들기: 새 신호를 생성하고 signalToken을 발급받아요, 이 토큰을 트레이딩뷰 JSON에 넣어야 해요
- 3단계 트레이딩뷰 알림 구성: 전략 스크립트, 보조지표, 차트 분석, 타사 프로그램 네 가지 방식 중 하나로 알림을 만들어요
- 4단계 시그널봇 설정: 연동 종목과 레버리지, 주문 크기, 진입 및 청산 조건 등을 설정해요
- 5단계 모니터링 및 관리: 봇이 신호를 받고 실제로 주문을 넣는지 확인하고, 오류가 있으면 로그에서 원인을 파악해요
OKX는 MACD 같은 기술적 보조지표를 활용한 알림 설정 방법도 공식 문서로 제공하고 있어요. Python으로 웹훅 요청을 직접 만드는 예제 코드도 부록으로 제공하니까, 개발 경험이 있다면 더 세밀하게 커스터마이징할 수 있어요.
자주 묻는 질문
트레이딩뷰에서 웹훅 기능은 유료 플랜에서만 사용할 수 있어요. 무료 계정으로는 알림을 만들 수 있지만 OKX로 신호를 자동 전송하는 웹훅 URL 입력이 제한되므로, 연동을 위해서는 최소 Pro 플랜 이상이 필요해요.
자동매매 목적이라면 출금 권한은 절대 부여하지 않는 게 안전해요. 읽기와 트레이딩 권한만으로 매매 자동화가 가능하고, 출금 권한까지 허용하면 API 키가 유출될 경우 자산이 빠져나갈 수 있어요.
트레이딩뷰는 1계약을 기초 자산 1단위로 정의하지만, OKX는 종목마다 계약 크기가 다르게 설정되어 있어요. 그래서 계약 단위 기반으로 설정할 때는 해당 종목의 OKX 계약 크기를 미리 확인하고 트레이딩뷰 계약 수를 환산해야 해요.