Query The Graph with Python and Subgrounds

Reading time: 2 min

Subgrounds è una libreria Python intuitiva per query dei subgraph, realizzata da Playgrounds. Permette di collegare direttamente i dati dei subgraph a un ambiente dati Python, consentendo di utilizzare librerie come pandas per eseguire analisi dei dati!

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.

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

pip install --upgrade subgrounds
# or
python -m pip install --upgrade subgrounds

Una volta installato, è possibile testare subgrounds con la seguente query. L'esempio seguente prende un subgraph per il protocollo Aave v2 e effettua query dei primi 5 mercati ordinati per TVL (Total Value Locked), seleziona il loro nome e il loro TVL (in USD) e restituisce i dati come pandas DataFrame.

da subgrounds import Subgrounds

sg = Subgrounds()

# Caricare il subgraph
aave_v2 = sg.load_subgraph(
    "https://api.thegraph.com/subgraphs/name/messari/aave-v2-ethereum")

# Costruire la query
latest_markets = aave_v2.Query.markets(
    orderBy=aave_v2.Market.totalValueLockedUSD,
    orderDirection='desc',
    first=5,
)
# Restituire la query a un dataframe
sg.query_df([
    latest_markets.name,
    latest_markets.totalValueLockedUSD,
])

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:

• Introduzione alle query
  • Un buon primo passo per costruire le query con subgrounds.
• Costruire campi sintetici
  • Una leggera introduzione alla definizione di campi sintetici che trasformano i dati definiti dallo schema.
• Query concorrenti
  • Imparate a migliorare le vostre query parallelizzandole.
• Esportazione di dati in CSV
  • Un rapido articolo su come salvare senza problemi i dati in formato CSV per ulteriori analisi.