OKX 선물 자동매매 설정 방법 (트레이딩뷰 연동)

트레이딩뷰 얼러트로 OKX 선물·현물을 자동매매하는 방법. 계정 모드(선물 모드) 설정, API키와 Passphrase, 필수 마진모드와 계약 수량, 양방향 청산 주문메시지 예시와 주의사항을 정리했습니다.

트레이딩뷰 지표·전략의 신호로 OKX 선물과 현물을 자동매매합니다. OKX는 계정 모드와 마진모드 설정이 중요합니다. 아래 주의사항을 꼭 보세요.

지원 범위

항목	내용
선물 (`okx`)	USDT, USDC, USD 선물 — 양방향 모드
현물 (`okx-spot`)	현물 매수·매도
선물 옵션	레버리지, 마진모드(필수), 목표가·손절가, 추적손절매, 조건주문
테스트넷	선물 `okx-testnet`, 현물 `okx-spot-testnet`

확인할 것	이렇게 하세요
마진모드는 필수	선물 메시지마다 격리 또는 교차를 고릅니다. 레버리지를 넣지 않아도 필요합니다.
격리·교차	격리는 포지션마다 증거금을 나누고, 교차는 가용 증거금을 함께 씁니다. 청산 메시지도 같은 마진모드로 만듭니다.
계정 모드	선물 모드(Futures mode)로 둡니다. 마진모드와는 다른 설정입니다.
포지션 청산	양방향이라 롱 청산 `buy_close`, 숏 청산 `sell_close`를 씁니다.
수량 단위	개수 입력은 계약 수량입니다. 1계약 크기는 작성 화면에서 확인합니다. USDT·USDC 마켓은 금액으로도 넣을 수 있습니다.
추적손절매	콜백 비율 0.1–100%를 넣습니다.

가장 많이 헷갈리는 점

레버리지는 몇 배로 거래할지, 마진모드는 증거금을 어떻게 쓸지 정합니다. 레버리지를 껐다고 마진모드를 빼면 안 됩니다. 현물(okx-spot)에는 이 선물 설정이 없습니다.

OKX API키

API키를 만들려면 계정 자산이 100 USD 상당 이상 있어야 합니다.

OKX 거래 설정에서 계정 모드를 선물 모드(Futures mode)로 둡니다. (예전 이름: Single-currency margin)

프로필 → [API]에서 API키를 만들고 Trade 권한을 켭니다. Passphrase는 8자 이상(대·소문자, 숫자, 특수문자 포함)으로 정하고 메모해 둡니다. → 그림으로 보기

「API키 등록」의 OKX 줄에 Passphrase, API키, Secret키를 넣고 저장합니다. 주문 허용이 켜졌는지 확인합니다.

「메시지 작성」에서 메시지를 만듭니다. 트레이딩뷰 얼러트에 웹훅 URL과 함께 넣습니다. → 웹훅 URL 설정

잔액 20%로 교차 마진 롱 진입 (레버리지 없이도 마진모드 필수)

TVM:{"exchange":"okx","account":"기본계정","symbol":"BTC/USDT","type":"market","side":"buy","bal_pct":20,"margin_type":"cross","token":"인증키"}:MVT

롱 포지션 전량 시장가 청산

TVM:{"exchange":"okx","account":"기본계정","symbol":"BTC/USDT","type":"market","side":"buy_close","token":"인증키"}:MVT

예시는 형식만 보여 줍니다

실제 메시지는 확장프로그램 「메시지 작성」에서 만드세요. 항목의 뜻은 주문메시지 항목 설명에 있습니다.

OKX 수수료 할인 링크는 거래소 수수료 할인에 있습니다.