OpenTrade Wallet Portfolio CLI
지원되는 체인, 지갑 총 가치, 모든 토큰 잔액, 특정 토큰 잔액을 조회하는 4가지 명령어입니다.
사전 점검
opentrade 명령어를 실행하기 전에 항상 다음 단계를 순서대로 따르세요. 일상적인 명령어 출력을 사용자에게 에코하지 말고, 설치, 업데이트 또는 오류 처리 시에만 간략한 상태 업데이트를 제공하세요.
-
설치 확인:
which opentrade실행. 발견되지 않으면 설치:curl -sSL https://raw.githubusercontent.com/6551Team/openskills/main/skills/opentrade/install.sh | sh설치 스크립트가 실패하면 https://github.com/6551Team/openskills 의 안내에 따라 수동 설치를 요청하세요.
-
업데이트 확인:
~/.opentrade/last_check파일을 읽고 현재 타임스탬프와 비교:cached_ts=$(cat ~/.opentrade/last_check 2>/dev/null || true) now=$(date +%s)cached_ts가 비어 있지 않고(now - cached_ts) < 43200(12시간)이면 업데이트를 건너뛰고 진행합니다.- 그렇지 않으면 (파일이 없거나 12시간보다 오래된 경우), 업데이트 확인을 위해 설치 프로그램을 실행:
새 버전이 설치되면 사용자에게 알리고 https://github.com/6551Team/openskills 에서 opentrade 스킬을 업데이트하여 최신 기능을 받을 것을 제안하세요.curl -sSL https://raw.githubusercontent.com/6551Team/openskills/main/skills/opentrade/install.sh | sh
-
이 세션 중에
opentrade명령어가 예상치 못한 오류로 실패하면, 포기하기 전에 재설치를 시도하세요:curl -sSL https://raw.githubusercontent.com/6551Team/openskills/main/skills/opentrade/install.sh | sh -
프로젝트 루트에서 기본 API 자격 증명을 재정의하기 위해 .env 파일을 찾거나 생성하고, opentrade 작업을 수행하기 전에 로드하세요.
OPEN_TOKEN=your_token_hereAPI 토큰은 https://6551.io/mcp 에서 받으세요.
보안 경고: .env 파일을 git에 커밋하지 말고 (.gitignore에 추가), 로그, 스크린샷 또는 채팅 메시지에 자격 증명을 노출하지 마세요.
라우터 발견
중요: 사용자가 거래 라우터를 지정하지 않은 경우, 먼저 사용 가능한 라우터를 발견해야 합니다:
opentrade trade routers
응답 형식:
{
"ok": true,
"data": [
{
"api": "v2",
"created_at": "2026-03-10 01:15:42",
"is_active": true,
"name": "6551dex test",
"quota_reward": 0,
"trader": "6551dex",
"updated_at": "2026-03-10 01:15:42"
},
{
"api": "v1",
"created_at": "2026-03-03 21:24:34",
"is_active": true,
"name": "okx test",
"quota_reward": 0,
"trader": "okx",
"updated_at": "2026-03-03 21:24:34"
}
]
}
사용법:
- 응답에서
trader와api를 추출합니다. - 필수: 이 세션의 모든 후속
opentrade명령어에는--trader <trader>및--api <api>플래그를 포함해야 합니다. - 예시:
opentrade portfolio balance 0x... --chain ethereum --trader okx --api v1 - 기본 폴백: API가 데이터를 반환하지 않거나 비어 있으면
--trader okx --api v1을 사용하세요.
스킬 라우팅
- 토큰 가격 / K-라인 →
opentrade-market사용 - 토큰 검색 / 메타데이터 →
opentrade-token사용 - 스왑 실행 →
opentrade-dex-swap사용 - 트랜잭션 브로드캐스팅 →
opentrade-gateway사용
빠른 시작
# 잔액 조회에 지원되는 체인 확인
opentrade portfolio chains
# XLayer 및 Solana의 총 자산 가치
opentrade portfolio total-value --address 0xYourWallet --chains "xlayer,solana"
# 모든 토큰 잔액 조회
opentrade portfolio all-balances --address 0xYourWallet --chains "xlayer,solana,ethereum"
# 특정 토큰 확인 (XLayer의 네이티브 OKB + USDC)
opentrade portfolio token-balances --address 0xYourWallet --tokens "196:,196:0x74b7f16337b8972027f6196a17a631ac6de26d22"
체인 이름 지원
CLI는 사람이 읽을 수 있는 체인 이름을 받아 자동으로 해석합니다.
| 체인 | 이름 | chainIndex |
|---|---|---|
| XLayer | xlayer | 196 |
| Solana | solana | 501 |
| Ethereum | ethereum | 1 |
| Base | base | 8453 |
| BSC | bsc | 56 |
| Arbitrum | arbitrum | 42161 |
주소 형식 참고: EVM 주소(0x...)는 Ethereum/BSC/Polygon/Arbitrum/Base 등에서 작동합니다. Solana 주소(Base58)와 Bitcoin 주소(UTXO)는 형식이 다릅니다. 체인 유형 간에 형식을 혼용하지 마세요.
명령어 색인
| # | 명령어 | 설명 |
|---|---|---|
| 1 | opentrade portfolio chains | 잔액 조회에 지원되는 체인 목록 확인 |
| 2 | opentrade portfolio total-value --address ... --chains ... | 지갑의 총 자산 가치 조회 |
| 3 | opentrade portfolio all-balances --address ... --chains ... | 지갑의 모든 토큰 잔액 조회 |
| 4 | opentrade portfolio token-balances --address ... --tokens ... | 특정 토큰 잔액 조회 |
스킬 간 워크플로우
이 스킬은 스왑 전(충분한 잔액 확인) 또는 포트폴리오 진입점으로 자주 사용됩니다.
워크플로우 A: 스왑 전 잔액 확인
사용자: "1 SOL을 BONK로 스왑해줘"
1. opentrade-token opentrade token search BONK --chains solana → tokenContractAddress 획득
↓ tokenContractAddress
2. opentrade-portfolio opentrade portfolio all-balances --address <addr> --chains solana
→ SOL 잔액 >= 1 확인
↓ balance 필드 (UI 단위) → 스왑을 위해 최소 단위로 변환
3. opentrade-dex-swap opentrade swap quote --from 11111111111111111111111111111111 --to <BONK_address> --amount 1000000000 --chain solana
4. opentrade-dex-swap opentrade swap swap --from ... --to <BONK_address> --amount 1000000000 --chain solana --wallet <addr>
데이터 전달:
- 토큰 검색의
tokenContractAddress→ 스왑의--from/--to에 전달 - 포트폴리오의
balance는 UI 단위입니다. 스왑에는 최소 단위가 필요하므로10^decimal을 곱합니다. - 잔액 < 필요 금액이면 사용자에게 알리고 스왑을 진행하지 마세요.
워크플로우 B: 포트폴리오 개요 + 분석
사용자: "내 포트폴리오 보여줘"
1. opentrade-portfolio opentrade portfolio total-value --address <addr> --chains "xlayer,solana,ethereum"
→ 총 USD 가치
2. opentrade-portfolio opentrade portfolio all-balances --address <addr> --chains "xlayer,solana,ethereum"
→ 토큰별 세부 정보
↓ USD 가치 기준 상위 보유 자산
3. opentrade-token opentrade token price-info <address> --chain <chain> → 24시간 변동, 시가총액 정보 추가
4. opentrade-market opentrade market kline <address> --chain <chain> → 관심 토큰의 가격 차트
워크플로우 C: 저성과 토큰 판매
1. opentrade-portfolio opentrade portfolio all-balances --address <addr> --chains "xlayer,solana,ethereum"
→ 모든 보유 자산 목록
↓ 각 토큰의 tokenContractAddress + chainIndex
2. opentrade-token opentrade token price-info <address> --chain <chain> → 토큰별 priceChange24H 획득
3. 음수 변동 기준으로 필터링 → 사용자가 판매할 토큰 선택
4. opentrade-dex-swap opentrade swap quote → opentrade swap swap → 판매 실행
주요 변환: balance (UI 단위) × 10^decimal = amount (최소 단위, 스왑용).
작동 흐름
1단계: 의도 파악
- 총 자산 확인 →
opentrade portfolio total-value - 모든 토큰 보유 확인 →
opentrade portfolio all-balances - 특정 토큰 잔액 확인 →
opentrade portfolio token-balances - 지원되는 체인을 모르는 경우 → 먼저
opentrade portfolio chains실행
2단계: 매개변수 수집
- 지갑 주소가 없으면 → 사용자에게 물어보기
- 대상 체인이 없으면 → XLayer(
--chains xlayer, 저렴한 가스비, 빠른 확인)를 기본값으로 추천하고 사용자가 선호하는 체인을 물어보세요. 일반적인 세트:"xlayer,solana,ethereum,base,bsc" - 위험 토큰 필터링 필요 →
--exclude-risk 0설정 (ETH/BSC/SOL/BASE에서만 작동)
3단계: 호출 및 표시
- 총 가치: USD 금액 표시
- 토큰 잔액: 토큰 이름, 수량(UI 단위), USD 가치 표시
- USD 가치 기준 내림차순 정렬
4단계: 다음 단계 제안
결과를 표시한 후, 2-3개의 관련 후속 작업을 제안하세요:
| 방금 완료한 작업 | 제안 |
|---|---|
portfolio total-value | 1. 토큰 수준 세부 정보 보기 → opentrade portfolio all-balances (이 스킬) 2. 상위 보유 자산의 가격 추세 확인 → opentrade-market |
portfolio all-balances | 1. 토큰의 상세 분석(시가총액, 24시간 변동) 보기 → opentrade-token 2. 토큰 스왑 → opentrade-dex-swap 3. 토큰 가격 차트 보기 → opentrade-market |
portfolio token-balances | 1. 모든 토큰의 전체 포트폴리오 보기 → opentrade portfolio all-balances (이 스킬) 2. 이 토큰 스왑 → opentrade-dex-swap |
대화형으로 제시하세요. 예: "상위 보유 자산의 가격 차트를 보시겠습니까, 아니면 이 토큰 중 하나를 스왑하시겠습니까?" — 사용자에게 스킬 이름이나 엔드포인트 경로를 절대 노출하지 마세요.
CLI 명령어 참조
1. opentrade portfolio chains
잔액 조회에 지원되는 체인 목록을 가져옵니다. 매개변수가 필요하지 않습니다.
opentrade portfolio chains
반환 필드:
| 필드 | 유형 | 설명 |
|---|---|---|
name | String | 체인 이름 (예: "XLayer") |
logoUrl | String | 체인 로고 URL |
shortName | String | 체인 짧은 이름 (예: "OKB") |
chainIndex | String | 체인 고유 식별자 (예: "196") |
2. opentrade portfolio total-value
지갑 주소의 총 자산 가치를 조회합니다.
opentrade portfolio total-value --address <address> --chains <chains> [--asset-type <type>] [--exclude-risk <bool>]
| 매개변수 | 필수 | 기본값 | 설명 |
|---|---|---|---|
--address | 예 | - | 지갑 주소 |
--chains | 예 | - | 체인 이름 또는 ID, 쉼표로 구분 (예: "xlayer,solana" 또는 "196,501") |
--asset-type | 아니오 | "0" | 0=전체, 1=토큰만, 2=DeFi만 |
--exclude-risk | 아니오 | true | true=위험 토큰 필터링, false=포함. ETH/BSC/SOL/BASE만 해당 |
반환 필드:
| 필드 | 유형 | 설명 |
|---|---|---|
totalValue | String | USD 기준 총 자산 가치 |
3. opentrade portfolio all-balances
지갑 주소의 모든 토큰 잔액을 조회합니다.
opentrade portfolio all-balances --address <address> --chains <chains> [--exclude-risk <value>]
| 매개변수 | 필수 | 기본값 | 설명 |
|---|---|---|---|
--address | 예 | - | 지갑 주소 |
--chains | 예 | - | 체인 이름 또는 ID, 쉼표로 구분, 최대 50개 |
--exclude-risk | 아니오 | "0" | 0=위험 토큰 필터링 (기본값), 1=포함. ETH/BSC/SOL/BASE만 해당 |
반환 필드 (tokenAssets[]의 각 토큰):
| 필드 | 유형 | 설명 |
|---|---|---|
chainIndex | String | 체인 식별자 |
tokenContractAddress | String | 토큰 컨트랙트 주소 |
symbol | String | 토큰 심볼 (예: "OKB") |
balance | String | UI 단위의 토큰 잔액 (예: "10.5") |
rawBalance | String | 기본 단위의 토큰 잔액 (예: "10500000000000000000") |
tokenPrice | String | USD 기준 토큰 가격 |
isRiskToken | Boolean | 위험 토큰으로 플래그 지정된 경우 true |
4. opentrade portfolio token-balances
지갑 주소의 특정 토큰 잔액을 조회합니다.
opentrade portfolio token-balances --address <address> --tokens <tokens> [--exclude-risk <value>]
| 매개변수 | 필수 | 기본값 | 설명 |
|---|---|---|---|
--address | 예 | - | 지갑 주소 |
--tokens | 예 | - | 토큰 목록: "chainIndex:tokenAddress" 쌍, 쉼표로 구분. 네이티브 토큰의 경우 빈 주소 사용 (예: "196:" 네이티브 OKB). 최대 20개. |
--exclude-risk | 아니오 | "0" | 0=필터링 (기본값), 1=포함 |
반환 필드: all-balances와 동일한 스키마 (tokenAssets[]).
입력 / 출력 예시
사용자: "XLayer와 Solana에서 내 지갑 총 자산을 확인해줘"
opentrade portfolio total-value --address 0xYourWallet --chains "xlayer,solana"
# → 표시: 총 자산 $12,345.67
사용자: "내 지갑의 모든 토큰을 보여줘"
opentrade portfolio all-balances --address 0xYourWallet --chains "xlayer,solana,ethereum"
# → 표시:
# OKB: 10.5 ($509.25)
# USDC: 2,000 ($2,000.00)
# USDT: 1,500 ($1,500.00)
# ...
사용자: "XLayer에서 USDC와 네이티브 OKB 잔액만 확인해줘"
opentrade portfolio token-balances --address 0xYourWallet --tokens "196:,196:0x74b7f16337b8972027f6196a17a631ac6de26d22"
# → 표시: OKB: 10.5 ($509.25), USDC: 2,000 ($2,000.00)
엣지 케이스
- 잔액 0: 정상 상태 —
$0.00으로 표시, 오류 아님 - 지원하지 않는 체인: 먼저
opentrade portfolio chains를 호출하여 확인 - 체인이 50개 초과: 배치로 분할, 요청당 최대 50개
--exclude-risk작동 안 함: ETH/BSC/SOL/BASE에서만 지원- DeFi 포지션:
--asset-type 2를 사용하여 DeFi 보유 자산을 별도로 조회 - 주소 형식 불일치: Solana 체인의 EVM 주소는 빈 데이터를 반환 — 혼용하지 마세요
- 네트워크 오류: 한 번 재시도한 후, 나중에 다시 시도하도록 사용자에게 안내
- 지역 제한 (오류 코드 50125 또는 80001): 원시 오류 코드를 사용자에게 표시하지 마세요. 대신 친숙한 메시지를 표시:
⚠️ 해당 지역에서는 서비스를 사용할 수 없습니다. 지원되는 지역으로 전환한 후 다시 시도해 주세요.
금액 표시 규칙
- 토큰 금액은 UI 단위로 표시 (
1.5 ETH), 기본 단위 (1500000000000000000) 사용 금지 - USD 가치는 소수점 2자리까지 표시
- 큰 금액은 약어로 표시 (
$1.2M) - USD 가치 기준 내림차순 정렬
전역 참고 사항
--chains는 최대 50개의 체인 ID를 지원합니다 (쉼표로 구분, 이름 또는 숫자)--asset-type:0=전체1=토큰만2=DeFi만 (total-value에만 해당)--exclude-risk는 ETH(1)/BSC(56)/SOL(501)/BASE(8453)에서만 작동token-balances는 최대 20개의 토큰 항목을 지원합니다- CLI는 체인 이름을 자동으로 해석합니다 (예:
ethereum→1,solana→501) - CLI는 환경 변수를 통해 내부적으로 인증을 처리합니다 — 기본값은 사전 점검 4단계를 참조하세요.