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 nabízí jednoduché Pythonic API pro vytváření dotazů GraphQL, automatizuje zdlouhavé pracovní postupy, jako je stránkování, a umožňuje pokročilým uživatelům řízené transformace schémat.

Začínáme

Subgrounds vyžaduje Python 3.10 nebo vyšší a je k dispozici na 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,])

Dokumentace

Subgrounds je vytvořen a spravován týmem Playgrounds⁠ a je k dispozici na stránce Playgrounds docs⁠.

Vzhledem k tomu, že subgrounds má rozsáhlou sadu funkcí, které je třeba prozkoumat, uvádíme několik užitečných výchozích bodů: