Communitygithub.com

Elsa x402 Outils DeFi

Outils DeFi pour l'analyse de portefeuille, la recherche de tokens et l'exécution d'échanges via l'API Elsa avec micropaiements x402.

Qu'est-ce que Elsa x402 Outils DeFi ?

Cette compétence fournit une suite d'outils DeFi complets pour l'analyse de portefeuille, la recherche de tokens et l'exécution d'échanges, alimentée par l'API Elsa et les micropaiements x402. Elle est conçue pour les agents IA et les développeurs, prenant en charge plusieurs blockchains comme Ethereum (Base, Ethereum, Arbitrum, Optimism, Polygon, BSC, Avalanche, zkSync). Le système met l'accent sur la sécurité avec un flux d'échange recommandé en 4 étapes (obtention de devis, simulation, confirmation, exécution) et des contrôles de budget configurables (max 0,05 $ par appel, 2,00 $ par jour, 30 appels par minute). Les outils sont divisés en catégories en lecture seule (toujours disponibles, par exemple pour la recherche de tokens, les prix, les soldes, les devis) et les outils d'exécution (nécessitant `ELSA_ENABLE_EXECUTION_TOOLS=true`, par exemple pour l'exécution d'échanges, les ordres limités, les positions perpétuelles). Les coûts de l'API varient de 0,002 $ à 0,05 $ selon l'outil, avec des limites strictes pour éviter les boucles involontaires ou les dépassements de budget. La compétence s'intègre à des plateformes comme Claude Code, Cursor et Codex, offrant une interface en ligne de commande via `npx tsx scripts/index.ts`.

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

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

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_status en 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 token
  • limit (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 token
  • chain (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 source
  • from_token (chaîne, obligatoire) : Adresse du token source
  • from_amount (chaîne, obligatoire) : Montant à échanger
  • to_chain (chaîne, obligatoire) : Chaîne de destination
  • to_token (chaîne, obligatoire) : Adresse du token de destination
  • wallet_address (chaîne, obligatoire) : Adresse du portefeuille
  • slippage (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 (si ELSA_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'hui
  • remaining_today_usd : Budget quotidien restant
  • calls_last_minute : Nombre d'appels récents
  • last_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 à interroger
  • chain (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 liquidation
  • total_unrealized_pnl : Somme des profits/pertes non réalisés
  • total_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 à interroger
  • chain (chaîne, optionnel) : Filtrer par chaîne
  • limit (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 utilisant TRADE_PRIVATE_KEY
  • external_signer : Retourne les tx_data non 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 portefeuille
  • chain (chaîne, obligatoire) : Nom de la chaîne
  • from_token (chaîne, obligatoire) : Token à vendre
  • to_token (chaîne, obligatoire) : Token à acheter
  • from_amount (chaîne, obligatoire) : Montant à vendre
  • limit_price (chaîne, obligatoire) : Prix cible pour déclencher l'exécution
  • expiry_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 portefeuille
  • order_id (chaîne, obligatoire) : ID de l'ordre à annuler
  • chain (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 portefeuille
  • market (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 USD
  • leverage (nombre, optionnel) : Multiplicateur de levier (défaut : 1, max : 100)
  • take_profit (chaîne, optionnel) : Prix de take profit
  • stop_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 portefeuille
  • position_id (chaîne, obligatoire) : ID de la position à fermer
  • close_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

OutilCoût Estimé
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 $

À Venir

  • APIs Polymarket - Trading et données de marchés prédictifs

Skills associés