콘텐츠로 이동

명령어 빠른 참조

모든 명령에 --help를 붙이면 전체 파라미터를 볼 수 있고, jv --version으로 버전을 확인할 수 있습니다. 대부분의 명령은 --pretty로 들여쓰기 형식의 JSON을 출력할 수 있습니다. jv market list는 예외로, 기본적으로 표를 출력하며 --json만 지원합니다.

명령 기능
jv enable [--name <이름>] [--timeout <초>] 브라우저에서 권한을 부여하고 지갑 프로필을 생성하거나 갱신
jv wallet list 지갑 프로필 목록
jv wallet info 현재 지갑 프로필의 세부 정보
jv wallet switch [<이름>] 현재 지갑 프로필 전환
jv wallet rename <이전이름> <새이름> 이름 변경
jv wallet remove <이름> 지갑 프로필 삭제(현재 사용 중인 프로필은 삭제 불가)
명령 기능
jv market list [--json] 거래 가능한 시장: 심볼, 거래쌍, 증거금 자산, 최대 레버리지
jv price --symbol <심볼> 실시간 가격
명령 기능
jv order create --side <방향> --symbol <심볼> -m <증거금> [--leverage <배수>] [--limit-price <가격>] [--ttl <초>] [PPO 옵션] 시장가 주문 또는 지정가 주문. 이미 포지션이 있을 때 같은 방향이면 포지션 추가입니다. 반대 방향이면 증거금이 포지션의 현재 증거금과 같을 때 전체 종료, 클 때는 먼저 종료한 뒤 반대 방향으로 오픈합니다. 자세한 내용은 명령줄로 거래하기를 참고하십시오
jv order close --order-id <주문번호> 포지션 하나를 종료합니다. 축소한 적이 있는 포지션은 종료 후 반대 방향 오픈으로 처리될 수 있으므로, 종료 후 jv orders list로 확인하십시오
jv order close --all 모든 포지션 종료
jv order protect --order-id <주문번호> --symbol <심볼> [PPO 옵션] 포지션 크기를 바꾸지 않고 기존 포지션에 PPO 추가
jv tp set --order-id <주문번호> --price <가격> --symbol <심볼> [--side short] [--ttl <초>] 익절
jv sl set --order-id <주문번호> --price <가격> --symbol <심볼> [--side short] [--ttl <초>] 손절

<방향>에는 long 또는 short를 입력합니다. PPO 파라미터: --ppo, --ppo-expire(30m, 8h), --ppo-category(ATM, OTM), --ppo-tier(1부터 5까지). jv order protect에는 --ppo가 필요 없으며, 나머지 세 파라미터는 그대로 사용합니다.

명령 기능
jv orders list [--all] [--position-side LONG] [--since 7d] [--until <시간>] [--page <페이지>] [--limit <건수>] 포지션 및 과거 주문
jv orders get <주문번호> 단일 주문
jv orders stats 전체 주문 수, 보유 중 및 종료된 주문 수
jv limit-order list --wallet <지갑주소> [--status <상태>] 지정가 주문 및 익절·손절 주문
jv limit-order status <limitOrderId> 단일 지정가 주문 상태
jv limit-order cancel <limitOrderId> 지정가 주문 또는 익절·손절 주문 취소
jv job status <jobId> 시장가 주문 실행 결과
명령 기능
jv deposit --token usdc --amount <수량> [--timeout <초>] [--no-wait] Base에서 입금: 명령이 제공하는 웹 페이지를 열어 지갑으로 서명
jv withdraw --token usdc --amount <수량> [--timeout <초>] Base로 출금: 명령이 제공하는 웹 페이지를 열어 지갑으로 서명
명령 기능
jv install [--ai <플랫폼>] [--global] [--force] 스킬과 MCP 설정 설치. <플랫폼>에는 claude, cursor 또는 openclaw를 입력하며, 입력하지 않으면 세 가지 모두 설치
jv uninstall --ai <플랫폼> [--global] 제거. <플랫폼>에는 all도 입력할 수 있음
jv mcp stdio 모드로 MCP 서버 시작
jv update [--force] 최신 버전으로 업그레이드
항목 기본값
레버리지 50배
주문 유효 기간(--ttl) 3600초
익절·손절 유효 기간(--ttl) 86400초
PPO 기간 30m
PPO 유형 ATM
권한 부여, 입금, 출금 대기 시간(--timeout) 900초
시장가 주문 실행 결과 대기 60초
단일 HTTP 요청 시간 초과 30초
변수 설명
BASE_HTTP_RPC_URL Base 메인넷 RPC 주소. jv enable과 jv withdraw에 필수
JV_TIMEOUT 선택 사항. 단일 HTTP 요청의 시간 초과(밀리초)

로컬 파일의 위치는 jv CLI 설치를 참고하십시오.

오류 메시지 또는 현상 원인 해결 방법
Delegation key not found 현재 지갑 프로필이 아직 권한 부여되지 않음 jv enable 실행
No vault profile for environment beta 아직 권한 부여를 하지 않았거나, 현재 선택된 지갑 프로필이 잘못됨 jv wallet list로 확인하고 jv wallet switch로 전환하거나 jv enable 실행
BASE_HTTP_RPC_URL 누락 안내 jv enable 또는 jv withdraw 실행 시 이 변수를 설정하지 않음 설정 후 다시 시도
Token … not found for environment beta --symbol이 거래 가능한 심볼이 아님 jv market list의 SYMBOL 열 값을 입력
Failed to fetch price … HTTP 404 jv price에 BTC 같은 코드를 입력함 JVBTC 같은 심볼을 입력
--side must be long or short 방향을 잘못 입력함 long 또는 short 입력
OTM requires --ppo-tier (1-5) OTM을 선택했지만 단계를 지정하지 않음 --ppo-tier 추가
--ppo-expire must be 30m or 8h 기간 값이 잘못됨 30m 또는 8h만 입력 가능
Specify exactly one of --order-id or --all jv order close에 두 파라미터를 모두 지정했거나 둘 다 지정하지 않음 둘 중 하나만 지정
Order … not found in Subgraph, Order … is not active 주문 번호가 잘못되었거나 포지션이 이미 종료됨 jv orders list로 현재 포지션 확인
이전에 되던 명령에서 권한 부여 오류가 나기 시작함(예: deadline expired 포함) 권한 부여가 만료됨 jv enable 다시 실행
주문 계열 명령이 "status": "timeout"(오류 Client timeout after 60 seconds) 또는 "status": "failed"를 반환 60초 안에 결과를 받지 못했거나 CLI가 결과를 조회하는 중 오류가 발생함. 주문이 이미 접수되었거나 체결되었을 수 있음 먼저 jv orders list, jv limit-order list로 확인한 뒤 다시 주문할지 결정
"success": false 출력, message에 expired 포함 권한 부여, 입금 또는 출금 페이지를 제한 시간 안에 완료하지 않음 명령 다시 실행
"arrived": false 입금이 아직 크로스체인 이동 중 몇 분 후 웹에서 잔액 확인
Skill already exists at … jv install의 대상 위치에 이미 스킬이 있음 --force를 붙여 덮어쓰기
Request timed out after 30000ms 또는 기타 네트워크 오류(종료 코드 2) 네트워크나 서비스 응답이 느림. 주문 요청이 이미 접수되었을 수 있음 주문 계열 명령은 먼저 jv orders list, jv limit-order list로 확인한 뒤 다시 주문하고, 조회 계열 명령은 바로 다시 시도하거나 JV_TIMEOUT을 늘림