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_statusprü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 Adresselimit(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-Vertragsadressechain(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-Chainfrom_token(String, erforderlich): Quell-Token-Adressefrom_amount(String, erforderlich): Zu swappender Betragto_chain(String, erforderlich): Ziel-Chainto_token(String, erforderlich): Ziel-Token-Adressewallet_address(String, erforderlich): Wallet-Adresseslippage(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 Betragremaining_today_usd: Verbleibendes Tagesbudgetcalls_last_minute: Anzahl der letzten Aufrufelast_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 Abfragechain(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 Liquidationspreisentotal_unrealized_pnl: Summe nicht realisierter Gewinne/Verlustetotal_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 Abfragechain(String, optional): Nach Chain filternlimit(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_KEYexternal_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-Adressechain(String, erforderlich): Chain-Namefrom_token(String, erforderlich): Zu verkaufendes Tokento_token(String, erforderlich): Zu kaufendes Tokenfrom_amount(String, erforderlich): Zu verkaufender Betraglimit_price(String, erforderlich): Zielpreis für die Auslösungexpiry_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-Adresseorder_id(String, erforderlich): Zu stornierende Order-IDchain(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-Adressemarket(String, erforderlich): Marktpaar (z. B. "ETH-USD", "BTC-USD")side(Enum, erforderlich): "long" oder "short"size_usd(String, erforderlich): Positionsgröße in USDleverage(Zahl, optional): Hebelmultiplikator (Standard: 1, max: 100)take_profit(String, optional): Take-Profit-Preisstop_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-Adresseposition_id(String, erforderlich): Zu schließende Positions-IDclose_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
| Werkzeug | Geschätzte Kosten |
|---|---|
| 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 $ |
Bald verfügbar
- Polymarket-APIs – Prognosemärkte-Handel und -Daten