주문메시지 항목 설명과 거래소별 주의사항

TVExtBot의 주문메시지는 TVM:{ ... }:MVT 형태의 짧은 JSON입니다. 이 글에서는 메시지에 들어가는 각 항목의 의미와 값, 그리고 거래소별로 다른 점과 주의사항을 정리했습니다.
메시지가 어떤 주문을 실행하는지 확인하거나, 주문이 의도와 다르게 들어갈 때 원인을 찾는 데 활용해 주세요.

1. 주문메시지의 구조

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

• TVM: 으로 시작해서 :MVT 로 끝나며, 가운데는 "항목":값 을 쉼표로 이은 JSON입니다.
• 하나의 얼러트 메시지 칸에 주문메시지를 최대 10개까지 넣을 수 있고, 넣은 순서대로 실행됩니다. (예: 청산 → 반대 방향 진입)
• 메시지 작성화면의 주문메시지 리스트에는 최대 600개까지 저장할 수 있습니다.

여러 주문을 순서대로 실행하기

주문메시지를 줄을 바꿔 이어 붙이면, 얼러트 하나로 여러 주문을 위에서부터 순서대로 실행합니다.

예) 기존 포지션을 청산한 뒤 롱 진입 (얼러트 메시지 칸에 입력)

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)을 설정합니다.
• 단축 주문메시지도 같은 방법으로 여러 개를 이어 붙일 수 있습니다.

2. 기본 항목

주문가격 price

price_pct 로 주문가격을 퍼센트만큼 조정할 수 있습니다. 예를 들어 지정가 매수에서 주문가격보다 싸게 사려면 -1, 지정가 매도에서 비싸게 팔려면 1 을 넣습니다.

주문수량 amount / bal_pct / equity

• amount (개수·금액): 기본은 코인 개수입니다. amount_type 을 krw(빗썸·업비트) 나 usdt(USDT 마켓) 로 하면 원하는 금액만큼 주문합니다. 선물 일부 마켓은 계약 수량으로 입력합니다. (거래소별 주의사항 참고)
• bal_pct (자산 대비 %): 수수료 때문에 100%로 하면 자산 부족 에러가 날 수 있으니 최대 99% 까지 넣어 주세요.
• equity:
  • 잔액 대비(기본): 주문 가능한 현금만 기준으로 합니다. 전액 매수(매도) 할 때나, 포지션 안에서 청산할 때 사용합니다.
  • 총자산 대비("equity":"y"): 현금과 코인을 합친 자산이 기준입니다. 분할매수 때 매번 같은 금액으로 주문할 때 사용합니다.

레버리지를 쓰면 입력한 주문수량(개수 또는 %)에 레버리지 배수를 곱한 수량으로 주문합니다.

3. 주문방법 side

• 청산에서 수량을 비워 두면 100% 청산합니다. 분할청산은 주문수량(%)을 잔액 대비로 넣어 주세요.
• close_all 은 종목·주문유형·수량이 없고 항상 시장가 100%로 청산합니다.

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

• 어느 모드를 쓰는지는 거래소와 마켓에 따라 정해집니다. (거래소별 주의사항 참고)

4. 공통 추가 옵션

동일주문 연속실행 방지는 선물에서 포지션이 없으면 같은 주문이라도 실행됩니다.

5. 선물 전용 옵션

매수(buy)·매도(sell) 주문에서만 쓸 수 있습니다. 청산 주문에는 사용할 수 없습니다.

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

예: 바이낸스 선물 롱 진입 + 레버리지 + 목표가·손절가

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

잔액의 20%에 레버리지 5배로 시장가 롱 진입하고, 주문가격 대비 +3%에 목표가, −1.5%에 손절가를 겁니다.

6. 거래소별 exchange 값과 주의사항

“양방향"은 청산에 buy_close / sell_close, “한방향"은 close 를 씁니다. 메시지 작성화면의 주문방법 목록도 이에 맞춰 바뀝니다.

빗썸 · 업비트

• 원화(KRW) 마켓만 지원합니다. (업비트 BTC·USDT 마켓은 지원하지 않습니다)
• amount_type 을 krw 로 하면 원하는 원화 금액만큼 주문할 수 있습니다. (예: "amount":100000,"amount_type":"krw" = 10만원어치)
• 업비트는 주문가격에 포지션 평균가격(avg) 을 선택할 수 있습니다.
• 현물이므로 레버리지·목표가·손절가 등 선물 옵션과 청산은 사용할 수 없습니다. 매도(sell)로 보유 코인을 팝니다.

바이낸스 (현물 · 선물)

• 선물의 청산 방식은 바이낸스 거래소 설정의 포지션 모드를 따릅니다. 한방향이면 close, 양방향이면 buy_close/sell_close 입니다. 모드를 바꿨다면 주문메시지를 새로 만들어 주세요. → 바이낸스선물 양방향 포지션 설정법
• USD 마켓(COIN-M)은 주문수량을 계약 수량으로 입력합니다. (1계약의 USD 금액은 작성화면에 표시됩니다)
• 추적손절매 콜백 비율은 0.1 ~ 5% 입니다.
• 리듀스 온리는 한방향 모드에서만 사용할 수 있습니다.

바이빗 (현물 · 선물)

• USDT 마켓은 양방향 모드, USD 마켓(인버스)은 한방향 모드로 동작합니다.
• USD 마켓은 주문수량을 USD 금액으로 입력합니다.
• 레버리지는 0.1 단위로 설정할 수 있습니다.
• 테스트넷: bybit-testnet(선물), bybit-spot-testnet(현물) → 바이빗 테스트넷 사용법

비트겟

• 선물은 양방향 모드로 동작하므로 청산은 buy_close/sell_close 를 씁니다. 리듀스 온리는 사용할 수 없습니다.
• 목표가·손절가의 지정가격(tp_lo_*, sl_lo_*)은 사용할 수 없습니다. 발동가격에서 시장가로 청산합니다.
• 추적손절매 콜백 비율은 1 ~ 10% 입니다.
• 카피 트레이딩 대상 코인은 100% 수량 시장가 청산만 가능합니다. (지정가 청산, 부분 청산 미지원)

OKX

• 선물은 양방향 모드로 동작합니다.
• 선물은 레버리지를 쓰지 않아도 마진모드(margin_type)가 필수입니다.
• 주문수량(개수)은 계약 수량입니다. (1계약의 크기는 종목마다 다르며 작성화면에 표시됩니다) USDT·USDC 마켓은 amount_type 으로 금액 기준 주문도 할 수 있습니다.
• 추적손절매 콜백 비율은 0.1 ~ 100% 입니다.
• 테스트넷: okx-testnet(선물), okx-spot-testnet(현물)

BingX

• 선물만 지원하며 양방향 모드로 동작합니다.
• 추적손절매 콜백 비율은 1 ~ 100% 이고, 활성화 가격(ts_ac_*)은 사용할 수 없습니다.

페멕스

• USDT 마켓은 양방향 모드, USD 마켓은 한방향 모드로 동작합니다. USD 마켓은 주문수량을 계약 수량(장) 으로 입력합니다.
• 레버리지는 격리 모드에서만 적용되며 0.1 단위로 설정할 수 있습니다.
• 추적손절매 활성화 가격(ts_ac_*)은 사용할 수 없습니다.
• 테스트넷: phemex-testnet(선물), phemex-spot-testnet(현물)

한국투자증권

• API키 등록 시 계정명에 증권 계좌번호를 입력해야 합니다.
• 종목은 API키를 등록한 뒤 선택할 수 있습니다. 마켓은 코스피(KOSPI), 코스닥(KOSDAQ), 나스닥(NASD), 뉴욕(NYSE), 아멕스(AMEX)입니다.
• 주문수량(개수)은 주식 수입니다.
• 해외주식(미국) 은 지정가 주문만 가능하며, 주문가격에 BID·ASK는 선택할 수 없습니다.
• 주문이 들어가지 않는다면 해당 시장의 거래 시간인지 먼저 확인해 주세요.

7. 자주 하는 실수

• 목표가·손절가의 부호를 반대로 넣음: 매수(롱)는 목표가 +, 손절가 −, 매도(숏)는 목표가 −, 손절가 + 입니다. 작성화면이 잘못된 부호를 알려 줍니다.
• 격리 주문에서 주문수량(%)을 100 넘게 입력: 격리 주문은 반드시 100 이하로 넣어 주세요.
• 양방향 모드 거래소에서 close 사용: 양방향 모드에서는 buy_close/sell_close 를 써야 합니다. 거래소의 포지션 모드를 바꿨다면 청산 메시지를 새로 만들어 주세요.
• 청산할 때 총자산 대비(equity) 선택: 포지션 안에서 청산할 때는 잔액 대비를 선택해 주세요. 총자산 대비로 청산하려면 수량(%)을 꼭 넣어야 합니다.
• 지연시간(delay)을 길게 설정: 최대 300초까지 가능하지만, 길수록 가격이 변해 주문이 실행되지 않을 가능성이 높아집니다. 또 한 얼러트의 전체 처리 시간이 약 530초를 넘으면 남은 주문메시지는 실행되지 않으니, 여러 메시지에 지연시간을 겹쳐 쓰지 않도록 주의해 주세요.
• 계정명을 바꾼 뒤 기존 메시지를 그대로 사용: account 가 API키 등록화면의 계정명과 같아야 합니다.

그 밖에 주문이 들어가지 않을 때의 점검 순서는 주문이 안 될 때 확인할 것을 참고해 주세요.