모든 명령에 --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을 늘림 |