Docs
⌘ K

2 минуты

Запросы к The Graph с использованием Python и 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 предлагает простой Pythonic API для создания GraphQL-запросов, автоматизирует утомительные рабочие процессы, такие как пагинация, и предоставляет расширенные возможности для опытных пользователей через управляемые преобразования схем.

Начало работы

Subgrounds requires Python 3.10 or higher and is available on pypi⁠.

pip install --upgrade subgrounds# илиpython -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,])

Documentation

Subgrounds is built and maintained by the Playgrounds⁠ team and can be accessed on the Playgrounds docs⁠.

Since subgrounds has a large feature set to explore, here are some helpful starting places: