Communitygithub.com

HeyElsa/elsa-openclaw

DeFi-Tools für Portfolio-Analyse, Token-Suche und Swap-Ausführung über die Elsa API mit x402-Mikrozahlungen

Was ist elsa-openclaw?

Diese Skill bietet Zugriff auf die Elsa DeFi API für umfassende Portfolioverwaltung, Token-Analyse und den Handel (Swaps) über verschiedene Blockchains. Sie ist für KI-Agenten wie Claude Code oder Cursor konzipiert und nutzt x402-Mikrozahlungen, um API-Aufrufe sekundengenau abzurechnen. Die Skill umfasst sowohl lesende Tools (z. B. Token-Suche, Preise, Portfolios, Wallet-Analyse, Swap-Kurse) als auch ausführende Tools für Transaktionen (Swaps, Limit-Orders, Perpetual Futures). Ein mehrstufiger, sicherer Swap-Workflow (Angebot einholen → Trockentest → Benutzerbestätigung → Ausführung) stellt sicher, dass keine Transaktion ohne explizite Zustimmung des Benutzers durchgeführt wird. Für die Ausführung von Transaktionen wird die Umgebungsvariable `ELSA_ENABLE_EXECUTION_TOOLS=true` benötigt, und es sind Budgetkontrollen (max. 0,05 $ pro Aufruf, 2 $ pro Tag, 30 Aufrufe/Minute) integriert.

Funktioniert mit~Claude Code~Codex CLI~Cursor
npx skills add HeyElsa/elsa-openclaw

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

Elsa x402 DeFi-Tools

Diese Skill gewährt Zugriff auf die Elsa DeFi API für Portfolioverwaltung, Token-Analyse und Swap-Ausführung mithilfe von x402-Mikrozahlungen.

Standardarbeitsanweisung

Budgetkontrollen

  • Maximal 0,05 $ pro API-Aufruf (konfigurierbar)
  • Maximal 2,00 $ pro Tag (konfigurierbar)
  • Maximal 30 Aufrufe pro Minute (Ratenbegrenzung)
  • Das Tagesbudget wird um Mitternacht in der konfigurierten Zeitzone zurückgesetzt (Standard: UTC)

Empfohlener Swap-Ablauf (OpenClaw)

Bei der Ausführung von Swaps ist dieser 4-Schritte-Ablauf zu befolgen:

┌─────────────────────┐     ┌─────────────────────┐     ┌─────────────┐     ┌─────────────────────┐
│ 1. Angebot einholen │ ──▶ │ 2. Trockentest      │ ──▶ │ 3. Bestätigung│ ──▶ │ 4. Pipeline ausführen│
│ elsa_get_swap_quote  │     │ elsa_execute_swap_  │     │ [Benutzer    │     │ elsa_pipeline_run_  │
│                     │     │ dry_run             │     │  sagt „ja"]  │     │ and_wait            │
└─────────────────────┘     └─────────────────────┘     └─────────────┘     └─────────────────────┘

Schritt 1: Angebot einholen – Zeigt dem Benutzer, was er erhält

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
}'

Schritt 2: Trockentest – Erstellt eine Pipeline, erhält pipeline_id

npx tsx scripts/index.ts elsa_execute_swap_dry_run '{...gleiche Parameter...}'
# Gibt zurück: { "pipeline_id": "abc-123", "confirmation_token": "..." }

Schritt 3: Benutzerbestätigung – Ergebnisse präsentieren und auf explizites „Ja“ warten

Schritt 4: Pipeline ausführen – Transaktionen signieren und senden

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"
}'
# Automatisch: signiert approve-tx → sendet → signiert swap-tx → sendet → gibt tx-hashes zurück

Erforderliche Umgebungsvariablen

# Für x402-API-Zahlungen
PAYMENT_PRIVATE_KEY=0x...

# Zum Signieren von Swap-Transaktionen (optional – fällt auf PAYMENT_PRIVATE_KEY zurück)
TRADE_PRIVATE_KEY=0x...

# Ausführungswerkzeuge aktivieren
ELSA_ENABLE_EXECUTION_TOOLS=true

Kritische Regeln

  • NIE Swaps ausführen, ohne dem Benutzer zuvor das Angebot zu zeigen
  • NIE Ausführungswerkzeuge in einer Schleife aufrufen
  • NIE fortfahren, wenn Budgetlimits überschritten wurden
  • IMMER elsa_budget_status prüfen, wenn Unsicherheit über das verbleibende Budget besteht
  • IMMER zuerst den Trockentest-Modus für jede Swap-Operation verwenden

Werkzeugkatalog

Nur-Lese-Werkzeuge (immer verfügbar)

elsa_search_token

Suche nach Tokens auf unterstützten Blockchains.

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

Eingabe:

  • query (String, erforderlich): Token-Name, Symbol oder Adresse
  • limit (Zahl, optional): Maximale Ergebnisse (Standard: 10)

elsa_get_token_price

Aktuellen Preis eines Tokens abrufen.

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

Eingabe:

  • token_address (String, erforderlich): Token-Vertragsadresse
  • chain (String, optional): Chain-Name (Standard: "base")

elsa_get_balances

Token-Guthaben einer Wallet abrufen.

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

Eingabe:

  • wallet_address (String, erforderlich): Wallet-Adresse für die Abfrage

elsa_get_portfolio

Umfassende Portfolio-Analyse abrufen.

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

Eingabe:

  • wallet_address (String, erforderlich): Zu analysierende Wallet-Adresse

elsa_analyze_wallet

Wallet-Verhalten und Risikobewertung abrufen.

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

Eingabe:

  • wallet_address (String, erforderlich): Zu analysierende Wallet-Adresse

elsa_get_swap_quote

Ein Swap-Angebot mit optimaler Routenberechnung abrufen.

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
}'

Eingabe:

  • from_chain (String, erforderlich): Quell-Chain
  • from_token (String, erforderlich): Quell-Token-Adresse
  • from_amount (String, erforderlich): Zu swappender Betrag
  • to_chain (String, erforderlich): Ziel-Chain
  • to_token (String, erforderlich): Ziel-Token-Adresse
  • wallet_address (String, erforderlich): Wallet-Adresse
  • slippage (Zahl, erforderlich): Slippage-Toleranz (0–50)

elsa_execute_swap_dry_run

Simuliert einen Swap ohne Ausführung. Gibt einen Bestätigungstoken für die spätere bestätigte Ausführung zurück.

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
}'

Ausgabe enthält:

  • Ergebnisse der Swap-Simulation
  • confirmation_token (falls ELSA_REQUIRE_CONFIRMATION_TOKEN=true)
  • Token läuft nach ELSA_CONFIRMATION_TTL_SECONDS ab

elsa_budget_status

Prüft die aktuelle Budgetnutzung und die verbleibenden Limits.

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

Ausgabe:

  • spent_today_usd: Heute ausgegebener Betrag
  • remaining_today_usd: Verbleibendes Tagesbudget
  • calls_last_minute: Anzahl der letzten Aufrufe
  • last_calls: Details der letzten Aufrufe

elsa_get_limit_orders

Alle Limit-Orders einer Wallet abrufen.

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

Eingabe:

  • wallet_address (String, erforderlich): Wallet-Adresse für die Abfrage
  • chain (String, optional): Chain-Name (Standard: "base")

Ausgabe:

  • orders: Array von Limit-Orders mit Status, Preisen und Ablauf

elsa_get_perp_positions

Perpetual-Positionen einer Wallet abrufen.

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

Eingabe:

  • wallet_address (String, erforderlich): Wallet-Adresse für die Abfrage

Ausgabe:

  • positions: Array offener Perp-Positionen mit PnL, Hebel und Liquidationspreisen
  • total_unrealized_pnl: Summe nicht realisierter Gewinne/Verluste
  • total_margin: Verwendete Gesamtmargin

elsa_get_transaction_history

Transaktionshistorie einer Wallet abrufen.

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

Eingabe:

  • wallet_address (String, erforderlich): Wallet-Adresse für die Abfrage
  • chain (String, optional): Nach Chain filtern
  • limit (Zahl, optional): Maximale Ergebnisse (Standard: 20, max: 100)

Ausgabe:

  • transactions: Array von Transaktionen mit Details, Token-Transfers und Status

Ausführungswerkzeuge (erfordert ELSA_ENABLE_EXECUTION_TOOLS=true)

elsa_execute_swap_confirmed

Führt einen bestätigten Swap aus. Erfordert vorherigen Trockentest und Bestätigungstoken.

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

Status einer Pipeline/Transaktion prüfen.

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

elsa_pipeline_submit_tx_hash

Einen signierten Transaktions-Hash an die Pipeline übermitteln.

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

elsa_pipeline_run_and_wait

Orchestriert die vollständige Pipeline-Ausführung mit automatischem Signieren und Senden.

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

Modi:

  • local_signer: Signiert und sendet Transaktionen mit TRADE_PRIVATE_KEY
  • external_signer: Gibt unsignierte tx_data zur externen Signierung zurück

elsa_create_limit_order

Erstellt eine Limit-Order, die ausgeführt wird, wenn der Preis das Ziel erreicht.

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
}'

Eingabe:

  • wallet_address (String, erforderlich): Wallet-Adresse
  • chain (String, erforderlich): Chain-Name
  • from_token (String, erforderlich): Zu verkaufendes Token
  • to_token (String, erforderlich): Zu kaufendes Token
  • from_amount (String, erforderlich): Zu verkaufender Betrag
  • limit_price (String, erforderlich): Zielpreis für die Auslösung
  • expiry_hours (Zahl, optional): Stunden bis zum Ablauf der Order (Standard: 24, max: 720)

elsa_cancel_limit_order

Bricht eine bestehende Limit-Order ab.

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

Eingabe:

  • wallet_address (String, erforderlich): Wallet-Adresse
  • order_id (String, erforderlich): Zu stornierende Order-ID
  • chain (String, optional): Chain-Name (Standard: "base")

elsa_open_perp_position

Öffnet eine Perpetual-Futures-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"
}'

Eingabe:

  • wallet_address (String, erforderlich): Wallet-Adresse
  • market (String, erforderlich): Marktpaar (z. B. "ETH-USD", "BTC-USD")
  • side (Enum, erforderlich): "long" oder "short"
  • size_usd (String, erforderlich): Positionsgröße in USD
  • leverage (Zahl, optional): Hebelmultiplikator (Standard: 1, max: 100)
  • take_profit (String, optional): Take-Profit-Preis
  • stop_loss (String, optional): Stop-Loss-Preis

elsa_close_perp_position

Schließt eine offene Perpetual-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
}'

Eingabe:

  • wallet_address (String, erforderlich): Wallet-Adresse
  • position_id (String, erforderlich): Zu schließende Positions-ID
  • close_percentage (Zahl, optional): Zu schließender Prozentsatz (Standard: 100, Bereich: 1–100)

Unterstützte Chains

  • base (Standard)
  • ethereum
  • arbitrum
  • optimism
  • polygon
  • bsc
  • avalanche
  • zksync

API-Kosten

WerkzeugGeschätzte Kosten
elsa_search_token0,002 $
elsa_get_token_price0,002 $
elsa_get_balances0,002 $
elsa_get_portfolio0,002 $
elsa_analyze_wallet0,005 $
elsa_get_swap_quote0,002 $
elsa_execute_swap_dry_run0,005 $
elsa_get_limit_orders0,002 $
elsa_get_perp_positions0,002 $
elsa_get_transaction_history0,002 $
elsa_create_limit_order0,05 $
elsa_cancel_limit_order0,01 $
elsa_open_perp_position0,05 $
elsa_close_perp_position0,05 $
elsa_execute_swap_confirmed0,05 $

Bald verfügbar

  • Polymarket-APIs – Prognosemärkte-Handel und -Daten

Verwandte Skills