Docs
⌘ K

2 minutes

Interroger The Graph avec Python et Subgrounds

Subgrounds est une bibliothèque Python intuitive pour l’interrogation des subgraphs, créée par Playgrounds⁠. Elle vous permet de connecter directement les données des subgraphs à un environnement de données Python, ce qui vous permet d’utiliser des bibliothèques comme pandas⁠ pour effectuer des analyses de données !

Subgrounds propose une API Python simplifiée afin de construire des requêtes GraphQL. Subgrounds automatise les workflows fastidieux comme la pagination, et donne aux utilisateurs avancés plus de pouvoir grâce à des transformations de schéma contrôlées.

Introduction

Subgrounds nécessite Python 3.10 ou une version ultérieure. Subgrounds est disponible depuis pypi⁠.

pip install --upgrade subgrounds# orpython -m pip install --upgrade subgrounds

Une fois installé, vous pouvez tester les subgraphs avec la requête suivante. L’exemple suivant récupère un subgraph pour le protocole Aave v2 et interroge les 5 premiers marchés classés par TVL (Total Value Locked), sélectionne leur nom et leur TVL (en USD) et renvoie les données sous la forme d’un DataFrame⁠ pandas .

from subgrounds import Subgroundssg = Subgrounds()# Charge le Subgraphaave_v2 = sg.load_subgraph(    "https://api.thegraph.com/subgraphs/name/messari/aave-v2-ethereum")# Construit la requêtelatest_markets = aave_v2.Query.markets(    orderBy=aave_v2.Market.totalValueLockedUSD,    orderDirection='desc',    first=5,)# Renvoi la requête à un dataframesg.query_df([    latest_markets.name,    latest_markets.totalValueLockedUSD,])

Documentation

Subgrounds est développé et maintenu par l’équipe de Playgrounds⁠ et est accessible depuis la documentation de Playgrounds⁠.

Étant donné que Subgrounds propose un large éventail de fonctionnalités, voici quelques points de départ utiles :