USDT 무기한 선물 · LONG/SHORT
GET · 요청 본문 없음 · 실계좌
금액 입력은 USDT 명목가치: 100 / 5 = 주문 100 USDT · 예상 증거금 20 USDT
quantity도 계약 수·코인 개수가 아닌 USDT 금액입니다. 비율만 %이며 증거금 방식은 isolated입니다.
GET order 시장가 진입·청산 · TP/SL 없음
/bingx/order/{type}/{symbol}/{quantity}/{current_price}
- symbol
- BTCUSDT 또는 BTC-USDT · 실제 거래소 종목으로 매칭
- long / short
- quantity USDT만큼 롱 / 숏 진입
- exitlong / exitshort
- quantity USDT만큼 해당 방향 포지션을 시장가 청산
- exitlongratio / exitshortratio
- 해당 방향 포지션의 비율 청산 · 50 = 50% · 100 = 전량 · 0 초과 100 이하 · % 기호 없이 입력
- current_price
- USDT 참고 가격 · 이격 기록용이며 주문 가격·수량 환산에는 사용하지 않음
100 USDT 롱 시장가 진입
https://bingx.vtalk.co.kr/bingx/order/long/BTCUSDT/100/60000
25 USDT만큼 롱 청산
https://bingx.vtalk.co.kr/bingx/order/exitlong/BTCUSDT/25/60000
롱 포지션 50% 청산
https://bingx.vtalk.co.kr/bingx/order/exitlongratio/BTCUSDT/50/60000
계좌의 단방향 모드에서는 반대 방향 진입이 기존 포지션을 줄이며, 양방향 모드에서는 독립 처리합니다. 금액·비율 청산 요청이 청산 가능 수량을 초과하면 가능한 잔량 전부로 줄여 접수하고 로그·Slack에 기록합니다. 미체결 주문을 임의 취소하거나 반대 포지션을 만들지 않습니다. 잔량 0 또는 최소 주문 조건 미달이면 거부합니다. /order는 계좌의 현재 레버리지를 사용합니다.
GET trigger EP 진입 + TP/SL
/bingx/trigger/{side}/{symbol}/{amount}/{leverage}/{ep}/{tp}/{sl}
- amount / leverage
- 명목가치(USDT) / 정수 레버리지 · side는 long 또는 short
- ep / tp / sl
- 진입 / 익절 / 손절 절대 가격 · USDT · LONG은 SL < EP < TP, SHORT는 TP < EP < SL
LONG: EP < 표시가격 × 1.01이면 EP 지정가 매수. 그 이상이면 거래소 트리거 시장가 주문을 제출합니다.
SHORT: EP > 표시가격 × 0.99이면 지정가, 그 이하이면 트리거 시장가입니다. TP/SL은 진입 주문에 연결해 거래소로 전달합니다.
지정가는 체결 가능한 가격이면 즉시 체결될 수 있습니다. 정확히 1% 경계값은 지정가 분기에 포함되지 않습니다.
100 USDT · 5배 · EP 60,000 / TP 66,000 / SL 54,000
https://bingx.vtalk.co.kr/bingx/trigger/long/BTCUSDT/100/5/60000/66000/54000
GET trailing activation → EP · 서버 2단계 감시
/bingx/trailing/{side}/{symbol}/{amount}/{leverage}/{activation}/{ep}/{tp}/{sl}
인자는 trigger와 같고, EP 앞에 감시 시작 가격 activation을 추가합니다. 거래소 기본 트레일링 주문은 아닙니다.
LONG: activation 이하 하락 → EP 스톱 시장가 주문 + TP/SL을 거래소에 제출 → EP 반등 시 진입
LONG: SL < activation < EP < TP · SHORT: TP < EP < activation < SL. SHORT는 activation 이상 상승 후 EP 하락을 기다립니다.
이 단계에서는 trigger의 1% 지정가 분기를 적용하지 않습니다. 진입 전에 SL을 먼저 통과하면 감시·미체결 진입 주문을 취소하고 통지합니다.
57,000 하락 → 60,000 반등 진입 · 100 USDT / 5배
https://bingx.vtalk.co.kr/bingx/trailing/long/BTCUSDT/100/5/57000/60000/66000/54000
처리 규칙
trigger는 거래소 접수 후 서버의 추가 감시가 없습니다. trailing은 activation 및 진입 전 SL을 서버가 감시하므로 서버 실행이 필요합니다.
접수 성공은 체결 완료가 아닙니다. /order 접수는 HTTP 202와 ok: true, trailing 감시 등록은 HTTP 202와 status: success를 반환합니다. trigger는 HTTP 200과 status: success를 반환합니다.
5초 이내 동일 URL은 HTTP 200 / DUPLICATE_IGNORED로 무시하고 로그·Slack에 기록합니다. 실패는 사유를 기록·통지하며, ORDER_RESULT_UNKNOWN(HTTP 502)은 접수 여부 불명으로 자동 재전송하지 않습니다.
최소 주문금액·수량 및 잔고 조건 미달 시 주문을 거부합니다. X-Webhook-Event-Id는 선택적 로그 대조용 헤더입니다. 예시 URL을 호출하면 실제 주문이므로 복사만 제공합니다.
USDT 무기한 선물 · LONG/SHORT
GET · 요청 본문 없음 · 실계좌
금액 입력은 USDT 명목가치: 100 / 5 = 주문 100 USDT · 예상 증거금 20 USDT
quantity도 계약 수·코인 개수가 아닌 USDT 금액입니다. 비율만 %이며 증거금 방식은 isolated입니다.
GET order 시장가 진입·청산 · TP/SL 없음
/okx/order/{type}/{symbol}/{quantity}/{current_price}
- symbol
- BTCUSDT 또는 BTC-USDT · 실제 거래소 종목으로 매칭
- long / short
- quantity USDT만큼 롱 / 숏 진입
- exitlong / exitshort
- quantity USDT만큼 해당 방향 포지션을 시장가 청산
- exitlongratio / exitshortratio
- 해당 방향 포지션의 비율 청산 · 50 = 50% · 100 = 전량 · 0 초과 100 이하 · % 기호 없이 입력
- current_price
- USDT 참고 가격 · 이격 기록용이며 주문 가격·수량 환산에는 사용하지 않음
100 USDT 롱 시장가 진입
https://bingx.vtalk.co.kr/okx/order/long/BTCUSDT/100/60000
25 USDT만큼 롱 청산
https://bingx.vtalk.co.kr/okx/order/exitlong/BTCUSDT/25/60000
롱 포지션 50% 청산
https://bingx.vtalk.co.kr/okx/order/exitlongratio/BTCUSDT/50/60000
계좌의 단방향 모드에서는 반대 방향 진입이 기존 포지션을 줄이며, 양방향 모드에서는 독립 처리합니다. 금액·비율 청산 요청이 청산 가능 수량을 초과하면 가능한 잔량 전부로 줄여 접수하고 로그·Slack에 기록합니다. 미체결 주문을 임의 취소하거나 반대 포지션을 만들지 않습니다. 잔량 0 또는 최소 주문 조건 미달이면 거부합니다. /order는 계좌의 현재 레버리지를 사용합니다.
GET trigger EP 진입 + TP/SL
/okx/trigger/{side}/{symbol}/{amount}/{leverage}/{ep}/{tp}/{sl}
- amount / leverage
- 명목가치(USDT) / 정수 레버리지 · side는 long 또는 short
- ep / tp / sl
- 진입 / 익절 / 손절 절대 가격 · USDT · LONG은 SL < EP < TP, SHORT는 TP < EP < SL
LONG: EP < 표시가격 × 1.01이면 EP 지정가 매수. 그 이상이면 거래소 트리거 시장가 주문을 제출합니다.
SHORT: EP > 표시가격 × 0.99이면 지정가, 그 이하이면 트리거 시장가입니다. TP/SL은 진입 주문에 연결해 거래소로 전달합니다.
지정가는 체결 가능한 가격이면 즉시 체결될 수 있습니다. 정확히 1% 경계값은 지정가 분기에 포함되지 않습니다.
100 USDT · 5배 · EP 60,000 / TP 66,000 / SL 54,000
https://bingx.vtalk.co.kr/okx/trigger/long/BTCUSDT/100/5/60000/66000/54000
GET trailing activation → EP · 서버 2단계 감시
/okx/trailing/{side}/{symbol}/{amount}/{leverage}/{activation}/{ep}/{tp}/{sl}
인자는 trigger와 같고, EP 앞에 감시 시작 가격 activation을 추가합니다. 거래소 기본 트레일링 주문은 아닙니다.
LONG: activation 이하 하락 → EP 스톱 시장가 주문 + TP/SL을 거래소에 제출 → EP 반등 시 진입
LONG: SL < activation < EP < TP · SHORT: TP < EP < activation < SL. SHORT는 activation 이상 상승 후 EP 하락을 기다립니다.
이 단계에서는 trigger의 1% 지정가 분기를 적용하지 않습니다. 진입 전에 SL을 먼저 통과하면 감시·미체결 진입 주문을 취소하고 통지합니다.
57,000 하락 → 60,000 반등 진입 · 100 USDT / 5배
https://bingx.vtalk.co.kr/okx/trailing/long/BTCUSDT/100/5/57000/60000/66000/54000
처리 규칙
trigger는 거래소 접수 후 서버의 추가 감시가 없습니다. trailing은 activation 및 진입 전 SL을 서버가 감시하므로 서버 실행이 필요합니다.
접수 성공은 체결 완료가 아닙니다. /order 접수는 HTTP 202와 ok: true, trailing 감시 등록은 HTTP 202와 status: success를 반환합니다. trigger는 HTTP 200과 status: success를 반환합니다.
5초 이내 동일 URL은 HTTP 200 / DUPLICATE_IGNORED로 무시하고 로그·Slack에 기록합니다. 실패는 사유를 기록·통지하며, ORDER_RESULT_UNKNOWN(HTTP 502)은 접수 여부 불명으로 자동 재전송하지 않습니다.
최소 주문금액·수량 및 잔고 조건 미달 시 주문을 거부합니다. X-Webhook-Event-Id는 선택적 로그 대조용 헤더입니다. 예시 URL을 호출하면 실제 주문이므로 복사만 제공합니다.
원화 현물 · 매수/매도
GET · 요청 본문 없음 · 실계좌
금액 입력은 만원: 10 = 100,000원 · 0.5 = 5,000원
amount와 금액형 quantity만 환산합니다. 가격은 원(KRW), 비율은 %, 레버리지는 1입니다. 기존 원 단위 URL은 더 이상 사용하지 않습니다.
GET order 시장가 진입·청산 · TP/SL 없음
/upbit/order/{type}/{symbol}/{quantity}/{current_price}
- symbol
- BTCKRW 또는 KRW-BTC · 원화 마켓만 지원
- long
- quantity 만원만큼 시장가 매수
- exitlong
- quantity 만원어치를 실제 업비트 현재가로 수량 환산해 시장가 매도
- exitlongratio
- 매도 가능 잔고의 비율 청산 · 50 = 50% · 100 = 전량 · 0 초과 100 이하 · % 기호 없이 입력
- current_price
- 원화 참고 가격 · 이격 기록용이며 주문 가격·수량 환산에는 사용하지 않음
10만원 시장가 매수
https://bingx.vtalk.co.kr/upbit/order/long/BTCKRW/10/100000000
5,000원어치 시장가 매도
https://bingx.vtalk.co.kr/upbit/order/exitlong/BTCKRW/0.5/100000000
매도 가능 잔고 50% 매도
https://bingx.vtalk.co.kr/upbit/order/exitlongratio/BTCKRW/50/100000000
숏은 지원하지 않습니다. 잔고 부족 시 매도 가능한 전량으로 줄여 처리하고 Slack으로 통지합니다. 주문에 잠긴 코인은 제외합니다.
GET trigger EP 진입 + TP/SL
/upbit/trigger/long/{symbol}/{amount}/1/{ep}/{tp}/{sl}
- amount / leverage
- 매수 금액(만원) / 1 고정
- ep / tp / sl
- 진입 / 익절 / 손절 절대 가격 · 원(KRW) · SL < EP < TP
LONG: EP < 최근 체결가 × 1.01이면 EP 지정가 매수. 그 이상이면 서버에서 EP 상승 도달을 감시한 뒤 시장가 매수합니다.
지정가는 체결 가능한 가격이면 즉시 체결될 수 있습니다. 정확히 1% 경계값은 지정가 분기에 포함되지 않습니다.
10만원 · EP 1억원 / TP 1억1천만원 / SL 9천만원
https://bingx.vtalk.co.kr/upbit/trigger/long/BTCKRW/10/1/100000000/110000000/90000000
GET trailing activation → EP · 서버 2단계 감시
/upbit/trailing/long/{symbol}/{amount}/1/{activation}/{ep}/{tp}/{sl}
인자는 trigger와 같고, EP 앞에 감시 시작 가격 activation을 추가합니다. 거래소 기본 트레일링 주문은 아닙니다.
LONG: activation 이하 하락 → EP 이상 반등 시 시장가 매수 → TP/SL 감시
LONG: SL < activation < EP < TP
이 단계에서는 trigger의 1% 지정가 분기를 적용하지 않습니다. 진입 전에 SL을 먼저 통과하면 감시·미체결 진입 주문을 취소하고 통지합니다.
9,500만원 하락 → 1억원 반등 → 10만원 매수
https://bingx.vtalk.co.kr/upbit/trailing/long/BTCKRW/10/1/95000000/100000000/110000000/90000000
처리 규칙
업비트 trigger·trailing의 EP·TP·SL은 서버가 감시합니다. 서버가 실행 중이어야 작동합니다.
TP/SL은 각 요청의 실제 매수 체결 수량에만 적용합니다. 같은 종목 여러 요청도 독립 관리합니다. 잔고 표시는 평가 가능한 약 2달러(2 USDT) 이상만 포함하지만 신규 매수·기존 주문 감시는 유지됩니다. 화면·저장된 주문 금액은 원 단위를 유지합니다.
접수 성공은 체결 완료가 아닙니다. /order 접수는 HTTP 202와 ok: true, trigger·trailing 감시 등록은 HTTP 202와 status: success를 반환합니다.
5초 이내 동일 URL은 HTTP 200 / DUPLICATE_IGNORED로 무시하고 로그·Slack에 기록합니다. 실패는 사유를 기록·통지하며, ORDER_RESULT_UNKNOWN(HTTP 502)은 접수 여부 불명으로 자동 재전송하지 않습니다.
최소 주문금액·수량 및 잔고 조건 미달 시 주문을 거부합니다. X-Webhook-Event-Id는 선택적 로그 대조용 헤더입니다. 예시 URL을 호출하면 실제 주문이므로 복사만 제공합니다.