주문메시지 항목 설명

주문메시지가 어떤 주문을 내는지 확인할 때 보는 참고 문서입니다. 주문이 생각과 다르게 들어갈 때 원인을 찾는 데도 씁니다.

1. 구조이 위치 링크 복사

TVM:{"exchange":"binance","account":"기본계정","symbol":"BTC/USDT","type":"limit","side":"sell","price":"last","amount":0.01,"token":"인증키"}:MVT

• TVM:으로 시작해 :MVT로 끝납니다.
• 가운데는 "항목":값을 쉼표로 이은 JSON입니다.

여러 주문을 차례로이 위치 링크 복사

메시지를 한 줄에 하나씩 이어 붙이면 위에서부터 차례로 실행합니다.

TVM:{"exchange":"bybit","account":"기본계정","symbol":"BTC/USDT","type":"market","side":"sell_close","token":"인증키"}:MVT
TVM:{"exchange":"bybit","account":"기본계정","symbol":"BTC/USDT","type":"market","side":"buy","bal_pct":30,"token":"인증키"}:MVT

TVM:{"exchange":"bybit","account":"기본계정","symbol":"BTC/USDT","type":"market","side":"buy","bal_pct":30,"token":"인증키"}:MVT
TVM:{"exchange":"bybit","account":"서브계정","symbol":"BTC/USDT","type":"market","side":"buy","bal_pct":30,"token":"인증키"}:MVT

• 앞 주문이 실패해도 다음 주문은 실행됩니다. 실패는 텔레그램으로 확인하세요.
• 메시지마다 분당 주문 횟수에 들어갑니다.
• 사이에 간격이 필요하면 뒤 메시지에 지연시간(delay)을 넣습니다.
• 단축 주문메시지도 같은 방법으로 이어 붙일 수 있습니다.

전략 수량대로 주문이 위치 링크 복사

전체 메시지의 amount에 {{strategy.order.contracts}}를 넣으면 전략이 계산한 수량으로 주문합니다.

• 전체 메시지에서만 됩니다. 단축 메시지와 전략 변환은 저장한 수량을 씁니다.
• 진입·청산마다 같은 메시지가 와서 조건식으로 나눠야 합니다.

예제와 순서는 전략 수량대로 주문을 따라 해 주세요.

2. 기본 항목이 위치 링크 복사

주문가격 price이 위치 링크 복사

price_pct로 가격을 % 만큼 옮깁니다. 지정가 매수를 더 싸게 하려면 -1, 지정가 매도를 더 비싸게 하려면 1.

주문수량 amount · bal_pct · equity이 위치 링크 복사

• amount: 기본은 코인 개수입니다.
  • amount_type을 krw(빗썸·업비트)나 usdt로 하면 금액만큼 주문합니다.
  • 일부 선물 마켓은 계약 수량입니다. → 거래소별
• bal_pct: 자산 대비 %입니다. 수수료 때문에 99% 이하를 권합니다.
• equity:
  • 잔액 대비(기본): 주문 가능한 현금이 기준. 전액 매수·매도, 포지션 안 청산에 씁니다.
  • 총자산 대비("equity":"y"): 현금 + 코인이 기준. 분할매수를 같은 금액으로 할 때 씁니다.

레버리지를 쓰면 넣은 수량에 레버리지 배수를 곱해 주문합니다.

3. 주문방법 side이 위치 링크 복사

• 청산 수량을 비우면 100% 청산합니다.
• 분할청산은 수량(%)을 잔액 대비로 넣습니다.
• close_all은 종목·유형·수량 없이 항상 시장가 100%입니다.
• 어느 모드인지는 거래소·마켓이 정합니다. → 거래소별

TVM:{"exchange":"bybit","account":"기본계정","side":"close_all","token":"인증키"}:MVT

4. 공통 추가 옵션이 위치 링크 복사

• 시간대 밖이거나 조건식이 거짓이면 알림 없이 건너뜁니다.
• 조건식에는 =, <, >와 플레이스홀더를 씁니다.
• 같은 주문 건너뛰기는 선물에 포지션이 없으면 적용되지 않습니다.

옵션을 바꾸려면 「메시지 작성」에서 고칩니다.

• 전체 메시지를 쓰면: 다시 만들어 얼러트에 붙여넣습니다.
• 단축 메시지(주문ID)를 쓰면: 저장된 메시지만 고치면 됩니다. → 차이

장외 거래이 위치 링크 복사

「메시지 작성」 → 실행 조건 → 장외 거래를 켜면 정규장 밖에도 주문합니다. 메시지에는 "extended_hours":true가 들어갑니다.

시간은 한국시간입니다.

• 국내 NXT
  • 프리마켓 08:00–08:50, 애프터마켓 주문 15:30–20:00 (체결은 15:40부터)
  • NXT에서 거래되는 종목만 주문합니다. KRX 장외시장으로 자동 전환하지 않습니다.
• 한투 미국 주간거래
  • 한국 10:00부터 뉴욕 04:00까지 (서머타임 한국 17:00, 표준시 18:00 종료)
  • 한국시간 월–금 낮입니다.
• 한투 미국 프리·애프터마켓
  • 장외 거래를 켜지 않아도 주문합니다. 휴장·종목 제한으로 거부될 수 있습니다.

장외 거래를 켜도 모든 시간·모든 종목이 되는 것은 아닙니다. 정규장은 기존 방식으로 주문합니다.

시장가 허용 폭이 위치 링크 복사

아래 시장가 주문은 증권사에 시장성 지정가로 냅니다.

• 한투 미국 주식 시장가
• 한투·키움 국내 NXT 시간의 시장가

허용 폭 입력란은 「시장가」를 고르고 아래 조건일 때만 나옵니다.

• 범위 0–5%, 비우면 0.5%. 항목 이름은 slippage입니다.
• 국내는 입력란이 보여도 NXT 시간에만 적용됩니다. KRX 정규장은 기존 시장가입니다.

미체결 자동 취소이 위치 링크 복사

「메시지 작성」 → 실행 조건 → 미체결 자동 취소에 1–600초를 넣습니다. 비우면 꺼집니다. 항목 이름은 cancel_after입니다.

• 시간이 지나면 남은 수량만 취소합니다. 체결된 부분은 그대로입니다.
• 트레이딩뷰 얼러트 주문에서만 동작합니다. 바로 주문·퀵주문은 해당 없습니다.
• 실제 시장가로 낸 주문(국내 정규장 시장가 등)에는 적용되지 않습니다.
• 취소는 설정 시각보다 조금 늦을 수 있습니다.

5. 선물 전용 옵션이 위치 링크 복사

매수(buy)·매도(sell)에서만 씁니다. 청산에는 못 씁니다. 단, 조건주문은 선물 일반 청산에도 씁니다(현물·close_all 제외).

조건주문은 목표가·손절가·추적손절매와 같이 쓸 수 없습니다. 바이낸스 스탑마켓, 바이빗 조건부 주문과 같은 기능입니다.

TVM:{"exchange":"binance-futures","account":"기본계정","symbol":"BTC/USDT","type":"market","side":"buy","bal_pct":20,"leverage":5,"margin_type":"isolated","tp_pct":3,"sl_pct":-1.5,"token":"인증키"}:MVT

6. 거래소별 값과 주의사항이 위치 링크 복사

• 양방향은 청산에 buy_close/sell_close, 한방향은 close를 씁니다.
• 테스트넷·모의투자 값: bybit-testnet, bybit-spot-testnet, bitget-testnet, okx-testnet, okx-spot-testnet, phemex-testnet, phemex-spot-testnet, kis-testnet, kiwoom-testnet

7. 자주 하는 실수이 위치 링크 복사

그래도 안 되면 → 주문이 안 될 때

파인 전략의 alert_message에 메시지를 넣는 법은 지표를 전략으로에 있습니다.