Outils DeFi Elsa x402
Cette compétence donne accès à l'API DeFi Elsa pour la gestion de portefeuille, l'analyse de tokens et l'exécution d'échanges utilisant les micropaiements x402.
Procédure Opérationnelle Standard
Contrôles Budgétaires
- Maximum 0,05 $ par appel API (configurable)
- Maximum 2,00 $ par jour (configurable)
- Limite de 30 appels par minute
- Le budget quotidien se réinitialise à minuit dans le fuseau horaire configuré (par défaut : UTC)
Flux d'Échange Recommandé (OpenClaw)
Lors de l'exécution d'échanges, suivez ce flux en 4 étapes :
┌─────────────────────┐ ┌─────────────────────┐ ┌─────────────┐ ┌─────────────────────┐
│ 1. Obtenir un Devis │ ──▶ │ 2. Simulation │ ──▶ │ 3. Confirmer│ ──▶ │ 4. Exécuter le Pipeline │
│ elsa_get_swap_quote │ │ elsa_execute_swap_ │ │ [L'utilisateur│ │ elsa_pipeline_run_ │
│ │ │ dry_run │ │ dit "oui"] │ │ and_wait │
└─────────────────────┘ └─────────────────────┘ └─────────────┘ └─────────────────────┘
Étape 1 : Obtenir un Devis - Montrer à l'utilisateur ce qu'il recevra
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
}'
Étape 2 : Simulation - Créer le pipeline, obtenir pipeline_id
npx tsx scripts/index.ts elsa_execute_swap_dry_run '{...mêmes paramètres...}'
# Retourne : { "pipeline_id": "abc-123", "confirmation_token": "..." }
Étape 3 : Confirmation de l'Utilisateur - Présenter les résultats et attendre un "oui" explicite
Étape 4 : Exécuter le Pipeline - Signer et diffuser les transactions
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"
}'
# Automatiquement : signe la tx d'approbation → soumet → signe la tx d'échange → soumet → retourne les hachages de tx
Variables d'Environnement Requises
# Pour les paiements API x402
PAYMENT_PRIVATE_KEY=0x...
# Pour signer les transactions d'échange (optionnel - utilise PAYMENT_PRIVATE_KEY par défaut)
TRADE_PRIVATE_KEY=0x...
# Activer les outils d'exécution
ELSA_ENABLE_EXECUTION_TOOLS=true
Règles Critiques
- NE JAMAIS exécuter d'échanges sans d'abord montrer le devis à l'utilisateur
- NE JAMAIS appeler les outils d'exécution en boucle
- NE JAMAIS procéder si les limites budgétaires sont dépassées
- TOUJOURS vérifier
elsa_budget_statusen cas de doute sur le budget restant - TOUJOURS utiliser le mode simulation d'abord pour toute opération d'échange
Catalogue d'Outils
Outils en Lecture Seule (Toujours Disponibles)
elsa_search_token
Rechercher des tokens sur les blockchains prises en charge.
npx tsx scripts/index.ts elsa_search_token '{"query": "USDC", "limit": 5}'
Entrée :
query(chaîne, obligatoire) : Nom, symbole ou adresse du tokenlimit(nombre, optionnel) : Nombre maximal de résultats (défaut : 10)
elsa_get_token_price
Obtenir le prix actuel d'un token.
npx tsx scripts/index.ts elsa_get_token_price '{"token_address": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "chain": "base"}'
Entrée :
token_address(chaîne, obligatoire) : Adresse du contrat du tokenchain(chaîne, optionnel) : Nom de la chaîne (défaut : "base")
elsa_get_balances
Obtenir les soldes de tokens pour un portefeuille.
npx tsx scripts/index.ts elsa_get_balances '{"wallet_address": "0x..."}'
Entrée :
wallet_address(chaîne, obligatoire) : Adresse du portefeuille à interroger
elsa_get_portfolio
Obtenir une analyse complète du portefeuille.
npx tsx scripts/index.ts elsa_get_portfolio '{"wallet_address": "0x..."}'
Entrée :
wallet_address(chaîne, obligatoire) : Adresse du portefeuille à analyser
elsa_analyze_wallet
Obtenir une évaluation du comportement et des risques du portefeuille.
npx tsx scripts/index.ts elsa_analyze_wallet '{"wallet_address": "0x..."}'
Entrée :
wallet_address(chaîne, obligatoire) : Adresse du portefeuille à analyser
elsa_get_swap_quote
Obtenir un devis d'échange avec le routage optimal.
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
}'
Entrée :
from_chain(chaîne, obligatoire) : Chaîne sourcefrom_token(chaîne, obligatoire) : Adresse du token sourcefrom_amount(chaîne, obligatoire) : Montant à échangerto_chain(chaîne, obligatoire) : Chaîne de destinationto_token(chaîne, obligatoire) : Adresse du token de destinationwallet_address(chaîne, obligatoire) : Adresse du portefeuilleslippage(nombre, obligatoire) : Tolérance de glissement (0-50)
elsa_execute_swap_dry_run
Simuler un échange sans exécution. Retourne un jeton de confirmation pour une exécution ultérieure confirmée.
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
}'
Résultat inclus :
- Résultats de la simulation d'échange
confirmation_token(siELSA_REQUIRE_CONFIRMATION_TOKEN=true)- Le jeton expire après
ELSA_CONFIRMATION_TTL_SECONDS
elsa_budget_status
Vérifier l'utilisation actuelle du budget et les limites restantes.
npx tsx scripts/index.ts elsa_budget_status '{}'
Résultat :
spent_today_usd: Montant dépensé aujourd'huiremaining_today_usd: Budget quotidien restantcalls_last_minute: Nombre d'appels récentslast_calls: Détails des appels récents
elsa_get_limit_orders
Obtenir tous les ordres limités pour un portefeuille.
npx tsx scripts/index.ts elsa_get_limit_orders '{"wallet_address": "0x...", "chain": "base"}'
Entrée :
wallet_address(chaîne, obligatoire) : Adresse du portefeuille à interrogerchain(chaîne, optionnel) : Nom de la chaîne (défaut : "base")
Résultat :
orders: Tableau d'ordres limités avec statut, prix et expiration
elsa_get_perp_positions
Obtenir les positions perpétuelles pour un portefeuille.
npx tsx scripts/index.ts elsa_get_perp_positions '{"wallet_address": "0x..."}'
Entrée :
wallet_address(chaîne, obligatoire) : Adresse du portefeuille à interroger
Résultat :
positions: Tableau des positions perpétuelles ouvertes avec PnL, effet de levier et prix de liquidationtotal_unrealized_pnl: Somme des profits/pertes non réaliséstotal_margin: Marge totale utilisée
elsa_get_transaction_history
Obtenir l'historique des transactions pour un portefeuille.
npx tsx scripts/index.ts elsa_get_transaction_history '{"wallet_address": "0x...", "chain": "base", "limit": 20}'
Entrée :
wallet_address(chaîne, obligatoire) : Adresse du portefeuille à interrogerchain(chaîne, optionnel) : Filtrer par chaînelimit(nombre, optionnel) : Nombre maximal de résultats (défaut : 20, max : 100)
Résultat :
transactions: Tableau de transactions avec détails, transferts de tokens et statut
Outils d'Exécution (Nécessite ELSA_ENABLE_EXECUTION_TOOLS=true)
elsa_execute_swap_confirmed
Exécuter un échange confirmé. Nécessite une simulation préalable et un jeton de confirmation.
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
Vérifier le statut d'un pipeline/transaction.
npx tsx scripts/index.ts elsa_pipeline_get_status '{"pipeline_id": "pip_123456789"}'
elsa_pipeline_submit_tx_hash
Soumettre un hachage de transaction signé au pipeline.
npx tsx scripts/index.ts elsa_pipeline_submit_tx_hash '{"task_id": "task_123", "tx_hash": "0x..."}'
elsa_pipeline_run_and_wait
Orchestrer l'exécution complète du pipeline avec signature et soumission automatiques.
npx tsx scripts/index.ts elsa_pipeline_run_and_wait '{
"pipeline_id": "pip_123456789",
"timeout_seconds": 120,
"poll_interval_seconds": 2,
"mode": "local_signer"
}'
Modes :
local_signer: Signe et diffuse les transactions en utilisantTRADE_PRIVATE_KEYexternal_signer: Retourne lestx_datanon signées pour signature externe
elsa_create_limit_order
Créer un ordre limité qui s'exécute lorsque le prix atteint la cible.
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
}'
Entrée :
wallet_address(chaîne, obligatoire) : Adresse du portefeuillechain(chaîne, obligatoire) : Nom de la chaînefrom_token(chaîne, obligatoire) : Token à vendreto_token(chaîne, obligatoire) : Token à acheterfrom_amount(chaîne, obligatoire) : Montant à vendrelimit_price(chaîne, obligatoire) : Prix cible pour déclencher l'exécutionexpiry_hours(nombre, optionnel) : Heures avant expiration de l'ordre (défaut : 24, max : 720)
elsa_cancel_limit_order
Annuler un ordre limité existant.
ELSA_ENABLE_EXECUTION_TOOLS=true npx tsx scripts/index.ts elsa_cancel_limit_order '{
"wallet_address": "0x...",
"order_id": "order_123",
"chain": "base"
}'
Entrée :
wallet_address(chaîne, obligatoire) : Adresse du portefeuilleorder_id(chaîne, obligatoire) : ID de l'ordre à annulerchain(chaîne, optionnel) : Nom de la chaîne (défaut : "base")
elsa_open_perp_position
Ouvrir une position perpétuelle à terme.
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"
}'
Entrée :
wallet_address(chaîne, obligatoire) : Adresse du portefeuillemarket(chaîne, obligatoire) : Paire de marché (ex. "ETH-USD", "BTC-USD")side(enum, obligatoire) : "long" ou "short"size_usd(chaîne, obligatoire) : Taille de la position en USDleverage(nombre, optionnel) : Multiplicateur de levier (défaut : 1, max : 100)take_profit(chaîne, optionnel) : Prix de take profitstop_loss(chaîne, optionnel) : Prix de stop loss
elsa_close_perp_position
Fermer une position perpétuelle ouverte.
ELSA_ENABLE_EXECUTION_TOOLS=true npx tsx scripts/index.ts elsa_close_perp_position '{
"wallet_address": "0x...",
"position_id": "pos_123",
"close_percentage": 100
}'
Entrée :
wallet_address(chaîne, obligatoire) : Adresse du portefeuilleposition_id(chaîne, obligatoire) : ID de la position à fermerclose_percentage(nombre, optionnel) : Pourcentage à fermer (défaut : 100, plage : 1-100)
Chaînes Prises en Charge
- base (par défaut)
- ethereum
- arbitrum
- optimism
- polygon
- bsc
- avalanche
- zksync
Coûts de l'API
| Outil | Coût Estimé |
|---|---|
| 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 $ |
À Venir
- APIs Polymarket - Trading et données de marchés prédictifs