Subgraph vs API — lequel choisir ?
Mis à jour en août 2026
Utilisez une API de données hébergée quand les données dont vous avez besoin sont standards — soldes de tokens, transferts, propriété de NFT — et que vous voulez que ça fonctionne dès aujourd'hui. Utilisez un subgraph quand vous avez besoin d'une logique personnalisée sur des contrats spécifiques et que vous voulez contrôler le schéma.
La décision se résume à savoir si quelqu'un d'autre a déjà modélisé correctement vos données.
Comment se comparent-ils ?
| API de données hébergée | Subgraph | |
|---|---|---|
| Délai avant le premier résultat | Minutes | Heures à jours, plus la synchronisation |
| Logique personnalisée | Non | Oui |
| Contrôle du schéma | Celui du fournisseur | Le vôtre |
| Interface de requête | REST ou GraphQL, fixe | GraphQL, votre schéma |
| Modèle de coût | Par requête | Indexation plus requêtes |
| Portabilité | Spécifique au fournisseur | Spécification ouverte |
| Convient à | Données standards, démarrage rapide | Données spécifiques à un protocole |
Quand une API hébergée est-elle le meilleur choix ?
Quand vos besoins correspondent à ce que le fournisseur propose déjà. Soldes de portefeuille, métadonnées de tokens, propriété de NFT, historique de transactions pour une adresse — ce sont des problèmes résolus, et les reconstruire vous-même est rarement un bon usage de votre temps.
La contrainte est que vous héritez du modèle de données du fournisseur. Si vous avez besoin de quelque chose qu'il n'a pas anticipé — un événement spécifique de votre propre contrat, un agrégat qu'il ne calcule pas, un champ qu'il n'expose pas — vous ne pouvez pas l'ajouter. Vous pouvez seulement le lui demander.
Quand avez-vous besoin d'un subgraph ?
Quand vous indexez votre propre protocole, ou tout ce dont les données intéressantes sont spécifiques à un contrat.
Un subgraph vous permet de définir exactement quels événements traiter, ce qu'il faut en calculer, et quelle forme prend le résultat. Si votre application a besoin de « volume total par pool et par jour, avec les frais répartis par palier », aucune API généraliste ne l'aura — mais un subgraph peut le produire directement.
Vous obtenez aussi une définition portable. Les subgraphs suivent une spécification ouverte plutôt qu'une surface d'API propriétaire.
Quel est le piège avec les subgraphs ?
Le temps de synchronisation. Les subgraphs traitent l'historique séquentiellement, donc un subgraph portant sur un contrat avec des années d'activité peut mettre longtemps à se synchroniser — et chaque changement de schéma relance ce processus. C'est la plainte la plus courante, et elle a une réponse dédiée.
L'effort de développement. Vous définissez le schéma, écrivez les mappings, et gérez le déploiement.
Questions fréquentes
Puis-je utiliser les deux ? Fréquemment, oui — une API hébergée pour les données standards et un subgraph pour la logique spécifique au protocole.
Les subgraphs ne fonctionnent-ils que sur Ethereum ? Non, ils prennent en charge un éventail de réseaux, même si l'écosystème reste centré sur l'EVM.
Que faire si mon subgraph est trop lent à synchroniser ? Voir pourquoi mon subgraph se synchronise-t-il si lentement ?
Obtenez une clé API sur thegraph.market — aucune information personnelle requise.
Voir aussi : Pourquoi mon subgraph se synchronise-t-il si lentement ? · Qu'est-ce que l'indexation blockchain ?