Herramientas DeFi Elsa x402
Este skill proporciona acceso a la API DeFi de Elsa para gestión de carteras, análisis de tokens y ejecución de intercambios utilizando micropagos x402.
Procedimiento Operativo Estándar
Controles de Presupuesto
- Máximo $0.05 por llamada a la API (configurable)
- Máximo $2.00 por día (configurable)
- Límite de 30 llamadas por minuto
- El presupuesto diario se reinicia a la medianoche en la zona horaria configurada (por defecto: UTC)
Flujo de Intercambio Recomendado (OpenClaw)
Al ejecutar intercambios, siga este flujo de 4 pasos:
┌─────────────────────┐ ┌─────────────────────┐ ┌─────────────┐ ┌─────────────────────┐
│ 1. Obtener Cotización│ ──▶ │ 2. Simulación │ ──▶ │ 3. Confirmar│ ──▶ │ 4. Ejecutar Pipeline│
│ elsa_get_swap_quote │ │ elsa_execute_swap_ │ │ [Usuario │ │ elsa_pipeline_run_ │
│ │ │ dry_run │ │ dice "sí"] │ │ and_wait │
└─────────────────────┘ └─────────────────────┘ └─────────────┘ └─────────────────────┘
Paso 1: Obtener Cotización - Mostrar al usuario lo que recibirá
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
}'
Paso 2: Simulación - Crear pipeline, obtener pipeline_id
npx tsx scripts/index.ts elsa_execute_swap_dry_run '{...mismos parámetros...}'
# Devuelve: { "pipeline_id": "abc-123", "confirmation_token": "..." }
Paso 3: Confirmación del Usuario - Presentar resultados y esperar un "sí" explícito
Paso 4: Ejecutar Pipeline - Firmar y transmitir transacciones
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"
}'
# Automáticamente: firma tx de aprobación → envía → firma tx de intercambio → envía → devuelve hashes de tx
Variables de Entorno Requeridas
# Para pagos API x402
PAYMENT_PRIVATE_KEY=0x...
# Para firmar transacciones de intercambio (opcional, por defecto usa PAYMENT_PRIVATE_KEY)
TRADE_PRIVATE_KEY=0x...
# Habilitar herramientas de ejecución
ELSA_ENABLE_EXECUTION_TOOLS=true
Reglas Críticas
- NUNCA ejecutar intercambios sin mostrar primero la cotización al usuario
- NUNCA llamar herramientas de ejecución en un bucle
- NUNCA proceder si se exceden los límites de presupuesto
- SIEMPRE verificar
elsa_budget_statussi hay dudas sobre el presupuesto restante - SIEMPRE usar el modo de simulación primero para cualquier operación de intercambio
Catálogo de Herramientas
Herramientas de Solo Lectura (Siempre Disponibles)
elsa_search_token
Buscar tokens en blockchains compatibles.
npx tsx scripts/index.ts elsa_search_token '{"query": "USDC", "limit": 5}'
Entrada:
query(cadena, obligatorio): Nombre, símbolo o dirección del tokenlimit(número, opcional): Máximo de resultados (por defecto: 10)
elsa_get_token_price
Obtener el precio actual de un token.
npx tsx scripts/index.ts elsa_get_token_price '{"token_address": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "chain": "base"}'
Entrada:
token_address(cadena, obligatorio): Dirección del contrato del tokenchain(cadena, opcional): Nombre de la cadena (por defecto: "base")
elsa_get_balances
Obtener saldos de tokens para una billetera.
npx tsx scripts/index.ts elsa_get_balances '{"wallet_address": "0x..."}'
Entrada:
wallet_address(cadena, obligatorio): Dirección de la billetera a consultar
elsa_get_portfolio
Obtener análisis completo de cartera.
npx tsx scripts/index.ts elsa_get_portfolio '{"wallet_address": "0x..."}'
Entrada:
wallet_address(cadena, obligatorio): Dirección de la billetera a analizar
elsa_analyze_wallet
Obtener evaluación de comportamiento y riesgo de una billetera.
npx tsx scripts/index.ts elsa_analyze_wallet '{"wallet_address": "0x..."}'
Entrada:
wallet_address(cadena, obligatorio): Dirección de la billetera a analizar
elsa_get_swap_quote
Obtener una cotización de intercambio con enrutamiento óptimo.
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
}'
Entrada:
from_chain(cadena, obligatorio): Cadena de origenfrom_token(cadena, obligatorio): Dirección del token de origenfrom_amount(cadena, obligatorio): Cantidad a intercambiarto_chain(cadena, obligatorio): Cadena de destinoto_token(cadena, obligatorio): Dirección del token de destinowallet_address(cadena, obligatorio): Dirección de la billeteraslippage(número, obligatorio): Tolerancia de deslizamiento (0-50)
elsa_execute_swap_dry_run
Simular un intercambio sin ejecutarlo. Devuelve un token de confirmación para la ejecución posterior confirmada.
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
}'
Salida incluye:
- Resultados de la simulación del intercambio
confirmation_token(si ELSA_REQUIRE_CONFIRMATION_TOKEN=true)- El token caduca después de ELSA_CONFIRMATION_TTL_SECONDS
elsa_budget_status
Verificar el uso actual del presupuesto y los límites restantes.
npx tsx scripts/index.ts elsa_budget_status '{}'
Salida:
spent_today_usd: Cantidad gastada hoyremaining_today_usd: Presupuesto diario restantecalls_last_minute: Número de llamadas recienteslast_calls: Detalles de llamadas recientes
elsa_get_limit_orders
Obtener todas las órdenes límite de una billetera.
npx tsx scripts/index.ts elsa_get_limit_orders '{"wallet_address": "0x...", "chain": "base"}'
Entrada:
wallet_address(cadena, obligatorio): Dirección de la billetera a consultarchain(cadena, opcional): Nombre de la cadena (por defecto: "base")
Salida:
orders: Arreglo de órdenes límite con estado, precios y vencimiento
elsa_get_perp_positions
Obtener posiciones perpetuas de una billetera.
npx tsx scripts/index.ts elsa_get_perp_positions '{"wallet_address": "0x..."}'
Entrada:
wallet_address(cadena, obligatorio): Dirección de la billetera a consultar
Salida:
positions: Arreglo de posiciones perpetuas abiertas con PnL, apalancamiento y precios de liquidacióntotal_unrealized_pnl: Suma de ganancias/pérdidas no realizadastotal_margin: Margen total utilizado
elsa_get_transaction_history
Obtener historial de transacciones de una billetera.
npx tsx scripts/index.ts elsa_get_transaction_history '{"wallet_address": "0x...", "chain": "base", "limit": 20}'
Entrada:
wallet_address(cadena, obligatorio): Dirección de la billetera a consultarchain(cadena, opcional): Filtrar por cadenalimit(número, opcional): Máximo de resultados (por defecto: 20, máximo: 100)
Salida:
transactions: Arreglo de transacciones con detalles, transferencias de tokens y estado
Herramientas de Ejecución (Requieren ELSA_ENABLE_EXECUTION_TOOLS=true)
elsa_execute_swap_confirmed
Ejecutar un intercambio confirmado. Requiere simulación previa y token de confirmación.
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
Verificar el estado de un pipeline/transacción.
npx tsx scripts/index.ts elsa_pipeline_get_status '{"pipeline_id": "pip_123456789"}'
elsa_pipeline_submit_tx_hash
Enviar un hash de transacción firmada al pipeline.
npx tsx scripts/index.ts elsa_pipeline_submit_tx_hash '{"task_id": "task_123", "tx_hash": "0x..."}'
elsa_pipeline_run_and_wait
Orquestar la ejecución completa del pipeline con firma y envío automáticos.
npx tsx scripts/index.ts elsa_pipeline_run_and_wait '{
"pipeline_id": "pip_123456789",
"timeout_seconds": 120,
"poll_interval_seconds": 2,
"mode": "local_signer"
}'
Modos:
local_signer: Firma y transmite transacciones usando TRADE_PRIVATE_KEYexternal_signer: Devuelve tx_data sin firmar para firma externa
elsa_create_limit_order
Crear una orden límite para ejecutar cuando el precio alcance el objetivo.
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
}'
Entrada:
wallet_address(cadena, obligatorio): Dirección de la billeterachain(cadena, obligatorio): Nombre de la cadenafrom_token(cadena, obligatorio): Token a venderto_token(cadena, obligatorio): Token a comprarfrom_amount(cadena, obligatorio): Cantidad a venderlimit_price(cadena, obligatorio): Precio objetivo para activar la ejecuciónexpiry_hours(número, opcional): Horas hasta que caduque la orden (por defecto: 24, máximo: 720)
elsa_cancel_limit_order
Cancelar una orden límite existente.
ELSA_ENABLE_EXECUTION_TOOLS=true npx tsx scripts/index.ts elsa_cancel_limit_order '{
"wallet_address": "0x...",
"order_id": "order_123",
"chain": "base"
}'
Entrada:
wallet_address(cadena, obligatorio): Dirección de la billeteraorder_id(cadena, obligatorio): ID de la orden a cancelarchain(cadena, opcional): Nombre de la cadena (por defecto: "base")
elsa_open_perp_position
Abrir una posición de futuros perpetuos.
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"
}'
Entrada:
wallet_address(cadena, obligatorio): Dirección de la billeteramarket(cadena, obligatorio): Par de mercado (ej.: "ETH-USD", "BTC-USD")side(enumeración, obligatorio): "long" o "short"size_usd(cadena, obligatorio): Tamaño de la posición en USDleverage(número, opcional): Multiplicador de apalancamiento (por defecto: 1, máximo: 100)take_profit(cadena, opcional): Precio de take profitstop_loss(cadena, opcional): Precio de stop loss
elsa_close_perp_position
Cerrar una posición perpetua abierta.
ELSA_ENABLE_EXECUTION_TOOLS=true npx tsx scripts/index.ts elsa_close_perp_position '{
"wallet_address": "0x...",
"position_id": "pos_123",
"close_percentage": 100
}'
Entrada:
wallet_address(cadena, obligatorio): Dirección de la billeteraposition_id(cadena, obligatorio): ID de la posición a cerrarclose_percentage(número, opcional): Porcentaje a cerrar (por defecto: 100, rango: 1-100)
Cadenas Compatibles
- base (por defecto)
- ethereum
- arbitrum
- optimism
- polygon
- bsc
- avalanche
- zksync
Costos de API
| Herramienta | Costo Estimado |
|---|---|
| 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 |
Próximamente
- APIs de Polymarket - Comercio de mercados de predicción y datos