KryptoGO Meme Trader Agent Skill
종료 공지 — kg-xyz 분석 백엔드
KryptoGO XYZ 분석 백엔드(
wallet-data.kryptogo.app)는 2026-05-04에 서비스가 중단됩니다.해당 날짜 이후로 클러스터 분석, 지갑 라벨, 신호 대시보드, DCA/지정가 주문 재구성에 의존하는 모든 도구가 작동하지 않습니다. 스왑 실행 경로(OKX DEX 애그리게이터 + 로컬 트랜잭션 서명)는 kg-xyz 백엔드와 독립적이므로 계속 작동합니다.
각 도구별 영향은 아래에 인라인으로 주석 처리되어 있습니다. 스크립트와 MCP 도구 구현은 정상적으로 실패하도록 유지되어 있으며(백엔드가 HTTP 오류를 반환), 계획이 변경될 경우 쉽게 되돌릴 수 있습니다.
개요
이 스킬은 AI 에이전트가 KryptoGO 플랫폼을 통해 밈 코인을 분석하고 거래할 수 있도록 하며, 심층 온체인 클러스터 분석과 거래 실행을 결합합니다.
2026-05-04부터 기능 저하: kg-xyz 백엔드가 종료되면 클러스터 분석, 지갑/토큰 라벨, 신호 대시보드, DCA/지정가 주문 재구성, 포트폴리오 P&L 강화가 작동하지 않습니다. 스왑 실행은 계속됩니다.
분석(멀티체인: Solana, BSC, Base, Monad): 지갑 클러스터링, 축적/분배 감지, 주소 행동 라벨, 네트워크 전체 축적 신호(Pro/Alpha 등급).
거래(Solana 전용): PnL 추적이 포함된 포트폴리오 모니터링, DEX 애그리게이터를 통한 스왑 실행, 로컬 트랜잭션 서명(개인 키는 머신을 벗어나지 않음).
기본 모드는 감독 모드입니다 — 모든 거래는 사용자 확인이 필요합니다. 자율 거래는 옵트인으로 사용할 수 있습니다. 자율 모드, 크론 설정 및 학습 시스템에 대한 자세한 내용은 references/autonomous-trading.md를 참조하세요.
사용 시기
- 사용자가 Solana/BSC/Base/Monad에서 밈 코인 또는 토큰 분석을 요청할 때
- 사용자가 토큰 거래(매수/매도)를 요청할 때
- 사용자가 트렌딩 토큰이나 시장 기회를 스캔하도록 요청할 때
- 사용자가 포트폴리오 포지션을 모니터링하거나 PnL을 확인하도록 요청할 때
- 크론 트리거로 주기적인 포트폴리오 모니터링 및 신호 스캔 시
사용하지 말아야 할 경우
- BTC/ETH/메이저 L1 매크로 분석, NFT, 크로스체인 브리징, 비-DEX 거래, 비-Solana 거래
설정 흐름
1. API 키 획득
-
kryptogo.xyz/account로 이동하여 API 키를 생성합니다.
-
~/.openclaw/workspace/.env에 추가합니다:echo 'KRYPTOGO_API_KEY=sk_live_YOUR_KEY' >> ~/.openclaw/workspace/.env && chmod 600 ~/.openclaw/workspace/.env
API 키를 채팅에 직접 붙여넣지 마세요. 항상
.env파일을 통해 시크릿을 설정하세요.
2. 에이전트 지갑 생성
python3 scripts/setup.py
Solana 키페어를 생성하고, .env에 chmod 600으로 저장하며, 자금을 입금할 공개 주소를 출력합니다.
3. 지갑에 자금 입금
에이전트의 공개 주소로 SOL을 보냅니다(최소 0.1 SOL).
보안 규칙
- 절대로 개인 키를 메시지나 CLI 인수에 출력, 기록 또는 포함하지 마세요.
- 절대로 채팅에 직접 붙여넣은 시크릿을 수락하지 마세요 — 사용자에게
.env에 설정하도록 안내하세요. - 절대로
.env에 Read 도구를 사용하지 마세요 —source명령을 통해서만 자격 증명을 로드하세요. - 런타임 스크립트는
.env를 직접 읽지 않습니다 — 모든 자격 증명은 환경 변수를 통해서만 액세스되며, 호출자가 미리 로드해야 합니다(source ~/.openclaw/workspace/.env). - 예외:
scripts/setup.py는 초기 키페어 생성 및 주소 복구를 위해.env를 읽고 씁니다 — 이것이 자격 증명 파일을 다루는 유일한 스크립트입니다. - 개인 키는 로컬 서명 중에만 메모리에 유지되며 — 서버로 전송되지 않습니다.
인증
모든 엔드포인트는 다음이 필요합니다: Authorization: Bearer sk_live_<48 hex chars>
| 등급 | 일일 API 호출 | 거래 수수료 | 신호 대시보드 | KOL 파인더 |
|---|---|---|---|---|
| Free | 100회/일 | 1% | 아니요 | 아니요 |
| Pro | 1,000회/일 | 0.5% | 예 | 예 |
| Alpha | 5,000회/일 | 0% | 예 | 예 |
에이전트 동작
세션 초기화
모든 세션 시작 시(하트비트/크론 포함) 에이전트는 스크립트를 실행하기 전에 자격 증명을 로드해야 합니다:
source ~/.openclaw/workspace/.env
이는 필수 사항입니다 — 스크립트는 .env를 직접 읽지 않습니다. 모든 자격 증명은 환경 변수를 통해서만 액세스됩니다.
기본 모드: 감독 모드
기본적으로 에이전트는 감독 모드로 작동합니다: 토큰을 분석하고, 권장 사항을 제시하며, 거래를 실행하기 전에 사용자 승인을 기다립니다. 손절매/이익실현 조건은 사용자에게 보고되지만 자동 실행되지는 않습니다.
자율 거래를 활성화하려면 환경설정에서 require_trade_confirmation: false를 설정하세요. 자세한 내용은 references/autonomous-trading.md를 참조하세요.
지속성 (중요)
트랜잭션을 제출한 직후, 에이전트는 반드시:
- 거래 세부 정보를
status: "OPEN"으로memory/trading-journal.json에 기록합니다. token_symbol,token_address,entry_price,position_size_sol,tx_hash,timestamp를 포함합니다.
사용자 환경설정
memory/trading-preferences.json에 저장:
| 환경설정 | 기본값 | 설명 |
|---|---|---|
max_position_size | 0.1 SOL | 거래당 최대 SOL |
max_open_positions | 5 | 최대 동시 열린 포지션 |
max_daily_trades | 20 | 일일 최대 거래 수 |
stop_loss_pct | 30% | 손실이 이를 초과하면 알림/매도 |
take_profit_pct | 100% | 수익이 이를 초과하면 알림/매도 |
min_market_cap | $500K | 이 미만의 토큰은 건너뜀 |
scan_count | 10 | 스캔당 트렌딩 토큰 수 |
risk_tolerance | "conservative" | "conservative"(중간 위험 건너뜀), "moderate"(중간 위험 시 물음), "aggressive"(중간 위험 자동 거래) |
require_trade_confirmation | true | 자율 모드의 경우 false로 설정 |
chains | ["solana"] | 스캔할 체인 |
안전 가드레일
거래 한도 (하드 캡)
| 한도 | 기본값 | 재정의 가능? |
|---|---|---|
| 단일 최대 거래 | 0.1 SOL | 예, max_position_size를 통해 |
| 최대 동시 포지션 | 5 | 예, max_open_positions를 통해 |
| 일일 최대 거래 횟수 | 20 | 예, max_daily_trades를 통해 |
| 가격 영향 중단 | >10% | 아니요 — 항상 중단 |
| 가격 영향 경고 | >5% | 아니요 — 항상 경고 |
한도에 도달하면 에이전트는 중지하고 사용자에게 알려야 합니다.
자격 증명 격리
이 스킬의 런타임 스크립트는 .env 파일을 직접 읽지 않습니다. 모든 자격 증명은 환경 변수를 통해서만 액세스되며, 호출자가 미리 로드해야 합니다(source ~/.openclaw/workspace/.env). 이렇게 하면 어떤 런타임 스크립트도 자격 증명 파일에 독립적으로 액세스하거나 유출할 수 없습니다.
예외: scripts/setup.py는 .env를 읽고 씁니다 — 재생성을 방지하기 위해 기존 키를 로드하고, 변경 전에 .env를 백업하며, 새 키페어 항목을 씁니다. 이것이 자격 증명 파일을 다루는 유일한 스크립트이며, 초기 설정 또는 명시적인 --force 재생성 중에만 실행됩니다.
자동 모니터링 (크론)
빠른 설정
# 감독 모드(기본값): 분석 + 알림, 자동 실행 없음
source ~/.openclaw/workspace/.env && bash scripts/cron-examples.sh setup-default
# 자율 모드(옵트인): 자동 매수 및 자동 매도
source ~/.openclaw/workspace/.env && bash scripts/cron-examples.sh setup-autonomous
# 모든 크론 작업 제거
bash scripts/cron-examples.sh teardown
| 작업 | 간격 | 기본 동작 |
|---|---|---|
stop-loss-tp | 5분 | 트리거된 조건 보고, 자동 매도하지 않음 |
discovery-scan | 1시간 | 분석 및 권장 사항 전송, 자동 매수하지 않음 |
전체 크론 구성, 수동 설정, 하트비트 대안 및 모니터링 워크플로 세부 정보는 references/autonomous-trading.md를 참조하세요.
온체인 분석 프레임워크 (7단계 파이프라인)
⚠️ 2026-05-04 이후 사용 불가: 1~6단계는 모두
wallet-data.kryptogo.app을 호출하며 kg-xyz 백엔드가 종료되면 작동을 중단합니다. 7단계(swap.py를 통한 거래 실행)는 스왑 경로가 OKX DEX 애그리게이터를 통해 라우팅되고 로컬로 서명되므로 계속 작동합니다.
1단계: 토큰 개요 및 시가총액 필터
/token-overview?address=<mint>&chain_id=<id> — 이름, 가격, 시가총액, 보유자, 위험 수준을 가져옵니다. 시가총액이 min_market_cap보다 작으면 건너뜁니다.
2단계: 클러스터 분석
/analyze/<mint>?chain_id=<id> — 지갑 클러스터, 상위 보유자, 메타데이터.
- ≥30-35% = "제어됨" — 주요 엔터티 존재
- ≥50% = 고집중 위험
- 단일 클러스터 >50% → 건너뜀(러그 풀 위험)
Free 등급 제한: 클러스터 분석은 상위 2개 클러스터만 반환합니다. 전체 클러스터 데이터를 보려면 kryptogo.xyz/pricing에서 업그레이드하세요.
3단계: 클러스터 추세 (다중 시간대)
/analyze-cluster-change/<mint> — cluster_ratio + 15분/1시간/4시간/1일/7일에 걸친 changes.
핵심 인사이트: 가격과 클러스터 보유량이 분기하는 것이 핵심 신호입니다.
- 가격 상승 + 클러스터 % 하락 = 분배(약세)
- 가격 하락 + 클러스터 % 상승 = 축적(강세)
4단계: 주소 라벨 + 매도 압력 확인
/token-wallet-labels→ 개발자/스나이퍼/번들 지갑 식별- 각 위험 주소에 대한
/balance-history→ 여전히 보유 중인지 확인 risky_ratio= 활성 위험 보유량 / 전체 클러스터 보유량 계산-
30% = 높음 위험, 10-30% = 중간, <10% = 낮음
라벨은 행동 이력을 나타내며 현재 보유량이 아닙니다. 항상
/balance-history를 통해 확인하세요.
5단계: 심층 분석 (선택 사항)
/balance-history, /balance-increase/<mint>, /top-holders-snapshot/<mint>, /analyze-dca-limit-orders/<mint>, /cluster-wallet-connections
6단계: 의사 결정
references/decision-framework.md의 강세 체크리스트를 적용합니다.
7단계: 거래 실행
실행에는 scripts/swap.py를 사용하세요 — 지갑 주소 주입, 오류 검사 및 저널 로깅을 처리합니다.
✓ 2026-05-04 이후에도 계속 작동: 스왑 실행은 OKX DEX 애그리게이터를 통한 로컬 서명으로 이루어지며 kg-xyz 백엔드와 독립적입니다.
source ~/.openclaw/workspace/.env && python3 scripts/swap.py <token_mint> 0.1
source ~/.openclaw/workspace/.env && python3 scripts/swap.py <token_mint> <amount> --sell
API 빠른 참조
⚠️ 2026-05-04 이후: 아래의 모든 엔드포인트는
wallet-data.kryptogo.app에서 제공되며 종료됩니다. 스왑 도구(swap_tokens/scripts/swap.py)는 이러한 엔드포인트를 우회하고 OKX DEX 애그리게이터로 직접 라우팅되므로 계속 작동합니다.
| 엔드포인트 | 메서드 | 목적 | 2026-05-04 이후 |
|---|---|---|---|
/agent/account | GET | 등급 및 할당량 확인 | ⚠️ 사용 불가 |
/agent/trending-tokens | GET | 트렌딩 토큰 스캔 | ⚠️ 사용 불가 |
/agent/portfolio | GET | 지갑 포트폴리오 + PnL | ⚠️ 사용 불가(P&L 강화); 잔액은 Solana RPC를 통해 계속 조회 가능 |
/agent/swap | POST | 서명되지 않은 스왑 tx 빌드(Solana 전용) | ⚠️ 사용 불가(스왑이 OKX DEX를 통해 라우팅됨, scripts/swap.py 참조) |
/agent/submit | POST | 서명된 tx 제출(Solana 전용) | ⚠️ 사용 불가(대신 Solana RPC에 직접 제출) |
/token-overview | GET | 토큰 메타데이터 및 시장 데이터 | ⚠️ 사용 불가 |
/analyze/:token_mint | GET | 전체 클러스터 분석 | ⚠️ 사용 불가 |
/analyze-cluster-change/:token_mint | GET | 클러스터 비율 추세 | ⚠️ 사용 불가 |
/balance-history | POST | 시계열 잔액 데이터 | ⚠️ 사용 불가 |
/wallet-labels | POST | 행동 라벨 | ⚠️ 사용 불가 |
/token-wallet-labels | POST | 토큰별 라벨 | ⚠️ 사용 불가 |
/signal-dashboard | GET | 큐레이티드 축적 신호(Pro+) | ⚠️ 사용 불가 |
전체 요청/응답 세부 정보:
references/api-reference.md참조
멀티체인 지원
| 체인 | chain_id | 분석 | 거래 |
|---|---|---|---|
| Solana | 501 | 예 | 예 |
| BSC | 56 | 예 | 아니요 |
| Base | 8453 | 예 | 아니요 |
| Monad | 143 | 예 | 아니요 |
오류 처리
| 코드 | 의미 | 조치 |
|---|---|---|
| 400 | 잘못된 요청 | 매개변수 확인 |
| 401 | 권한 없음 | API 키 확인 |
| 402 | 할당량 초과 | 일일 초기화를 기다리거나 업그레이드 |
| 403 | 금지됨 | 더 높은 등급 필요 |
| 502/504 | 서버 오류 | 10초 후 한 번 재시도 |
운영 스크립트
모든 스크립트는 실행 전에 자격 증명을 미리 로드해야 합니다: source ~/.openclaw/workspace/.env
종료 후(2026-05-04):
portfolio.sh,trending.sh,analysis.sh,test-api.sh는 모두 kg-xyz 백엔드를 호출하며 HTTP 오류를 반환하기 시작합니다.swap.py는 OKX DEX 애그리게이터를 사용하고 로컬로 서명하므로 계속 작동합니다. 스크립트는 스킬이 정상적으로 실패하고 백엔드가 다시 돌아올 경우 복구가 간단하게 유지되도록 제자리에 유지됩니다.
source ~/.openclaw/workspace/.env && bash scripts/portfolio.sh # 포트폴리오 확인 (⚠️ 2026-05-04 이후 중단)
source ~/.openclaw/workspace/.env && bash scripts/trending.sh # 트렌딩 토큰 (⚠️ 2026-05-04 이후 중단)
source ~/.openclaw/workspace/.env && bash scripts/analysis.sh # 전체 분석 대시보드 (⚠️ 2026-05-04 이후 중단)
source ~/.openclaw/workspace/.env && python3 scripts/swap.py <mint> 0.1 # 매수 (✓ 계속 작동)
source ~/.openclaw/workspace/.env && python3 scripts/swap.py <mint> <amt> --sell # 매도 (✓ 계속 작동)
source ~/.openclaw/workspace/.env && bash scripts/test-api.sh # API 연결 테스트 (⚠️ 2026-05-04 이후 중단)
학습 및 적응
에이전트는 거래를 기록하고, 결과를 분석하며, 전략을 조정하여 시간이 지남에 따라 개선됩니다. 모든 거래는 memory/trading-journal.json에 기록되고, 손실은 사후 분석을 유발하며, 정기적인 검토는 매개변수 변경을 제안합니다.
학습 시스템, 거래 저널 형식, 사후 분석 프로세스 및 전략 검토에 대한 자세한 내용은 references/autonomous-trading.md를 참조하세요.
핵심 개념
| 개념 | 핵심 인사이트 |
|---|---|
| 클러스터 | 동일 엔터티가 제어하는 지갑 그룹 |
[원문이 잘렸습니다 - 나머지 내용 번역 생략]