Communitygithub.com

Elsa x402 DeFi Tools

Herramientas DeFi para análisis de carteras, búsqueda de tokens y ejecución de intercambios mediante la API de Elsa con micropagos x402.

¿Qué es Elsa x402 DeFi Tools?

Este skill proporciona acceso a la API de Elsa para la gestión de carteras DeFi, análisis de tokens y ejecución de intercambios (swaps) a través de micropagos x402, lo que permite a los agentes de IA realizar operaciones financieras de manera automatizada y segura. Es compatible con plataformas como Claude Code, Cursor y Codex, y se enfoca en cadenas como Base, Ethereum, Arbitrum, y más. El skill ofrece herramientas de solo lectura, como búsqueda de tokens, precios, balances y análisis de cartera, así como herramientas de ejecución para intercambios, órdenes límite y posiciones perpetuas, siempre con un flujo de cuatro pasos que incluye cotización, simulación, confirmación del usuario y ejecución final. Incluye controles de presupuesto configurables (máximo $0.05 por llamada, $2.00 por día) y un límite de 30 llamadas por minuto para evitar sobrecostos. La ejecución de intercambios requiere claves privadas para pagos y firma de transacciones, y se recomienda usar siempre el modo de simulación (dry-run) antes de cualquier operación real.

Compatible con~Claude Code~Codex CLI~Cursor
npx skills add HeyElsa/elsa-openclaw

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

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_status si 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 token
  • limit (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 token
  • chain (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 origen
  • from_token (cadena, obligatorio): Dirección del token de origen
  • from_amount (cadena, obligatorio): Cantidad a intercambiar
  • to_chain (cadena, obligatorio): Cadena de destino
  • to_token (cadena, obligatorio): Dirección del token de destino
  • wallet_address (cadena, obligatorio): Dirección de la billetera
  • slippage (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 hoy
  • remaining_today_usd: Presupuesto diario restante
  • calls_last_minute: Número de llamadas recientes
  • last_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 consultar
  • chain (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ón
  • total_unrealized_pnl: Suma de ganancias/pérdidas no realizadas
  • total_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 consultar
  • chain (cadena, opcional): Filtrar por cadena
  • limit (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_KEY
  • external_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 billetera
  • chain (cadena, obligatorio): Nombre de la cadena
  • from_token (cadena, obligatorio): Token a vender
  • to_token (cadena, obligatorio): Token a comprar
  • from_amount (cadena, obligatorio): Cantidad a vender
  • limit_price (cadena, obligatorio): Precio objetivo para activar la ejecución
  • expiry_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 billetera
  • order_id (cadena, obligatorio): ID de la orden a cancelar
  • chain (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 billetera
  • market (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 USD
  • leverage (número, opcional): Multiplicador de apalancamiento (por defecto: 1, máximo: 100)
  • take_profit (cadena, opcional): Precio de take profit
  • stop_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 billetera
  • position_id (cadena, obligatorio): ID de la posición a cerrar
  • close_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

HerramientaCosto 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

Skills relacionados