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(문자열, 필수): 취소할 주문 IDchain(문자열, 선택 사항): 체인 이름 (기본값: "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(문자열, 필수): 청산할 포지션 IDclose_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 - 예측 시장 거래 및 데이터