Docs
⌘ K

2 minutes

Query The Graph with Python and Subgrounds

Subgrounds is an intuitive Python library for querying Subgraphs, built by Playgrounds⁠. It allows you to directly connect Subgraph data to a Python data environment, letting you use libraries like pandas⁠ to perform data analysis!

Subgrounds offre una semplice API Pythonic per la creazione di query GraphQL, automatizza i flussi di lavoro più noiosi come la paginazione, e dà agli utenti avanzati la possibilità di effettuare trasformazioni controllate dello schema.

Per cominciare

Subgrounds richiede Python 3.10 o superiore ed è disponibile su pypi⁠.

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

Once installed, you can test out subgrounds with the following query. The following example grabs a Subgraph for the Aave v2 protocol and queries the top 5 markets ordered by TVL (Total Value Locked), selects their name and their TVL (in USD) and returns the data as a pandas DataFrame⁠.

from subgrounds import Subgroundssg = Subgrounds()# Load the Subgraphaave_v2 = sg.load_subgraph(    "https://api.thegraph.com/subgraphs/name/messari/aave-v2-ethereum")# Construct the querylatest_markets = aave_v2.Query.markets(    orderBy=aave_v2.Market.totalValueLockedUSD,    orderDirection='desc',    first=5,)# Return query to a dataframesg.query_df([    latest_markets.name,    latest_markets.totalValueLockedUSD,])

Documentazione

Subgrounds è costruito e mantenuto dal team di Playgrounds⁠ e si può accedere su Playgrounds docs⁠.

Poiché le funzionalità di subgrounds sono numerose e tutte da esplorare, ecco alcuni punti di partenza utili: