Docs
⌘ K

2 分钟

使用 Python 和 Subground查询The Graph

Subgrounds是一个用于查询子图的直观的 Python 库，由 Playgrounds⁠构建。 它允许您直接将子图数据连接到 Python 数据环境。 让您使用像 pandas⁠这样的库来进行数据分析！

Subgrounds提供了一个简单的 Pythonic API，用于构建GraphQL 查询，实现分页等冗余工作流自动化，并通过受控模式转换增强高级用户的能力。

开始

Subgrounds需要 Python 3.10或更高版本，可在 pypi⁠上获取。

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

安装完毕后，您可以通过以下查询测试Subgrounds。 下面的示例为 Aave v2 协议拍摄了子图并查询了TVL 订购的前 5 个市场(总值锁定)， 选择他们的名字和他们的 TVL (美元) 并返回数据为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,])

文档

Subgrounds是由 Playgrounds⁠团队构建和维护的，可以在 Playplace文档⁠上访问。

由于Subgrounds有大的功能可以探索，在这里有一些有用的起始地点：