suwappu-dex

Par bankrbot · skills

Swaps de tokens cross-chain, cotations, portefeuille et prix sur 14 chaînes via le serveur MCP Suwappu DEX. Lecture seule par défaut ; l'exécution de swaps est optionnelle et soumise à validation.

npx skills add https://github.com/bankrbot/skills --skill suwappu-dex

Suwappu — Cross-chain DEX 🌸

Échangez, obtenez des devis et suivez les tokens sur 14 chaînes (12 EVM + Solana + TRON) via le serveur MCP hébergé de Suwappu. Le routage est automatique sur 10+ providers (Li.Fi, CoW Protocol, Jupiter, Wormhole, Across, CCTP, …). Cette skill encapsule le serveur en direct — aucun SDK ni code wrapper requis.

Setup (une commande)

  1. Obtenez une clé API gratuite :
    curl -X POST https://api.suwappu.bot/v1/agent/register \
      -H "Content-Type: application/json" -d '{"name":"my-openclaw"}'
    # -> sauvegardez la valeur suwappu_sk_...
    export SUWAPPU_API_KEY=suwappu_sk_...
  2. Enregistrez le serveur MCP avec OpenClaw. Lecture seule par défaut (exécution d'échange exclue) :
    openclaw mcp add suwappu \
      --url https://api.suwappu.bot/mcp \
      --transport streamable-http \
      --header "Authorization=Bearer $SUWAPPU_API_KEY" \
      --exclude execute_swap
    openclaw mcp probe suwappu      # devrait lister les tools
  3. Pour activer l'exécution d'échange, ré-ajoutez sans --exclude execute_swap sur un agent trading dédié seulement (voir Safety). Vérifiez avec openclaw mcp doctor.

Tools (en direct)

Lecture seule (sûr, aucun fonds ne bouge) :

  • get_quote <from> <to> <amount> <chain> — meilleure route, impact sur prix, gas, frais, expiration
  • get_prices <token> [chain] — prix USD + variation 24h
  • get_portfolio [chain] — soldes + valeurs USD sur les chaînes
  • list_chains / list_tokens <chain> — chaînes supportées / tokens populaires
  • get_tempo_tokens — tokens tendance
  • browse_mpp_directory — répertoire marché/provider
  • predict_markets / predict_market_detail — marchés de prédiction style Polymarket

Modification d'état (verrouillé, opt-in) :

  • execute_swap <quote_id> — exécute un devis précédemment retourné. Exclu sauf activation explicite.

Flux typique

  1. list_chains → voir ce qui est disponible
  2. get_quote ETH USDC 0.1 base → meilleure route (retourne un quote_id)
  3. (agent trading seulement) confirmer avec l'utilisateur → execute_swap <quote_id>
  4. get_portfolio → vérifier que c'est arrivé

Exemples

  • "Quote 0.5 ETH to USDC on Base" → get_quote
  • "What's my portfolio worth across chains?" → get_portfolio
  • "Best price to bridge 500 USDC to Arbitrum" → get_quote

Safety

  • Lecture seule par défaut. execute_swap est exclu via --exclude et ne doit être activé que sur un agent trading isolé avec allowlisting explicite de tools (agents.json).
  • L'agent propose, l'utilisateur approuve. Toujours get_quote d'abord, afficher la route/impact sur prix, et exiger la confirmation de l'utilisateur avant tout execute_swap. Préserver le quote_id d'un bout à l'autre pour audit.
  • Non-custodial. Les clés vivent dans les enclaves TEE Turnkey ; Suwappu applique 2FA + limites de dépense par swap/horaire/quotidien + simulation de tx côté serveur — ces garde-fous tiennent même si l'agent se trompe.
  • Ne jamais mettre SUWAPPU_API_KEY dans des fichiers commités — passez-la en tant que var env / SecretRef.

Frais & docs

0,3% par swap, gas depuis le solde du wallet, aucun abonnement. API complète : https://api.suwappu.bot/docs

Skills similaires