Mobula - Intelligence de Données Crypto Multi-Chaînes

Que fait Mobula - Intelligence de Données Crypto Multi-Chaînes ?

Données de marché crypto en temps réel, suivi de portefeuilles et analyses on-chain sur 88+ blockchains. Prix de qualité oracle utilisés par Chainlink, Supra et API3.

Quand Utiliser Cette Compétence

À UTILISER QUAND l'utilisateur :

• Demande le prix, le volume, la capitalisation boursière ou la variation de prix d'un token
• Veut vérifier les avoirs ou la valeur d'un portefeuille
• A besoin de données de prix historiques pour des graphiques ou analyses
• Mentionne une adresse de contrat et veut des informations sur le token
• Demande des tokens sur des chaînes spécifiques (Base, Arbitrum, Solana, etc.)
• Veut un aperçu de portefeuille multi-chaînes
• A besoin de données batch sur plusieurs tokens à la fois
• Demande la liquidité, l'ATH, l'ATL ou le volume de trading d'un token
• Veut surveiller des portefeuilles de baleines ou des transactions importantes
• A besoin de trouver de nouveaux tokens correspondant à des critères spécifiques

NE PAS UTILISER QUAND :

• L'utilisateur veut exécuter des transactions (utiliser la compétence bankr à la place)
• L'utilisateur veut des devis d'échange DEX (utiliser la compétence defi)
• L'utilisateur veut des données spécifiques à un échange (utiliser les compétences okx/binance)

---

Fonctionnalités Principales

1. Données de Marché (mobula_market_data)

Endpoint : GET https://api.mobula.io/api/1/market/data

Obtenez le prix, le volume, la capitalisation boursière et la liquidité en temps réel pour n'importe quel token sur toutes les chaînes prises en charge.

Paramètres :

• asset (obligatoire) : Nom, symbole ou adresse de contrat du token
  • Exemples : "Bitcoin", "ETH", "0x532f27101965dd16442e59d40670faf5ebb142e4"
• blockchain (optionnel) : Chaîne spécifique à interroger
  • Exemples : "base", "arbitrum", "ethereum", "solana", "polygon"

Retourne :

• Prix actuel (USD)
• Variations de prix : 1h, 24h, 7j, 30j (pourcentage et absolu)
• Volume (24h)
• Capitalisation boursière
• Valorisation totalement diluée
• Liquidité
• Plus haut historique (ATH) et plus bas historique (ATL) avec dates
• Offre totale, offre en circulation

Exemples d'utilisation :

• "Quel est le prix du Bitcoin ?"
• "Affiche les données de marché de BRETT sur Base"
• "Obtenir les données pour le contrat 0x532f27101965dd16442e59d40670faf5ebb142e4"
• "Est-ce que l'ETH pompe ou descend en ce moment ?"
• "Quelle est la capitalisation boursière du PEPE ?"

Quand l'utiliser :

• L'utilisateur demande le prix d'un token
• L'utilisateur veut savoir si quelque chose pompe/descend
• Analyser les fondamentaux du token (mcap, liquidité, volume)
• Comparer des tokens
• Configurer des alertes de prix

---

2. Portefeuille (mobula_wallet_portfolio)

Endpoint : GET https://api.mobula.io/api/1/wallet/portfolio

Obtenez le portefeuille complet pour n'importe quelle adresse sur les 88 chaînes en un seul appel.

Paramètres :

• wallet (obligatoire) : Adresse du portefeuille
  • Format : "0x..." ou nom ENS (ex. "vitalik.eth")
• blockchains (optionnel) : Liste séparée par des virgules pour filtrer des chaînes spécifiques
  • Par défaut : toutes les chaînes
• cache (optionnel) : Utiliser les données en cache (plus rapide, légèrement moins fraîches)

Retourne :

• Tous les tokens détenus avec :
  • Nom, symbole, adresse du token
  • Solde (montant et valeur en USD)
  • Prix actuel
  • Variation de prix 24h
  • Profit/perte estimé
  • Chaîne
• Valeur totale du portefeuille (USD)
• Répartition du portefeuille par token (pourcentages)
• NFTs (si présents)

Exemples d'utilisation :

• "Affiche le portefeuille pour l'adresse 0x123..."
• "Quels tokens vitalik.eth détient-il ?"
• "Vérifier le solde de mon portefeuille"
• "Quelle est la valeur totale de ce portefeuille ?"
• "Affiche les 5 principaux avoirs de ce portefeuille"

Quand l'utiliser :

• Suivi de portefeuille
• Analyse de portefeuille
• Vérifier les avoirs avant/après des transactions
• Surveiller la répartition
• Configurer des alertes de portefeuille

---

3. Données de Prix Historiques (mobula_market_history)

Endpoint : GET https://api.mobula.io/api/1/market/history

Obtenez les données de prix historiques pour n'importe quel token avec des plages horaires flexibles.

Paramètres :

• asset (obligatoire) : Nom, symbole ou adresse du token
• from (optionnel) : Timestamp de début (secondes Unix)
• to (optionnel) : Timestamp de fin (secondes Unix)
• period (optionnel) : Granularité des données
  • Options : "1h", "1d", "1w"
  • Par défaut : sélectionné automatiquement en fonction de la plage horaire

Retourne :

• Tableau de points de prix avec timestamps
• Volume à chaque point
• Capitalisation boursière à chaque point

Exemples d'utilisation :

• "Affiche le prix de l'ETH pour les 30 derniers jours"
• "Quel était le prix de ce token le 1er janvier ?"
• "Ce token a-t-il pompé ou descendu cette semaine ?"
• "Graphique du mouvement de prix du BTC sur les 7 derniers jours"

Quand l'utiliser :

• Analyser les tendances
• Calculer le PnL historique
• Comparer l'action des prix sur différentes périodes
• Identifier des motifs (breakouts, supports, résistances)

---

4. Transactions Récentes (mobula_market_trades)

Endpoint : GET https://api.mobula.io/api/1/market/trades

Flux de transactions en direct pour n'importe quel token sur tous les DEX et chaînes.

Paramètres :

• asset (obligatoire) : Nom, symbole ou adresse du token
• limit (optionnel) : Nombre de transactions à retourner (par défaut : 50, max : 300)

Retourne :

• Tableau des transactions récentes avec :
  • Timestamp
  • Type (achat/vente)
  • Montant (tokens et USD)
  • Prix lors de la transaction
  • Adresse du portefeuille (acheteur/vendeur)
  • DEX et chaîne
  • Hash de transaction

Exemples d'utilisation :

• "Affiche les transactions récentes pour ce token"
• "Qui achète du PEPE en ce moment ?"
• "Y a-t-il des mouvements de baleines sur ce token ?"
• "Quelles sont les 10 dernières transactions sur ce token ?"

Quand l'utiliser :

• Surveillance de baleines
• Détection d'activité inhabituelle (gros achats/ventes)
• Vérification du volume
• Analyse de sentiment (plus d'achats que de ventes)

---

5. Historique des Transactions du Portefeuille (mobula_wallet_transactions)

Endpoint : GET https://api.mobula.io/api/1/wallet/transactions

Historique complet des transactions pour n'importe quel portefeuille sur toutes les chaînes.

Paramètres :

• wallet (obligatoire) : Adresse du portefeuille
• from (optionnel) : Timestamp de début
• to (optionnel) : Timestamp de fin
• asset (optionnel) : Filtrer par token spécifique
• limit (optionnel) : Nombre de transactions (par défaut : 100)

Retourne :

• Tableau de transactions :
  • Type (swap, transfert, mint, burn)
  • Tokens impliqués (de/vers)
  • Montants
  • Valeurs USD au moment de la transaction
  • Timestamp
  • Chaîne
  • Hash de transaction

Exemples d'utilisation :

• "Qu'a acheté ce portefeuille récemment ?"
• "Affiche les 10 dernières transactions pour 0x123..."
• "Quand ce portefeuille a-t-il vendu de l'ETH pour la dernière fois ?"
• "Suivre l'activité de cette baleine"

Quand l'utiliser :

• Surveillance de portefeuille
• Suivi de baleines
• Détection de motifs (ce qu'ils achètent/vendent)
• Vérification de transactions

---

6. Données Multi-Actifs (mobula_market_multi)

Endpoint : GET https://api.mobula.io/api/1/market/multi-data

Obtenez les données de marché pour plusieurs tokens en une seule requête (endpoint batch).

Paramètres :

• assets (obligatoire) : Liste séparée par des virgules de noms/symboles/adresses de tokens
  • Exemple : "Bitcoin,Ethereum,Solana" ou "BTC,ETH,SOL"
  • Max : 500 tokens par requête

Retourne :

• Mêmes données que mobula_market_data mais pour plusieurs tokens
• Efficace pour l'analyse de portefeuille, listes de surveillance, aperçus du marché

Exemples d'utilisation :

• "Compare la performance de BTC, ETH et SOL aujourd'hui"
• "Affiche les principaux mouvements de ma liste de surveillance"
• "Obtenir les prix pour ces 10 tokens : [liste]"

Quand l'utiliser :

• Valorisation de portefeuille
• Mises à jour de liste de surveillance
• Aperçu du marché (top coins)
• Vérifications batch de prix

---

7. Métadonnées du Token (mobula_metadata)

Endpoint : GET https://api.mobula.io/api/1/metadata

Obtenez les métadonnées détaillées pour n'importe quel token.

Paramètres :

• asset (obligatoire) : Nom, symbole ou adresse du token

Retourne :

• Nom, symbole, logo
• Description
• Liens vers le site web, Twitter, Telegram, Discord
• Adresses de contrat sur toutes les chaînes
• Date de lancement
• Catégories/tags

Exemples d'utilisation :

• "Parle-moi de ce token"
• "Quel est le site web de ce projet ?"
• "Où puis-je trouver leur communauté ?"

Quand l'utiliser :

• Recherche sur de nouveaux tokens
• Vérification de légitimité
• Trouver des liens officiels

---

Authentification

Requis : Toutes les requêtes API nécessitent une authentification via clé API.

Configuration :

1. Obtenez une clé API gratuite sur https://mobula.io (100 requêtes/minute niveau gratuit)
2. Définissez la variable d'environnement :

   export MOBULA_API_KEY="votre_cle_ici"
   

3. Redémarrez l'agent OpenClaw

Format de l'en-tête :

Authorization: ${MOBULA_API_KEY}

Si l'authentification échoue (401/403) :

• Vérifiez que la clé est définie : echo $MOBULA_API_KEY
• Régénérez la clé sur https://mobula.io si elle a expiré
• Vérifiez les limites de taux (100 req/min gratuit, passez à une version supérieure pour plus)

---

Confidentialité et Sécurité

IMPORTANT - À Lire Avant d'Utiliser :

Ce à Quoi Cette Compétence Accède

• Données blockchain publiques uniquement : Adresses de portefeuille, prix de tokens, historique des transactions
• Aucune clé privée : Ne fournissez jamais de clés privées, phrases de récupération ou mots de passe à cette compétence
• Aucune information d'identification sensible : La compétence nécessite uniquement la clé API Mobula (accès aux données publiques)

Confidentialité des Adresses de Portefeuille

• Les adresses de portefeuille interrogées via cette compétence sont envoyées à l'API Mobula (https://api.mobula.io)
• Interroger une adresse de portefeuille révèle ses avoirs publiquement (les données on-chain sont déjà publiques)
• Utilisez uniquement des adresses de portefeuille publiques que vous êtes à l'aise de partager
• N'entrez jamais d'adresses que vous souhaitez garder privées ou qui sont liées à votre identité

Portée de la Clé API

• Les clés API Mobula fournissent un accès en lecture seule aux données blockchain publiques
• Les clés peuvent être restreintes, révoquées et régénérées sur https://mobula.io
• Niveau gratuit : 100 requêtes/minute
• Envisagez d'utiliser une clé API séparée pour les tests par rapport à la production

Conservation des Données

• Mobula peut consigner les requêtes API à des fins d'analyse et de limitation de débit
• Référez-vous à la politique de confidentialité de Mobula : https://mobula.io/privacy
• N'interrogez pas les portefeuilles ou données que vous considérez comme sensibles

Meilleures Pratiques

1. Utilisez des clés API jetables/de test pour les tests initiaux
2. Interrogez uniquement des adresses de portefeuille publiques (ex. vitalik.eth, adresses bien connues)
3. Évitez d'interroger vos portefeuilles personnels si vous souhaitez préserver votre vie privée
4. Régénérez les clés API périodiquement
5. Surveillez les limites de taux et l'utilisation sur https://mobula.io

---

Modèles de Surveillance Intelligents avec le Battement de Cœur

Le système de battement de cœur d'OpenClaw vérifie les conditions toutes les ~30 minutes. Utilisez-le pour une surveillance proactive.

Modèle 1 : Gardien de Portefeuille

À chaque battement de cœur :

1. Récupérez le portefeuille de l'utilisateur via mobula_wallet_portfolio
2. Calculez les pourcentages de répartition
3. Vérifiez les conditions :
   • Tout token >40 % du portefeuille → suggérer un rééquilibrage
   • Tout token en baisse >15 % en 24h → alerter avec contexte
   • Total du portefeuille changé >10 % → notifier
4. Stockez les valeurs précédentes en mémoire pour détecter les changements
5. Envoyez un résumé quotidien à l'heure préférée de l'utilisateur

Modèle 2 : Surveillance de Baleines

À chaque battement de cœur :

1. Vérifiez les transactions pour les portefeuilles suivis via mobula_wallet_transactions
2. Si nouvelle transaction significative (>50 000 $) :
   • Obtenez les détails du token via mobula_market_data
   • Vérifiez les transactions récentes via mobula_market_trades
   • Croisez les informations pour voir si d'autres baleines suivies ont acheté le même token
3. Si plusieurs baleines achètent → alerte prioritaire

Modèle 3 : Éclaireur de Tokens (Découverte Autonome)

Toutes les 4 à 6 heures lors du battement de cœur :

1. L'utilisateur définit des critères (stockés en mémoire) :
   • Chaînes : Base, Arbitrum
   • Capitalisation boursière : <5 M$
   • Liquidité : >100 K$
   • Variation de volume 24h : >+50 %
2. Recherchez/filtrez les tokens via les requêtes mobula_market_data
3. Pour chaque correspondance :
   • Obtenez l'historique sur 7 jours via mobula_market_history
   • Vérifiez les métadonnées via mobula_metadata
   • Calculez un score de risque
4. Envoyez les 3 premiers avec analyse

Modèle 4 : Alertes de Prix Intelligentes

Au lieu d'alertes simples "prix > X", créez des alertes contextuelles :

Exemple : "Alerte-moi si Bitcoin bouge de >5 % en 1 heure MAIS seulement si le volume est 2 fois supérieur à la moyenne 24h"

À chaque battement de cœur :

1. Obtenez le prix et le volume actuels via mobula_market_data
2. Comparez au prix d'il y a 1 heure (stocké en mémoire)
3. Vérifiez si la condition de volume est remplie
4. Alertez uniquement si les DEUX conditions sont vraies

---

Combinaison de Plusieurs Endpoints pour des Insights Riches

Exemple : Analyse Complète d'un Token

L'utilisateur demande : "Dois-je acheter ce token ?"

1. mobula_market_data → prix actuel, mcap, volume, liquidité
2. mobula_market_history → tendance sur 7j et 30j
3. mobula_market_trades → activité récente (accumulation ou distribution ?)
4. mobula_metadata → infos du projet, réseaux sociaux, vérification du contrat

Format de réponse :

Analyse du TOKEN

Prix : 0,042 $ (en baisse de 8 % 24h, en hausse de 156 % 7j)
- Près du plus haut 7j, en baisse par rapport à 0,051 $
- Toujours en hausse de 400 % par rapport au plus bas 30j

Fondamentaux :
- Mcap : 2,1 M$ (petite capitalisation, risque/récompense élevé)
- Liquidité : 280 K$ (décent pour la taille)
- Volume : 1,2 M$ 24h (sain)

On-chain :
- Les transactions récentes montrent une pression d'achat (ratio achat/vente de 3:1)
- 2 gros achats (50 K$+) au cours des 2 dernières heures

Projet :
- Contrat vérifié
- Twitter actif (12K abonnés)

Risque : Petite capitalisation, forte volatilité. N'investissez pas plus que ce que vous pouvez perdre.

---

Directives de Formatage des Réponses

Prix

• Montrez toujours la direction : "en hausse de 12,4 %" ou "en baisse de 3,2 %"
• Incluez la période : "en hausse de 12,4 % (24h)"
• Ajoutez du contexte : "Prix 0,042 $ (en hausse de 12 % 24h, en baisse de 8 % par rapport à l'ATH)"

Grands Nombres

• Formatez clairement : "1,23 M$", "456 K$", "45,6 Md$"
• Pas : "1234567"

Pourcentages

• Utilisez pour les répartitions : "ETH : 42 % du portefeuille"
• Utilisez pour les variations : "en baisse de 15,3 % en 24h"

Le Contexte est Essentiel

Ne dites pas simplement "le prix est de 0,003 $" Dites : "Prix 0,003 $ (en baisse de 8 % 24h, en baisse de 65 % par rapport à l'ATH de 0,089 $ du 1er décembre, mais en hausse de 12 % par rapport au plus bas 7j)"

---

Demandes Courantes des Utilisateurs et Comment les Gérer

"Configure des alertes pour [token]"

1. Accusez réception de la demande
2. Demandez les conditions spécifiques (seuil de prix ? mouvement en pourcentage ? pic de volume ?)
3. Confirmez que vous surveillerez via le battement de cœur
4. Stockez la configuration de l'alerte en mémoire
5. Confirmez : "Je vérifierai [token] toutes les 30 min et vous alerterai sur [canal] si [condition]"

"Suivre ce portefeuille"

1. Ajoutez le portefeuille à la liste de surveillance
2. Demandez ce qu'il faut surveiller :
   • Toute activité ?
   • Uniquement les grosses transactions (>X $) ?
   • Tokens spécifiques ?
3. Stockez en mémoire
4. Confirmez que la surveillance est active

"Trouver des tokens correspondant à [critères]"

1. Clarifiez les critères :
   • Chaînes ?
   • Plage de capitalisation boursière ?
   • Exigences de volume ?
   • Liquidité minimale ?
2. Configurez des vérifications périodiques (suggérez un intervalle de 4 à 6h)
3. Demandez combien de résultats ils souhaitent
4. Commencez la surveillance au prochain battement de cœur

"Que se passe-t-il dans la crypto en ce moment ?"

1. Vérifiez les tokens majeurs (BTC, ETH, SOL, BNB) via mobula_market_multi
2. Identifiez tout mouvement majeur (>5 % en 24h)
3. Vérifiez les leaders de volume
4. Fournissez un aperçu concis

---

Gestion des Erreurs

Problèmes de Clé API

• Aucune clé définie : "J'ai besoin d'une clé API Mobula pour récupérer les données crypto. Obtenez-en une gratuitement sur https://mobula.io puis ajoutez-la à votre environnement avec export MOBULA_API_KEY='votre_cle'"
• Clé invalide : "Votre clé API Mobula semble invalide. Régénérez-la sur https://mobula.io et mettez à jour votre variable d'environnement."
• Limite de taux atteinte : "Vous avez atteint la limite de taux de votre clé API Mobula. Attendez un moment ou passez à un niveau supérieur sur https://mobula.io."

Problèmes de Données

• Token non trouvé : "Je n'ai pas pu trouver de données pour ce token. Vérifiez l'adresse du contrat, le nom ou le symbole. Essayez de chercher avec l'adresse du contrat pour de meilleurs résultats."
• Portefeuille non trouvé : "Je n'ai pas pu trouver ce portefeuille. Vérifiez que l'adresse est correcte (commence par '0x' ou est un nom ENS valide)."
• Aucune transaction : "Ce portefeuille n'a pas de transactions récentes pour ce token sur la période spécifiée."
• Données historiques non disponibles : "Je n'ai pas assez de données historiques pour cette période. Essayez une période plus courte ou un intervalle plus large."

Timing & Timeouts

• Délai d'attente : "La requête a pris trop de temps. Réessayez avec moins de tokens ou une période plus courte."
• Période invalide : "Période non prise en charge. Utilisez des timestamps Unix en secondes pour 'from' et 'to'.'"

---

Restrictions & Limites

Limites de Requêtes

• Gratuit : 100 requêtes/minute
• Premium : Jusqu'à 1000 requêtes/minute (mise à niveau sur mobula.io)
• Batch : Jusqu'à 500 tokens par requête multi-données

Limites de Données

• Données historiques : Jusqu'à 1 an selon le token
• Transactions par requête : Maximum 300 (défaut : 50)
• Historique du portefeuille : Jusqu'à 100 transactions

Limites de Chaînes

• Total des chaînes : 88+ blockchains supportées
• Principales chaînes : Ethereum, Binance Smart Chain, Polygon, Arbitrum, Optimism, Base, Solana, Avalanche, Fantom, TRON et plus

Général

• Seules les données publiques on-chain sont disponibles
• Les données peuvent être retardées de quelques secondes (pas un flux temps réel)
• Les données cryptées ou privées on-chain ne sont pas accessibles
• Les données de prix Oracle sont fiables mais peuvent différer des échanges centralisés

---

Référence Rapide des Endpoints

Endpoint	Fonctionnalité	Paramètres Clés
mobula_market_data	Prix & métriques du token	asset (obligatoire), blockchain
mobula_wallet_portfolio	Analyse de portefeuille	wallet (obligatoire), blockchains, cache
mobula_market_history	Données de prix historiques	asset (obligatoire), from, to, period
mobula_market_trades	Transactions en direct	asset (obligatoire), limit
mobula_wallet_transactions	Historique des portefeuilles	wallet (obligatoire), from, to, asset, limit
mobula_market_multi	Données batch multi-tokens	assets (obligatoire, max 500)
mobula_metadata	Infos du projet	asset (obligatoire)