명령줄로 거래하기
아래 거래 명령은 모두 먼저 권한 부여를 완료해야 합니다. 명령 결과는 기본적으로 한 줄 JSON으로 출력되며, --pretty를 붙이면 들여쓰기 형식으로 출력됩니다.
포지션을 보유하는 동안 펀딩 비율에 따라 펀딩비를 주고받으며, 증거금이 부족하면 포지션이 강제 청산됩니다. 규칙은 강제 청산 메커니즘을 참고하십시오.
시장과 가격 조회
섹션 제목: “시장과 가격 조회”SYMBOL은 심볼이며, 주문하거나 가격을 조회할 때--symbol에 이 열의 값을 입력합니다. 현재 JVBTC, JETH, SKHY, XAU, TQQQ, CL, CRCL, MU, NVDA, TSLA가 있습니다.MARGIN은 해당 시장의 증거금 자산이고,MAX_LEVERAGE는 최대 레버리지입니다.- 시장 목록은 CLI 버전과 함께 배포되므로, 새로 출시된 시장은
jv update로 업그레이드해야 표시됩니다. --json을 붙이면 JSON으로 출력합니다.
실시간 가격 조회:
price는 가격이고, priceWei는 10^18배로 확대한 정수입니다. --symbol에는 심볼을 입력해야 하며, BTC를 입력하면 가격을 찾지 못하고 명령이 종료 코드 2로 끝납니다.
포지션 오픈: jv order create
섹션 제목: “포지션 오픈: jv order create”| 파라미터 | 설명 |
|---|---|
--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 close는 포지션의 방향, 레버리지,margin(누적 투입 증거금)을 읽어 반대 방향 주문을 제출합니다. 축소한 적이 있는 포지션은 이 증거금이 포지션의 현재 증거금보다 크므로, 종료 후 반대 방향 포지션 오픈으로 처리될 수 있습니다. 이런 포지션은 웹에서 종료하는 것을 권장합니다.jv order close로 종료한 후에는jv orders list로 포지션이 종료되었고 새로 열린 반대 방향 포지션이 없는지 확인하십시오.--order-id와--all중 하나만 지정합니다.--all은 순서대로 하나씩 종료하며{"closed":[…],"failed":[…]}한 줄을 출력합니다. 하나라도 실패하면 종료 코드는 3입니다.
주문 번호는 jv orders list에 나오는 각 주문의 id입니다.
익절·손절
섹션 제목: “익절·손절”--side의 기본값은long입니다. 숏 포지션에는 반드시--side short를 붙여야 하며, 그렇지 않으면 CLI가 롱 포지션의 방향과 포지션 계정으로 서명합니다.- 트리거되면 포지션 전체를 종료하며, 반대 방향으로 오픈하지 않습니다.
- 기본 유효 기간은 24시간(
--ttl 86400)이며, 만료 전에 트리거되지 않으면 다시 설정해야 합니다. limitOrderId가 포함된 JSON 한 줄을 반환합니다. 익절·손절 주문은 지정가 주문과 마찬가지로jv limit-order로 조회하고 취소합니다.
Perpetual Protect(PP): PPO 파라미터
섹션 제목: “Perpetual Protect(PP): PPO 파라미터”CLI에서 Perpetual Protect(PP)는 PPO 옵션으로 구현됩니다. 롱 포지션에는 풋옵션(PUT), 숏 포지션에는 콜옵션(CALL)이 짝지어지며, 직접 선택할 필요가 없습니다. 개념과 수수료는 Perpetual Protect(PP)란 무엇입니까와 보호 기간, 범위 및 강도를 참고하십시오.
포지션 오픈 시 보호 함께 적용:
| 파라미터 | 값 | 기본값 |
|---|---|---|
--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는 먼저 프리미엄 견적을 받은 뒤 제출하며, 실행 결과를 최대 60초 동안 기다립니다. stdout에는 제출 응답과 실행 결과 두 줄이 출력됩니다.
주의:
- 기존 포지션에 보호를 추가할 때는
jv order protect를 사용하십시오.jv order create --ppo는 포지션 추가도 함께 합니다. - PPO가 있는 포지션을 추가하거나 축소할 때 이번에
--ppo를 붙이지 않으면 기존 PPO가 취소됩니다. 보호를 유지하려면 이번 작업에도--ppo를 붙여야 합니다. CLI에는 PPO만 따로 취소하는 명령이 없습니다. jv order close로 제출하는 종료 주문에는 PPO가 붙지 않습니다.
주문 조회
섹션 제목: “주문 조회”- 각 주문에는 원본 필드 외에 읽기 쉬운 필드가 추가됩니다:
margin(증거금),size(포지션 수량),entryPriceUsd(진입가),leverage(레버리지),createdTime(생성 시각). --since,--until은7d,1w,2h,2025-01-01같은 날짜나 Unix 타임스탬프를 받습니다. 페이지 지정에는--page와--limit을 사용합니다.--position-side는 현재 페이지 안에서만 필터링하며, 반환되는total에는 영향을 주지 않습니다.
지정가 주문과 익절·손절 주문:
상태에는 PENDING, TRIGGERED, EXECUTING, COMPLETED, FAILED, EXPIRED, CANCELLED가 있습니다.
시장가 주문의 실행 결과:
최대 60초 동안 기다리며, status는 completed, failed, timeout, not_found 중 하나입니다.