LeoYeAI/openclaw-master-skills

Mobula - 멀티체인 암호화폐 데이터 인텔리전스

88개 이상의 블록체인에서 실시간 암호화폐 시장 데이터, 지갑 추적 및 온체인 분석을 제공합니다. Chainlink, Supra, API3가 신뢰하는 오라클급 가격 정보입니다.

이 스킬을 사용해야 하는 경우

다음과 같은 경우 사용하세요:

• 사용자가 토큰 가격, 거래량, 시가총액 또는 가격 변동에 대해 묻는 경우
• 지갑의 보유 자산이나 포트폴리오 가치를 확인하려는 경우
• 차트나 분석을 위해 과거 가격 데이터가 필요한 경우
• 컨트랙트 주소를 언급하며 토큰 정보를 원하는 경우
• 특정 체인(Base, Arbitrum, Solana 등)의 토큰에 대해 묻는 경우
• 크로스체인 포트폴리오 개요를 원하는 경우
• 여러 토큰에 대한 일괄 데이터가 필요한 경우
• 토큰 유동성, ATH, ATL 또는 거래량에 대해 묻는 경우
• 고래 지갑을 추적하거나 중요한 거래를 모니터링하려는 경우
• 특정 기준에 맞는 신규 토큰을 찾아야 하는 경우

사용하지 말아야 하는 경우:

• 사용자가 거래를 실행하려는 경우 (대신 bankr 스킬 사용)
• 사용자가 DEX 스왑 견적을 원하는 경우 (대신 defi 스킬 사용)
• 사용자가 특정 거래소 데이터를 원하는 경우 (대신 okx/binance 스킬 사용)

---

핵심 기능

1. 시장 데이터 (mobula_market_data)

엔드포인트: GET https://api.mobula.io/api/1/market/data

지원되는 모든 체인의 모든 토큰에 대한 실시간 가격, 거래량, 시가총액 및 유동성을 가져옵니다.

파라미터:

• asset (필수): 토큰 이름, 심볼 또는 컨트랙트 주소
  • 예시: "Bitcoin", "ETH", "0x532f27101965dd16442e59d40670faf5ebb142e4"
• blockchain (선택): 조회할 특정 체인
  • 예시: "base", "arbitrum", "ethereum", "solana", "polygon"

반환값:

• 현재 가격 (USD)
• 가격 변동: 1시간, 24시간, 7일, 30일 (백분율 및 절대값)
• 거래량 (24시간)
• 시가총액
• 완전 희석 가치
• 유동성
• 사상 최고가(ATH) 및 사상 최저가(ATL) (날짜 포함)
• 총 공급량, 유통 공급량

사용 예시:

• "비트코인 가격이 얼마야?"
• "Base 체인의 BRETT 시장 데이터 보여줘"
• "컨트랙트 0x532f27101965dd16442e59d40670faf5ebb142e4의 데이터 가져와"
• "ETH 지금 펌핑 중이야? 덤핑 중이야?"
• "PEPE의 시가총액은 얼마야?"

사용 시기:

• 사용자가 토큰 가격을 물을 때
• 사용자가 어떤 자산이 펌핑/덤핑 중인지 알고 싶을 때
• 토큰 펀더멘털(시총, 유동성, 거래량) 분석
• 토큰 비교
• 가격 알림 설정

---

2. 지갑 포트폴리오 (mobula_wallet_portfolio)

엔드포인트: GET https://api.mobula.io/api/1/wallet/portfolio

단일 호출로 88개 체인 전체에 걸친 모든 지갑의 완전한 포트폴리오를 가져옵니다.

파라미터:

• wallet (필수): 지갑 주소
  • 형식: "0x..." 또는 ENS 이름 (예: "vitalik.eth")
• blockchains (선택): 특정 체인으로 필터링할 쉼표로 구분된 목록
  • 기본값: 모든 체인
• cache (선택): 캐시된 데이터 사용 (더 빠르지만 약간 덜 신선함)

반환값:

• 보유 중인 모든 토큰:
  • 토큰 이름, 심볼, 주소
  • 잔액 (수량 및 USD 가치)
  • 현재 가격
  • 24시간 가격 변동
  • 예상 손익
  • 체인
• 총 포트폴리오 가치 (USD)
• 토큰별 포트폴리오 할당 (백분율)
• NFT (있는 경우)

사용 예시:

• "지갑 0x123...의 포트폴리오를 보여줘"
• "vitalik.eth가 보유한 토큰은?"
• "내 지갑 잔액 확인해 줘"
• "이 지갑의 총 가치는 얼마야?"
• "이 지갑의 상위 5개 보유 자산을 보여줘"

사용 시기:

• 포트폴리오 추적
• 지갑 분석
• 거래 전후 보유 자산 확인
• 할당 모니터링
• 포트폴리오 알림 설정

---

3. 과거 가격 데이터 (mobula_market_history)

엔드포인트: GET https://api.mobula.io/api/1/market/history

유연한 시간대 설정으로 모든 토큰의 과거 가격 데이터를 가져옵니다.

파라미터:

• asset (필수): 토큰 이름, 심볼 또는 주소
• from (선택): 시작 타임스탬프 (Unix 초)
• to (선택): 종료 타임스탬프 (Unix 초)
• period (선택): 데이터 세분화
  • 옵션: "1h", "1d", "1w"
  • 기본값: 시간대에 따라 자동 선택

반환값:

• 타임스탬프가 포함된 가격 포인트 배열
• 각 포인트의 거래량
• 각 포인트의 시가총액

사용 예시:

• "지난 30일간 ETH 가격을 보여줘"
• "1월 1일에 이 토큰 가격은 어땠어?"
• "이 토큰 이번 주에 펌핑 중이야? 덤핑 중이야?"
• "지난 7일간 BTC의 가격 움직임을 차트로 보여줘"

사용 시기:

• 트렌드 분석
• 과거 손익 계산
• 시간대별 가격 움직임 비교
• 패턴 식별 (돌파, 지지, 저항)

---

4. 최근 거래 (mobula_market_trades)

엔드포인트: GET https://api.mobula.io/api/1/market/trades

모든 DEX 및 체인에서 발생한 모든 토큰의 실시간 거래 피드입니다.

파라미터:

• asset (필수): 토큰 이름, 심볼 또는 주소
• limit (선택): 반환할 거래 수 (기본값: 50, 최대: 300)

반환값:

• 최근 거래 배열:
  • 타임스탬프
  • 유형 (매수/매도)
  • 수량 (토큰 및 USD)
  • 거래 시 가격
  • 지갑 주소 (매수자/매도자)
  • DEX 및 체인
  • 트랜잭션 해시

사용 예시:

• "이 토큰의 최근 거래를 보여줘"
• "지금 누가 PEPE를 사고 있어?"
• "이 토큰에 고래 움직임이 있어?"
• "이 토큰의 최근 10개 거래를 보여줘"

사용 시기:

• 고래 감시
• 비정상 활동 탐지 (대량 매수/매도)
• 거래량 검증
• 심리 분석 (매수 대 매도 비율)

---

5. 지갑 트랜잭션 내역 (mobula_wallet_transactions)

엔드포인트: GET https://api.mobula.io/api/1/wallet/transactions

모든 체인에 걸친 모든 지갑의 전체 트랜잭션 내역입니다.

파라미터:

• wallet (필수): 지갑 주소
• from (선택): 시작 타임스탬프
• to (선택): 종료 타임스탬프
• asset (선택): 특정 토큰으로 필터링
• limit (선택): 트랜잭션 수 (기본값: 100)

반환값:

• 트랜잭션 배열:
  • 유형 (스왑, 전송, 발행, 소각)
  • 관련 토큰 (발신/수신)
  • 수량
  • 트랜잭션 시점의 USD 가치
  • 타임스탬프
  • 체인
  • 트랜잭션 해시

사용 예시:

• "이 지갑이 최근에 무엇을 샀어?"
• "0x123...의 마지막 10개 트랜잭션을 보여줘"
• "이 지갑이 ETH를 마지막으로 판 게 언제야?"
• "이 고래의 활동을 추적해 줘"

사용 시기:

• 지갑 모니터링
• 고래 추적
• 패턴 탐지 (매수/매도하는 자산)
• 트랜잭션 검증

---

6. 다중 자산 데이터 (mobula_market_multi)

엔드포인트: GET https://api.mobula.io/api/1/market/multi-data

단일 요청으로 여러 토큰의 시장 데이터를 가져옵니다 (일괄 엔드포인트).

파라미터:

• assets (필수): 쉼표로 구분된 토큰 이름/심볼/주소 목록
  • 예시: "Bitcoin,Ethereum,Solana" 또는 "BTC,ETH,SOL"
  • 최대: 요청당 500개 토큰

반환값:

• 여러 토큰에 대한 mobula_market_data와 동일한 데이터
• 포트폴리오 분석, 관심 목록, 시장 개요에 효율적

사용 예시:

• "오늘 BTC, ETH, SOL 성능을 비교해 줘"
• "내 관심 목록에서 상위 변동 자산을 보여줘"
• "이 10개 토큰의 가격을 가져와: [목록]"

사용 시기:

• 포트폴리오 평가
• 관심 목록 업데이트
• 시장 개요 (상위 코인)
• 일괄 가격 확인

---

7. 토큰 메타데이터 (mobula_metadata)

엔드포인트: GET https://api.mobula.io/api/1/metadata

모든 토큰에 대한 상세 메타데이터를 가져옵니다.

파라미터:

• asset (필수): 토큰 이름, 심볼 또는 주소

반환값:

• 이름, 심볼, 로고
• 설명
• 웹사이트, Twitter, Telegram, Discord 링크
• 모든 체인의 컨트랙트 주소
• 출시일
• 카테고리/태그

사용 예시:

• "이 토큰에 대해 알려줘"
• "이 프로젝트의 웹사이트는 뭐야?"
• "그들의 커뮤니티는 어디서 찾을 수 있어?"

사용 시기:

• 신규 토큰 조사
• 정당성 확인
• 공식 링크 찾기

---

인증

필수: 모든 API 요청은 API 키를 통한 인증이 필요합니다.

설정 방법:

1. **https://mobula.io**에서 무료 API 키를 받으세요 (무료 티어 분당 100회 요청)
2. 환경 변수 설정:

   export MOBULA_API_KEY="your_key_here"
   

3. OpenClaw 에이전트 재시작

헤더 형식:

Authorization: ${MOBULA_API_KEY}

인증 실패 시 (401/403):

• 키가 설정되었는지 확인: echo $MOBULA_API_KEY
• 만료된 경우 https://mobula.io에서 키 재생성
• 속도 제한 확인 (무료 분당 100회, 업그레이드 시 증가)

---

개인정보 보호 및 보안

중요 - 사용 전 반드시 읽어보세요:

이 스킬이 접근하는 정보

• 공개 블록체인 데이터만: 지갑 주소, 토큰 가격, 트랜잭션 내역
• 개인키 없음: 절대 개인키, 시드 문구 또는 비밀번호를 이 스킬에 제공하지 마세요
• 민감한 자격 증명 없음: 스킬은 Mobula API 키만 필요 (공개 데이터 접속)

지갑 주소 개인정보

• 이 스킬을 통해 조회된 지갑 주소는 Mobula의 API(https://api.mobula.io)로 전송됩니다.
• 지갑 주소를 조회하면 보유 자산이 공개적으로 드러납니다 (온체인 데이터는 이미 공개됨).
• 공유해도 괜찮은 공개 지갑 주소만 사용하세요.
• 비공개로 유지하거나 신원과 연결되는 주소는 입력하지 마세요.

API 키 범위

• Mobula API 키는 공개 블록체인 데이터에 대한 읽기 전용 접근을 제공합니다.
• 키의 범위를 지정하거나, 교체하거나, https://mobula.io에서 취소할 수 있습니다.
• 무료 티어: 분당 100회 요청
• 테스트용과 프로덕션용으로 별도의 API 키를 사용하는 것을 고려하세요.

데이터 보존

• Mobula는 분석 및 속도 제한을 위해 API 요청을 기록할 수 있습니다.
• Mobula의 개인정보 보호정책 참조: https://mobula.io/privacy
• 민감하다고 생각되는 지갑이나 데이터는 조회하지 마세요.

모범 사례

1. 초기 테스트에는 일회용/테스트 API 키 사용
2. 공개 지갑 주소만 조회 (예: vitalik.eth, 잘 알려진 주소)
3. 개인정보를 원한다면 개인 지갑을 조회하지 마세요.
4. API 키를 주기적으로 교체하세요.
5. https://mobula.io에서 속도 제한 및 사용량 모니터링

---

하트비트를 활용한 스마트 모니터링 패턴

OpenClaw의 하트비트 시스템은 약 30분마다 조건을 확인합니다. 사전 예방적 모니터링에 사용하세요.

패턴 1: 포트폴리오 가디언

매 하트비트마다:

1. mobula_wallet_portfolio를 통해 사용자 지갑 가져오기
2. 할당 비율 계산
3. 조건 확인:
   • 어떤 토큰이 포트폴리오의 40% 초과 → 리밸런싱 제안
   • 어떤 토큰이 24시간 내 15% 이상 하락 → 컨텍스트와 함께 알림
   • 총 포트폴리오가 10% 이상 변동 → 알림
4. 변경 사항 감지를 위해 이전 값을 메모리에 저장
5. 사용자가 선호하는 시간에 일일 요약 전송

패턴 2: 고래 감시

매 하트비트마다:

1. mobula_wallet_transactions를 통해 추적 중인 지갑의 트랜잭션 확인
2. 새로운 중요 트랜잭션 (>$50K)이 있는 경우:
   • mobula_market_data를 통해 토큰 세부 정보 가져오기
   • mobula_market_trades를 통해 최근 거래 확인
   • 다른 추적 중인 고래가 같은 토큰을 샀는지 교차 확인
3. 여러 고래가 매수 중인 경우 → 우선 알림

패턴 3: 토큰 스카우트 (자율 탐색)

4-6시간마다 하트비트로:

1. 사용자 정의 기준 (메모리에 저장):
   • 체인: Base, Arbitrum
   • 시가총액: <$5M
   • 유동성: >$100K
   • 24시간 거래량 변동: >+50%
2. mobula_market_data 쿼리를 통해 토큰 검색/필터링
3. 각 일치 항목에 대해:
   • mobula_market_history를 통해 7일 내역 가져오기
   • mobula_metadata를 통해 메타데이터 확인
   • 위험 점수 계산
4. 분석과 함께 상위 3개 전송

패턴 4: 스마트 가격 알림

단순한 "가격 > X" 알림 대신 맥락적 알림 생성:

예: "비트코인이 1시간 내 5% 이상 움직이되, 거래량이 24시간 평균의 2배 이상일 때만 알림"

매 하트비트마다:

1. mobula_market_data를 통해 현재 가격 및 거래량 가져오기
2. 1시간 전 가격과 비교 (메모리에 저장됨)
3. 거래량 조건이 충족되는지 확인
4. 두 조건이 모두 참일 때만 알림

---

여러 엔드포인트 결합을 통한 풍부한 인사이트

예시: 전체 토큰 분석

사용자 질문: "이 토큰을 사야 할까?"

1. mobula_market_data → 현재 가격, 시가총액, 거래량, 유동성
2. mobula_market_history → 7일 및 30일 트렌드
3. mobula_market_trades → 최근 활동 (축적 중인가 분배 중인가?)
4. mobula_metadata → 프로젝트 정보, 소셜, 컨트랙트 검증

응답 형식:

TOKEN 분석

가격: $0.042 (24시간 8% 하락, 7일 156% 상승)
- 7일 고점 근접, $0.051에서 하락
- 30일 저점 대비 400% 상승 중

펀더멘털:
- 시가총액: $2.1M (소형주, 고위험/고수익)
- 유동성: $280K (규모 대비 적절)
- 거래량: 24시간 $1.2M (건전함)

온체인:
- 최근 거래는 매수 압력을 보여줌 (3:1 매수/매도 비율)
- 지난 2시간 내 2건의 대량 매수 ($50K+)

프로젝트:
- 컨트랙트 검증 완료
- 활성 Twitter 계정 (12K 팔로워)

위험: 소형주, 높은 변동성. 잃어도 되는 만큼만 투자하세요.

---

응답 형식 지침

가격

• 항상 방향 표시: "12.4% 상승" 또는 "3.2% 하락"
• 시간대 포함: "12.4% 상승 (24시간)"
• 컨텍스트 추가: "가격 $0.042 (24시간 12% 상승, ATH 대비 8% 하락)"

큰 숫자

• 명확하게 형식화: "$1.23M", "$456K", "$45.6B"
• 사용 금지: "$1234567"

백분율

• 할당에 사용: "ETH: 포트폴리오의 42%"
• 변동에 사용: "24시간 내 15.3% 하락"

컨텍스트가 핵심

단순히 "가격은 $0.003"이라고 말하지 마세요. 다음과 같이 말하세요: "가격 $0.003 (24시간 8% 하락, 12월 1일 ATH $0.089 대비 65% 하락했지만, 7일 저점 대비 12% 상승)"

---

일반적인 사용자 요청 및 처리 방법

"[토큰]에 대한 알림 설정해 줘"

1. 요청 확인
2. 특정 조건 문의 (가격 임계값? 백분율 변동? 거래량 급증?)
3. 하트비트를 통해 모니터링하겠다고 확인
4. 알림 구성을 메모리에 저장
5. 확인: "[토큰]을 30분마다 확인하고 [조건]이 충족되면 [채널]로 알림 드릴게요"

"이 지갑 추적해 줘"

1. 지갑을 모니터링 목록에 추가
2. 무엇을 추적할지 문의:
   • 모든 활동?
   • 대규모 거래만 (>$X)?
   • 특정 토큰?
3. 메모리에 저장
4. 모니터링 활성화 확인

"[기준]에 맞는 토큰 찾아줘"

1. 기준 명확화:
   • 체인?
   • 시가총액 범위?
   • 거래량 요구 사항?
   • 최소 유동성?
2. 주기적 확인 설정 (4-6시간 간격 권장)
3. 원하는 결과 수 문의
4. 다음 하트비트에서 모니터링 시작

"지금 암호화폐 시장에서 무슨 일이 일어나고 있어?"

1. mobula_market_multi를 통해 주요 토큰(BTC, ETH, SOL, BNB) 확인
2. 주요 변동 식별 (24시간 내 5% 이상)
3. 거래량 선두주자 확인
4. 간결한 개요 제공

---

오류 처리

API 키 문제

• 키가 설정되지 않음: "암호화폐 데이터를 가져오려면 Mobula API 키가 필요합니다. https://mobula.io에서 무료로 받은 후 export MOBULA_API_KEY='your_key'로 환경에 추가하세요."
• 잘못된 키: "API 키가 유효하지 않습니다. https://mobula.io에서 키를 확인하고 올바르게 설정했는지 확인하세요."
• 속도 제한 초과: "API 속도 제한에 도달했습니다. 잠시 후 다시 시도하거나 https://mobula.io에서 업그레이드를 고려하세요."

데이터 없음

• "토큰을 찾을 수 없습니다. 이름, 심볼 또는 컨트랙트 주소가 올바른지 확인하세요."
• "이 지갑에 트랜잭션이 없습니다."
• "이 시간 범위에 데이터를 사용할 수 없습니다."

네트워크 오류

• "Mobula API에 연결할 수 없습니다. 인터넷 연결을 확인하고 다시 시도하세요."
• "API 요청 시간이 초과되었습니다. 다시 시도하거나 나중에 확인하세요."

---

제한 사항

데이터 커버리지

• 88+ 체인 지원됨 (전체 목록: docs.mobula.io 참조)
• DEX 거래 데이터 (중앙화 거래소 CEX 제외)
• 지연: 일반적으로 <10초

지원되지 않음

• 주문장 데이터 (CEX)
• 파생상품/선물 데이터
• 가스 가격 추정
• 트랜잭션 시뮬레이션
• DeFi 수익률/이자율

최선의 노력 데이터

Mobula는 집계 데이터를 제공합니다. 항상 중요한 거래 전에 직접 확인하세요.