Docs
⌘ K

2 minutos

Queries no The Graph com Python e Subgrounds

Subgrounds é uma biblioteca intuitiva em Python para a construção de subgraphs, construída pela Playgrounds⁠. Ela permite-lhe conectar diretamente dados de subgraph a um ambiente de dados em Python e usar bibliotecas como pandas⁠ para realizar análises de dados!

O Subgrounds oferece uma API simples para a construção de queries em GraphQL, automatiza fluxos de trabalho entediantes, como a paginação, e empodera utilizadores avançados via transformações controladas de schema.

Como Começar

O Subgrounds requer Python 3.10 ou maior, e está disponível no pypi⁠.

pip install --upgrade subgrounds# oupython -m pip install --upgrade subgrounds

Depois de instalado, você pode testar o subgrounds com o seguinte query. O exemplo a seguir coleta um subgraph do protocolo Aave v2 e realiza queries para os 5 maiores mercados ordenados por valor total bloqueado, seleciona os seus nomes e o seu VTB (em USD) e retorna os dados como um DataFrame⁠ em pandas.

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

Documentação

O Subgrounds é construído e mantido pela Playgrounds⁠ e pode ser acessado na documentação do Playgrounds⁠.

Como o subgrounds tem um grande conjunto de recursos para explorar, aqui estão alguns pontos úteis de início: