콘텐츠로 이동

명령줄로 거래하기

아래 거래 명령은 모두 먼저 권한 부여를 완료해야 합니다. 명령 결과는 기본적으로 한 줄 JSON으로 출력되며, --pretty를 붙이면 들여쓰기 형식으로 출력됩니다.

포지션을 보유하는 동안 펀딩 비율에 따라 펀딩비를 주고받으며, 증거금이 부족하면 포지션이 강제 청산됩니다. 규칙은 강제 청산 메커니즘을 참고하십시오.

jv market list
SYMBOL  PAIR                 MARGIN  MAX_LEVERAGE
JVBTC   BTC/USDC             JVUSD   100x
JETH    ETH/USDC             JVUSD   50x
…
  • SYMBOL은 심볼이며, 주문하거나 가격을 조회할 때 --symbol에 이 열의 값을 입력합니다. 현재 JVBTC, JETH, SKHY, XAU, TQQQ, CL, CRCL, MU, NVDA, TSLA가 있습니다.
  • MARGIN은 해당 시장의 증거금 자산이고, MAX_LEVERAGE는 최대 레버리지입니다.
  • 시장 목록은 CLI 버전과 함께 배포되므로, 새로 출시된 시장은 jv update로 업그레이드해야 표시됩니다.
  • --json을 붙이면 JSON으로 출력합니다.
{"environment":"beta","markets":[{"symbol":"JVBTC","pair":"BTC/USDC","marginAsset":"JVUSD","maxLeverage":100},{"symbol":"JETH","pair":"ETH/USDC","marginAsset":"JVUSD","maxLeverage":50},…]}

실시간 가격 조회:

jv price --symbol JVBTC
{"symbol":"JVBTC","price":"64073.95","priceWei":"64073950000000000000000","source":"quote_center","timestamp":"2026-11-18T12:08:06.954Z"}

price는 가격이고, priceWei는 10^18배로 확대한 정수입니다. --symbol에는 심볼을 입력해야 하며, BTC를 입력하면 가격을 찾지 못하고 명령이 종료 코드 2로 끝납니다.

# 시장가 롱 진입: 증거금 100, 레버리지 20배
jv order create --side long --symbol JVBTC -m 100 --leverage 20

# 지정가 숏 진입: 가격이 68000에 도달하면 발동, 2시간 동안 유효
jv order create --side short --symbol JVBTC -m 50 --leverage 10 --limit-price 68000 --ttl 7200
파라미터 설명
--side 방향, long 또는 short, 필수
--symbol 심볼, 필수
-m, --margin 증거금 수량, 필수. 단위는 해당 시장의 증거금 자산(jv market list의 MARGIN 열)
--leverage 레버리지. 입력하지 않으면 기본 50배이며, 해당 시장의 MAX_LEVERAGE를 넘지 않아야 합니다
--limit-price 지정가. 입력하지 않으면 시장가 주문
--ttl 주문 서명의 유효 기간(초), 기본값 3600. 지정가 주문은 유효 기간 안에 트리거되지 않으면 만료됩니다
--ppo 등 포지션 오픈 시 Perpetual Protect(PP)를 함께 적용, 아래 참고

명령은 stderr에 예상치를 한 줄 출력합니다. 예: Estimated: ~0.031214 JVBTC @ $64,073.95 (~$2,000 JVUSD total, 20x).

  • 시장가 주문: 제출 후 실행 결과를 최대 60초 동안 기다립니다. stdout에는 JSON 두 줄이 출력됩니다. 첫 번째 줄은 jobId가 포함된 제출 응답이고, 두 번째 줄은 실행 결과입니다. "status": "completed"는 이미 온체인에서 체결되었음을 뜻하며 transactionHash가 포함됩니다. 결과가 completed가 아니면 명령은 종료 코드 3으로 끝나지만, 주문이 체결되지 않았다고 단정할 수는 없습니다. 아래 ’결과가 불명확할 때’를 참고하십시오.
  • 지정가 주문: limitOrderId가 포함된 JSON 한 줄을 즉시 반환하며, 가격에 도달하면 자동으로 실행됩니다.

주문 계열 명령(jv order create, jv order close, jv order protect, jv tp set, jv sl set)에는 중복 제출 방지 장치가 없으므로, 같은 명령을 두 번 실행하면 주문이 두 건 생깁니다. 다음 경우에만 명확한 성공으로 봅니다.

  • 시장가 주문과 jv order protect의 실행 결과가 "status": "completed"인 경우
  • 지정가 주문, 익절·손절 주문이 limitOrderId를 반환한 경우
  • jv order close 출력의 failed가 비어 있는 경우

그 밖의 경우, 즉 종료 코드 2(요청 시간 초과 또는 네트워크 오류), "status": "timeout", "status": "failed"에서는 주문이 이미 접수되었거나 체결되었을 수도 있습니다. 다시 제출하기 전에 먼저 jv orders list와 jv limit-order list로 확인하십시오.

이미 포지션이 있을 때, 같은 심볼의 새 주문은 방향과 증거금에 따라 처리됩니다.

새 주문 결과
같은 방향 포지션 추가
반대 방향, 증거금이 포지션의 현재 증거금과 같음 전체 종료
반대 방향, 증거금이 포지션의 현재 증거금보다 큼 먼저 전체 종료한 뒤, 초과분으로 반대 방향의 새 포지션을 오픈합니다. 초과분이 너무 작으면 종료만 합니다
반대 방향, 증거금이 포지션의 현재 증거금보다 작음 이어서 포지션 수량(증거금 × 레버리지 ÷ 진입가)으로 비교합니다. 원래 포지션보다 작으면 포지션 축소이며, 남는 양이 너무 적으면 전체 종료합니다. 같으면 전체 종료하고, 크면 마찬가지로 먼저 종료한 뒤 반대 방향으로 오픈합니다

반대 방향으로 주문하기 전에 증거금과 레버리지를 정확히 계산하십시오. 그렇지 않으면 종료 후 반대 방향 포지션이 오픈될 수 있습니다.

  • 레버리지를 원래 포지션보다 높게 입력하면 증거금이 작더라도 포지션 수량이 원래 포지션을 넘을 수 있습니다. 포지션을 축소할 때는 --leverage에 원래 포지션의 레버리지(jv orders list의 leverage)를 입력해야 합니다.
  • jv orders list의 margin은 누적 투입 증거금입니다. 포지션을 추가하면 커지고, 축소해도 변하지 않습니다. 포지션을 축소한 후에는 이 값이 포지션의 현재 증거금보다 크므로, 축소나 종료에 쓸 증거금을 계산하는 데 그대로 사용할 수 없습니다. CLI로는 현재 포지션의 현재 증거금을 조회할 수 없으므로, 축소한 적이 있는 포지션은 웹에서 계속 축소하거나 종료하는 것을 권장합니다.

예를 들어 축소한 적이 없는 20배, 증거금 100의 JVBTC 롱 포지션을 절반 줄이려면 다음과 같이 합니다.

jv order create --side short --symbol JVBTC -m 50 --leverage 20

포지션 종료:

jv order close --order-id 42   # 주문 42 청산
jv order close --all           # 모든 포지션 청산
  • jv order close는 포지션의 방향, 레버리지, margin(누적 투입 증거금)을 읽어 반대 방향 주문을 제출합니다. 축소한 적이 있는 포지션은 이 증거금이 포지션의 현재 증거금보다 크므로, 종료 후 반대 방향 포지션 오픈으로 처리될 수 있습니다. 이런 포지션은 웹에서 종료하는 것을 권장합니다.
  • jv order close로 종료한 후에는 jv orders list로 포지션이 종료되었고 새로 열린 반대 방향 포지션이 없는지 확인하십시오.
  • --order-id와 --all 중 하나만 지정합니다. --all은 순서대로 하나씩 종료하며 {"closed":[…],"failed":[…]} 한 줄을 출력합니다. 하나라도 실패하면 종료 코드는 3입니다.

주문 번호는 jv orders list에 나오는 각 주문의 id입니다.

# 롱 주문 42: 익절 70000, 손절 60000
jv tp set --order-id 42 --price 70000 --symbol JVBTC
jv sl set --order-id 42 --price 60000 --symbol JVBTC

# 숏 주문 43: --side short 필수
jv tp set --order-id 43 --price 58000 --symbol JVBTC --side short
jv sl set --order-id 43 --price 66000 --symbol JVBTC --side short
  • --side의 기본값은 long입니다. 숏 포지션에는 반드시 --side short를 붙여야 하며, 그렇지 않으면 CLI가 롱 포지션의 방향과 포지션 계정으로 서명합니다.
  • 트리거되면 포지션 전체를 종료하며, 반대 방향으로 오픈하지 않습니다.
  • 기본 유효 기간은 24시간(--ttl 86400)이며, 만료 전에 트리거되지 않으면 다시 설정해야 합니다.
  • limitOrderId가 포함된 JSON 한 줄을 반환합니다. 익절·손절 주문은 지정가 주문과 마찬가지로 jv limit-order로 조회하고 취소합니다.

CLI에서 Perpetual Protect(PP)는 PPO 옵션으로 구현됩니다. 롱 포지션에는 풋옵션(PUT), 숏 포지션에는 콜옵션(CALL)이 짝지어지며, 직접 선택할 필요가 없습니다. 개념과 수수료는 Perpetual Protect(PP)란 무엇입니까와 보호 기간, 범위 및 강도를 참고하십시오.

포지션 오픈 시 보호 함께 적용:

jv order create --side long --symbol JVBTC -m 100 --leverage 20 --ppo
jv order create --side long --symbol JVBTC -m 100 --leverage 20 --ppo --ppo-expire 8h --ppo-category OTM --ppo-tier 3
파라미터 값 기본값
--ppo 보호 활성화 활성화하지 않음
--ppo-expire 30m 또는 8h 30m
--ppo-category ATM: 행사가가 현재가와 같음, OTM: 행사가가 현재가에서 벗어남 ATM
--ppo-tier 1부터 5까지, 단계마다 0.1%씩 벗어나며 5단계는 0.5% 벗어남 OTM 선택 시 필수, ATM 선택 시 무시

포지션 크기를 바꾸지 않고 기존 포지션에 보호만 별도로 추가:

jv order protect --order-id 42 --symbol JVBTC
jv order protect --order-id 42 --symbol JVBTC --ppo-expire 8h --ppo-category OTM --ppo-tier 2

jv order protect는 먼저 프리미엄 견적을 받은 뒤 제출하며, 실행 결과를 최대 60초 동안 기다립니다. stdout에는 제출 응답과 실행 결과 두 줄이 출력됩니다.

주의:

  • 기존 포지션에 보호를 추가할 때는 jv order protect를 사용하십시오. jv order create --ppo는 포지션 추가도 함께 합니다.
  • PPO가 있는 포지션을 추가하거나 축소할 때 이번에 --ppo를 붙이지 않으면 기존 PPO가 취소됩니다. 보호를 유지하려면 이번 작업에도 --ppo를 붙여야 합니다. CLI에는 PPO만 따로 취소하는 명령이 없습니다.
  • jv order close로 제출하는 종료 주문에는 PPO가 붙지 않습니다.
jv orders list                          # 현재 포지션(기본값은 미청산만, 페이지당 20건)
jv orders list --all --since 7d         # 최근 7일간의 모든 주문(청산된 것 포함)
jv orders list --position-side SHORT    # 숏만 보기
jv orders get 42                        # 단일 주문
jv orders stats                         # 전체 주문 수, 보유 중 및 청산된 수량
  • 각 주문에는 원본 필드 외에 읽기 쉬운 필드가 추가됩니다: margin(증거금), size(포지션 수량), entryPriceUsd(진입가), leverage(레버리지), createdTime(생성 시각).
  • --since, --until은 7d, 1w, 2h, 2025-01-01 같은 날짜나 Unix 타임스탬프를 받습니다. 페이지 지정에는 --page와 --limit을 사용합니다.
  • --position-side는 현재 페이지 안에서만 필터링하며, 반환되는 total에는 영향을 주지 않습니다.

지정가 주문과 익절·손절 주문:

jv wallet info                                          # 지갑 주소(eoa) 확인
jv limit-order list --wallet 0x내지갑주소 --status PENDING
jv limit-order status <limitOrderId>
jv limit-order cancel <limitOrderId>

상태에는 PENDING, TRIGGERED, EXECUTING, COMPLETED, FAILED, EXPIRED, CANCELLED가 있습니다.

시장가 주문의 실행 결과:

jv job status <jobId>

최대 60초 동안 기다리며, status는 completed, failed, timeout, not_found 중 하나입니다.