Communitygithub.com

HeyElsa/elsa-openclaw

Elsa API 기반 포트폴리오 분석, 토큰 검색, 스왑 실행을 위한 DeFi 도구 (x402 마이크로페이먼트 지원)

elsa-openclaw란 무엇인가요?

이 스킬은 Elsa DeFi API를 활용하여 포트폴리오 관리, 토큰 분석, 스왑 실행 기능을 제공하며, 모든 API 호출은 x402 마이크로페이먼트 방식으로 결제됩니다. 에이전트는 읽기 전용 도구(토큰 검색, 가격 조회, 잔고 확인, 포트폴리오 분석, 지갑 분석, 스왑 견적, 예산 상태 확인, 지정가 주문 조회, 무기한 포지션 조회, 거래 내역 조회)와 실행 도구(확정 스왑, 파이프라인 실행, 지정가 주문 생성/취소, 무기한 포지션 열기/닫기)를 모두 사용할 수 있으며, 실행 도구 사용 시에는 반드시 `ELSA_ENABLE_EXECUTION_TOOLS=true` 환경 변수를 설정해야 합니다. 특히 스왑 실행은 '견적 요청 → 드라이런 → 사용자 확인 → 파이프라인 실행'의 4단계를 반드시 따라야 하며, 예산 한도(호출당 최대 $0.05, 일일 최대 $2.00, 분당 최대 30회)를 초과하지 않도록 주의해야 합니다. Base, Ethereum, Arbitrum, Optimism, Polygon, BSC, Avalanche, zkSync 등 주요 체인을 지원하며, 실제 트랜잭션 서명을 위해 `PAYMENT_PRIVATE_KEY`와 `TRADE_PRIVATE_KEY` 환경 변수가 필요합니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add HeyElsa/elsa-openclaw

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

Elsa x402 DeFi 도구

이 스킬은 포트폴리오 관리, 토큰 분석, x402 마이크로페이먼트를 사용한 스왑 실행을 위한 Elsa DeFi API에 접근할 수 있게 해줍니다.

표준 운영 절차

예산 제어

  • API 호출당 최대 $0.05 (설정 가능)
  • 일일 최대 $2.00 (설정 가능)
  • 분당 최대 30회 호출 속도 제한
  • 일일 예산은 설정된 시간대(기본값: UTC) 자정에 초기화됩니다.

권장 스왑 흐름 (OpenClaw)

스왑을 실행할 때는 다음 4단계 흐름을 따르세요:

┌─────────────────────┐     ┌─────────────────────┐     ┌─────────────┐     ┌─────────────────────┐
│ 1. 견적 요청        │ ──▶ │ 2. 드라이런         │ ──▶ │ 3. 확인      │ ──▶ │ 4. 파이프라인 실행  │
│ elsa_get_swap_quote │     │ elsa_execute_swap_  │     │ [사용자가   │     │ elsa_pipeline_run_  │
│                     │     │ dry_run             │     │  "예"라고   │     │ and_wait            │
└─────────────────────┘     └─────────────────────┘     └─────────────┘     └─────────────────────┘

1단계: 견적 요청 - 사용자에게 받을 금액을 보여줍니다.

npx tsx scripts/index.ts elsa_get_swap_quote '{
  "from_chain": "base", "from_token": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
  "from_amount": "10", "to_chain": "base", "to_token": "0x4200000000000000000000000000000000000006",
  "wallet_address": "0x...", "slippage": 0.5
}'

2단계: 드라이런 - 파이프라인을 생성하고 pipeline_id를 받습니다.

npx tsx scripts/index.ts elsa_execute_swap_dry_run '{...동일한 파라미터...}'
# 반환: { "pipeline_id": "abc-123", "confirmation_token": "..." }

3단계: 사용자 확인 - 결과를 제시하고 명시적인 "예" 응답을 기다립니다.

4단계: 파이프라인 실행 - 트랜잭션에 서명하고 브로드캐스트합니다.

ELSA_ENABLE_EXECUTION_TOOLS=true npx tsx scripts/index.ts elsa_pipeline_run_and_wait '{
  "pipeline_id": "abc-123",
  "timeout_seconds": 180,
  "poll_interval_seconds": 3,
  "mode": "local_signer"
}'
# 자동: 승인 tx 서명 → 제출 → 스왑 tx 서명 → 제출 → tx 해시 반환

필수 환경 변수

# x402 API 결제용
PAYMENT_PRIVATE_KEY=0x...

# 스왑 트랜잭션 서명용 (선택 사항, 미설정 시 PAYMENT_PRIVATE_KEY 사용)
TRADE_PRIVATE_KEY=0x...

# 실행 도구 활성화
ELSA_ENABLE_EXECUTION_TOOLS=true

중요 규칙

  • 절대 사용자에게 견적을 보여주지 않고 스왑을 실행하지 마세요.
  • 절대 루프 내에서 실행 도구를 호출하지 마세요.
  • 절대 예산 한도를 초과한 상태에서 진행하지 마세요.
  • 항상 남은 예산이 확실하지 않다면 elsa_budget_status를 확인하세요.
  • 항상 모든 스왑 작업에 대해 먼저 드라이런 모드를 사용하세요.

도구 카탈로그

읽기 전용 도구 (항상 사용 가능)

elsa_search_token

지원되는 블록체인에서 토큰을 검색합니다.

npx tsx scripts/index.ts elsa_search_token '{"query": "USDC", "limit": 5}'

입력:

  • query (문자열, 필수): 토큰 이름, 심볼 또는 주소
  • limit (숫자, 선택 사항): 최대 결과 수 (기본값: 10)

elsa_get_token_price

토큰의 현재 가격을 조회합니다.

npx tsx scripts/index.ts elsa_get_token_price '{"token_address": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "chain": "base"}'

입력:

  • token_address (문자열, 필수): 토큰 컨트랙트 주소
  • chain (문자열, 선택 사항): 체인 이름 (기본값: "base")

elsa_get_balances

지갑의 토큰 잔액을 조회합니다.

npx tsx scripts/index.ts elsa_get_balances '{"wallet_address": "0x..."}'

입력:

  • wallet_address (문자열, 필수): 조회할 지갑 주소

elsa_get_portfolio

종합적인 포트폴리오 분석을 제공합니다.

npx tsx scripts/index.ts elsa_get_portfolio '{"wallet_address": "0x..."}'

입력:

  • wallet_address (문자열, 필수): 분석할 지갑 주소

elsa_analyze_wallet

지갑 행동 및 리스크 평가를 제공합니다.

npx tsx scripts/index.ts elsa_analyze_wallet '{"wallet_address": "0x..."}'

입력:

  • wallet_address (문자열, 필수): 분석할 지갑 주소

elsa_get_swap_quote

최적의 라우팅으로 스왑 견적을 받습니다.

npx tsx scripts/index.ts elsa_get_swap_quote '{
  "from_chain": "base",
  "from_token": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
  "from_amount": "100",
  "to_chain": "base",
  "to_token": "0x4200000000000000000000000000000000000006",
  "wallet_address": "0x...",
  "slippage": 0.5
}'

입력:

  • from_chain (문자열, 필수): 소스 체인
  • from_token (문자열, 필수): 소스 토큰 주소
  • from_amount (문자열, 필수): 스왑할 금액
  • to_chain (문자열, 필수): 대상 체인
  • to_token (문자열, 필수): 대상 토큰 주소
  • wallet_address (문자열, 필수): 지갑 주소
  • slippage (숫자, 필수): 슬리피지 허용 범위 (0-50)

elsa_execute_swap_dry_run

실행 없이 스왑을 시뮬레이션합니다. 이후 확인된 실행을 위한 확인 토큰을 반환합니다.

npx tsx scripts/index.ts elsa_execute_swap_dry_run '{
  "from_chain": "base",
  "from_token": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
  "from_amount": "100",
  "to_chain": "base",
  "to_token": "0x4200000000000000000000000000000000000006",
  "wallet_address": "0x...",
  "slippage": 0.5
}'

출력 포함:

  • 스왑 시뮬레이션 결과
  • confirmation_token (ELSA_REQUIRE_CONFIRMATION_TOKEN=true인 경우)
  • 토큰은 ELSA_CONFIRMATION_TTL_SECONDS 후 만료

elsa_budget_status

현재 예산 사용량과 남은 한도를 확인합니다.

npx tsx scripts/index.ts elsa_budget_status '{}'

출력:

  • spent_today_usd: 오늘 사용된 금액
  • remaining_today_usd: 남은 일일 예산
  • calls_last_minute: 최근 호출 수
  • last_calls: 최근 호출 세부 정보

elsa_get_limit_orders

지갑의 모든 지정가 주문을 조회합니다.

npx tsx scripts/index.ts elsa_get_limit_orders '{"wallet_address": "0x...", "chain": "base"}'

입력:

  • wallet_address (문자열, 필수): 조회할 지갑 주소
  • chain (문자열, 선택 사항): 체인 이름 (기본값: "base")

출력:

  • orders: 상태, 가격, 만료일이 포함된 지정가 주문 배열

elsa_get_perp_positions

지갑의 무기한 포지션을 조회합니다.

npx tsx scripts/index.ts elsa_get_perp_positions '{"wallet_address": "0x..."}'

입력:

  • wallet_address (문자열, 필수): 조회할 지갑 주소

출력:

  • positions: PnL, 레버리지, 청산 가격이 포함된 개방형 무기한 포지션 배열
  • total_unrealized_pnl: 미실현 손익 합계
  • total_margin: 사용된 총 증거금

elsa_get_transaction_history

지갑의 거래 내역을 조회합니다.

npx tsx scripts/index.ts elsa_get_transaction_history '{"wallet_address": "0x...", "chain": "base", "limit": 20}'

입력:

  • wallet_address (문자열, 필수): 조회할 지갑 주소
  • chain (문자열, 선택 사항): 체인별 필터
  • limit (숫자, 선택 사항): 최대 결과 수 (기본값: 20, 최대: 100)

출력:

  • transactions: 세부 정보, 토큰 전송, 상태가 포함된 거래 배열

실행 도구 (ELSA_ENABLE_EXECUTION_TOOLS=true 필요)

elsa_execute_swap_confirmed

확인된 스왑을 실행합니다. 사전 드라이런 및 확인 토큰이 필요합니다.

npx tsx scripts/index.ts elsa_execute_swap_confirmed '{
  "from_chain": "base",
  "from_token": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
  "from_amount": "100",
  "to_chain": "base",
  "to_token": "0x4200000000000000000000000000000000000006",
  "wallet_address": "0x...",
  "slippage": 0.5,
  "confirmation_token": "abc123..."
}'

elsa_pipeline_get_status

파이프라인/트랜잭션의 상태를 확인합니다.

npx tsx scripts/index.ts elsa_pipeline_get_status '{"pipeline_id": "pip_123456789"}'

elsa_pipeline_submit_tx_hash

서명된 트랜잭션 해시를 파이프라인에 제출합니다.

npx tsx scripts/index.ts elsa_pipeline_submit_tx_hash '{"task_id": "task_123", "tx_hash": "0x..."}'

elsa_pipeline_run_and_wait

자동 서명 및 제출로 전체 파이프라인 실행을 조율합니다.

npx tsx scripts/index.ts elsa_pipeline_run_and_wait '{
  "pipeline_id": "pip_123456789",
  "timeout_seconds": 120,
  "poll_interval_seconds": 2,
  "mode": "local_signer"
}'

모드:

  • local_signer: TRADE_PRIVATE_KEY를 사용하여 트랜잭션에 서명하고 브로드캐스트합니다.
  • external_signer: 외부 서명을 위해 서명되지 않은 tx_data를 반환합니다.

elsa_create_limit_order

가격이 목표에 도달하면 실행되는 지정가 주문을 생성합니다.

ELSA_ENABLE_EXECUTION_TOOLS=true npx tsx scripts/index.ts elsa_create_limit_order '{
  "wallet_address": "0x...",
  "chain": "base",
  "from_token": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
  "to_token": "0x4200000000000000000000000000000000000006",
  "from_amount": "100",
  "limit_price": "0.0004",
  "expiry_hours": 24
}'

입력:

  • wallet_address (문자열, 필수): 지갑 주소
  • chain (문자열, 필수): 체인 이름
  • from_token (문자열, 필수): 판매할 토큰
  • to_token (문자열, 필수): 구매할 토큰
  • from_amount (문자열, 필수): 판매할 금액
  • limit_price (문자열, 필수): 실행을 트리거할 목표 가격
  • expiry_hours (숫자, 선택 사항): 주문 만료까지 시간 (기본값: 24, 최대: 720)

elsa_cancel_limit_order

기존 지정가 주문을 취소합니다.

ELSA_ENABLE_EXECUTION_TOOLS=true npx tsx scripts/index.ts elsa_cancel_limit_order '{
  "wallet_address": "0x...",
  "order_id": "order_123",
  "chain": "base"
}'

입력:

  • wallet_address (문자열, 필수): 지갑 주소
  • order_id (문자열, 필수): 취소할 주문 ID
  • chain (문자열, 선택 사항): 체인 이름 (기본값: "base")

elsa_open_perp_position

무기한 선물 포지션을 개설합니다.

ELSA_ENABLE_EXECUTION_TOOLS=true npx tsx scripts/index.ts elsa_open_perp_position '{
  "wallet_address": "0x...",
  "market": "ETH-USD",
  "side": "long",
  "size_usd": "100",
  "leverage": 5,
  "take_profit": "4000",
  "stop_loss": "2800"
}'

입력:

  • wallet_address (문자열, 필수): 지갑 주소
  • market (문자열, 필수): 마켓 페어 (예: "ETH-USD", "BTC-USD")
  • side (열거형, 필수): "long" 또는 "short"
  • size_usd (문자열, 필수): USD 기준 포지션 크기
  • leverage (숫자, 선택 사항): 레버리지 배수 (기본값: 1, 최대: 100)
  • take_profit (문자열, 선택 사항): 이익 실현 가격
  • stop_loss (문자열, 선택 사항): 손절매 가격

elsa_close_perp_position

개방된 무기한 포지션을 청산합니다.

ELSA_ENABLE_EXECUTION_TOOLS=true npx tsx scripts/index.ts elsa_close_perp_position '{
  "wallet_address": "0x...",
  "position_id": "pos_123",
  "close_percentage": 100
}'

입력:

  • wallet_address (문자열, 필수): 지갑 주소
  • position_id (문자열, 필수): 청산할 포지션 ID
  • close_percentage (숫자, 선택 사항): 청산 비율 (기본값: 100, 범위: 1-100)

지원되는 체인

  • base (기본값)
  • ethereum
  • arbitrum
  • optimism
  • polygon
  • bsc
  • avalanche
  • zksync

API 비용

도구예상 비용
elsa_search_token$0.002
elsa_get_token_price$0.002
elsa_get_balances$0.002
elsa_get_portfolio$0.002
elsa_analyze_wallet$0.005
elsa_get_swap_quote$0.002
elsa_execute_swap_dry_run$0.005
elsa_get_limit_orders$0.002
elsa_get_perp_positions$0.002
elsa_get_transaction_history$0.002
elsa_create_limit_order$0.05
elsa_cancel_limit_order$0.01
elsa_open_perp_position$0.05
elsa_close_perp_position$0.05
elsa_execute_swap_confirmed$0.05

곧 출시 예정

  • Polymarket API - 예측 시장 거래 및 데이터

관련 스킬