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

트레이딩뷰에서 만든 지표·전략의 신호로 OKX 선물과 현물을 자동매매하는 방법입니다.
OKX는 계정 모드와 마진모드 설정이 중요하니 아래 주의사항을 꼭 확인해 주세요.

OKX에서 할 수 있는 것

설정 순서

1. 계정 모드 확인: OKX 거래 설정에서 계정 모드를 선물 모드(Futures mode) 로 둡니다. (예전 이름: Single-currency margin)
2. API키 발급: 프로필 → [API] 에서 API키를 만들고 Trade 권한을 켭니다. Passphrase는 8자 이상(대·소문자, 숫자, 특수문자 포함)으로 정하고 메모해 둡니다. → 거래소 API 발급 방법
3. API키 등록: 확장프로그램 API키 등록 화면의 OKX 줄에 Passphrase, API키, Secret키를 입력하고 [연결중] 을 확인합니다.
4. 주문메시지 작성 → 얼러트 설정: 메시지 작성화면에서 메시지를 만들고, 트레이딩뷰 얼러트에 웹훅 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

예시는 형식을 보여 드리기 위한 것입니다. 실제 메시지는 반드시 확장프로그램의 메시지 작성화면에서 만들어 주세요. 각 항목의 뜻은 주문메시지 항목 설명에 있습니다.

주의사항

• 선물은 레버리지를 쓰지 않아도 마진모드(margin_type)가 필수입니다.
• 주문수량(개수)은 계약 수량입니다. 1계약의 크기는 종목마다 다르며 작성화면에 표시됩니다. USDT·USDC 마켓은 금액 기준 주문도 할 수 있습니다.
• 양방향 모드로 동작하므로 롱 청산은 buy_close, 숏 청산은 sell_close 를 씁니다.
• 추적손절매 콜백 비율은 0.1 ~ 100% 입니다.
• API키를 만들려면 계정 자산이 일정 금액(100 USD 상당) 이상 있어야 합니다.

자주 묻는 질문

Q. 주문이 계속 실패해요.
계정 모드가 선물 모드인지, 주문메시지에 마진모드가 들어 있는지 먼저 확인해 주세요. 그 밖의 점검 순서는 주문이 안 될 때 확인할 것에 있습니다.

Q. 모의로 먼저 해 볼 수 있나요?
네. OKX 선물·현물 테스트넷을 지원합니다.