# Subgrounds
Fork of https://github.com/0xPlaygrounds/subgrounds with small changes due to pending PRs in the original repository.
<!-- [](https://github.com/gnosis/subgrounds/actions) -->
[](https://pypi.org/project/subgrounds/)
[](https://pypi.org/project/subgrounds/)
[](https://github.com/ambv/black)
[](https://github.com/gnosis/subgrounds/actions/workflows/main.yml)
<br>
[](https://discord.gg/gMSSh5bjvk)
[](https://twitter.com/Playgrounds0x)
[](https://colab.research.google.com/github/gnosis/subgrounds/blob/main/examples/notebook.ipynb)
[](https://codespaces.new/gnosis/subgrounds-template?quickstart=1)
<!-- start elevator-pitch -->
An intuitive Python library for interfacing with subgraphs and GraphQL.
## Features
- **Simple**: Leverage a Pythonic API to easily build queries and transformations without the need for raw GraphQL manipulation.
- **Automated**: Automatically handle pagination and schema introspection for effortless data retrieval.
- **Powerful**: Create sophisticated queries using the `SyntheticFields` transformation system.
<!-- end elevator-pitch -->
## Resources
- [**Docs**](http://docs.playgrounds.network/): User guide and API documentation
- [**Snippets**](https://github.com/gnosis/subgrounds/tree/main/examples): A list of examples showcasing Subgrounds integration with Dash and Plotly
- [**Examples**](http://docs.playgrounds.network/subgrounds/examples/): An ever growing list of projects created by our community members and team
- [**Videos**](https://docs.playgrounds.network/subgrounds/videos/): Video workshops on Subgrounds
## Installation
> Subgrounds **requires** atleast Python 3.10+
Subgrounds is available on PyPi. To install it, run the following:<br>
`pip install subgrounds-gnosis`.
Subgrounds also comes bundled with extra modules that may require extra libraries. You can get all functionality of `subgrounds` via the following:<br>
`pip install subgrounds-gnosis[all]`.
## Simple example
<!-- start simple-example -->
```python
>>> from subgrounds import Subgrounds
>>> sg = Subgrounds()
>>> # Load
>>> aave_v3 = sg.load_subgraph("https://api.thegraph.com/subgraphs/name/messari/aave-v3-ethereum")
>>> # Construct the query
>>> largest_markets = aave_v3.Query.markets(
... orderBy=aave_v3.Market.totalValueLockedUSD,
... orderDirection='desc',
... first=5,
... )
>>> # Return query to a dataframe
>>> sg.query_df([
... largest_markets.name,
... largest_markets.totalValueLockedUSD,
... ])
markets_name markets_totalValueLockedUSD
0 Aave Ethereum wstETH 1.915090e+09
1 Aave Ethereum WETH 1.047417e+09
2 Aave Ethereum WBTC 6.049655e+08
3 Aave Ethereum USDC 4.482461e+08
4 Aave Ethereum USDT 4.280103e+08
```
<!-- end simple-example -->
## About Us
Playgrounds Analytics is a data solutions company providing data infrastructures and services for data teams, analysts, and engineers. Check us out [here](https://playgrounds.network/) to learn more!
## Acknowledgments
This software project would not be possible without the support of The Graph Foundation. You can learn more about The Graph and its mission [here](https://thegraph.com/).
Raw data
{
"_id": null,
"home_page": "https://github.com/gnosis/subgrounds",
"name": "subgrounds-gnosis",
"maintainer": null,
"docs_url": null,
"requires_python": "<4.0,>=3.10",
"maintainer_email": null,
"keywords": "graph, subgrounds, graphql, subgraph",
"author": "cvauclair",
"author_email": "cvauclair@playgrounds.network",
"download_url": "https://files.pythonhosted.org/packages/0b/d8/65e593d2b1690001cf08ceab15677ca78a1be860f3457d5add6e09c17b70/subgrounds_gnosis-1.9.2.tar.gz",
"platform": null,
"description": "# Subgrounds\n\nFork of https://github.com/0xPlaygrounds/subgrounds with small changes due to pending PRs in the original repository.\n\n<!-- [](https://github.com/gnosis/subgrounds/actions) -->\n[](https://pypi.org/project/subgrounds/)\n[](https://pypi.org/project/subgrounds/)\n[](https://github.com/ambv/black)\n[](https://github.com/gnosis/subgrounds/actions/workflows/main.yml)\n<br>\n\n[](https://discord.gg/gMSSh5bjvk)\n[](https://twitter.com/Playgrounds0x)\n\n[](https://colab.research.google.com/github/gnosis/subgrounds/blob/main/examples/notebook.ipynb)\n[](https://codespaces.new/gnosis/subgrounds-template?quickstart=1)\n\n<!-- start elevator-pitch -->\nAn intuitive Python library for interfacing with subgraphs and GraphQL.\n\n## Features\n- **Simple**: Leverage a Pythonic API to easily build queries and transformations without the need for raw GraphQL manipulation.\n- **Automated**: Automatically handle pagination and schema introspection for effortless data retrieval.\n- **Powerful**: Create sophisticated queries using the `SyntheticFields` transformation system.\n<!-- end elevator-pitch -->\n\n## Resources\n- [**Docs**](http://docs.playgrounds.network/): User guide and API documentation\n- [**Snippets**](https://github.com/gnosis/subgrounds/tree/main/examples): A list of examples showcasing Subgrounds integration with Dash and Plotly\n- [**Examples**](http://docs.playgrounds.network/subgrounds/examples/): An ever growing list of projects created by our community members and team\n- [**Videos**](https://docs.playgrounds.network/subgrounds/videos/): Video workshops on Subgrounds\n\n## Installation\n> Subgrounds **requires** atleast Python 3.10+\n\nSubgrounds is available on PyPi. To install it, run the following:<br>\n`pip install subgrounds-gnosis`.\n\nSubgrounds also comes bundled with extra modules that may require extra libraries. You can get all functionality of `subgrounds` via the following:<br>\n`pip install subgrounds-gnosis[all]`.\n\n## Simple example\n<!-- start simple-example -->\n```python\n>>> from subgrounds import Subgrounds\n\n>>> sg = Subgrounds()\n\n>>> # Load\n>>> aave_v3 = sg.load_subgraph(\"https://api.thegraph.com/subgraphs/name/messari/aave-v3-ethereum\")\n\n>>> # Construct the query\n>>> largest_markets = aave_v3.Query.markets(\n... orderBy=aave_v3.Market.totalValueLockedUSD,\n... orderDirection='desc',\n... first=5,\n... )\n\n>>> # Return query to a dataframe\n>>> sg.query_df([\n... largest_markets.name,\n... largest_markets.totalValueLockedUSD,\n... ])\n markets_name markets_totalValueLockedUSD\n0 Aave Ethereum wstETH 1.915090e+09\n1 Aave Ethereum WETH 1.047417e+09\n2 Aave Ethereum WBTC 6.049655e+08\n3 Aave Ethereum USDC 4.482461e+08\n4 Aave Ethereum USDT 4.280103e+08\n```\n<!-- end simple-example -->\n\n\n## About Us\nPlaygrounds Analytics is a data solutions company providing data infrastructures and services for data teams, analysts, and engineers. Check us out [here](https://playgrounds.network/) to learn more!\n\n\n## Acknowledgments\nThis software project would not be possible without the support of The Graph Foundation. You can learn more about The Graph and its mission [here](https://thegraph.com/).\n\n",
"bugtrack_url": null,
"license": null,
"summary": "A Pythonic data access layer for applications querying data from The Graph Network.",
"version": "1.9.2",
"project_urls": {
"Homepage": "https://github.com/gnosis/subgrounds",
"Repository": "https://github.com/gnosis/subgrounds"
},
"split_keywords": [
"graph",
" subgrounds",
" graphql",
" subgraph"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "5b3eb158d1b406b988323de2cac578da275399fb20a34bf11e1cedacf787e9f3",
"md5": "90e33a1da9ce1d512d0a68ebb97a0419",
"sha256": "60644bb7f8befaca2fb145b797c8dde7cfd169c45cca670aec1a171a3b6a7368"
},
"downloads": -1,
"filename": "subgrounds_gnosis-1.9.2-py3-none-any.whl",
"has_sig": false,
"md5_digest": "90e33a1da9ce1d512d0a68ebb97a0419",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": "<4.0,>=3.10",
"size": 73822,
"upload_time": "2025-02-12T14:36:22",
"upload_time_iso_8601": "2025-02-12T14:36:22.757914Z",
"url": "https://files.pythonhosted.org/packages/5b/3e/b158d1b406b988323de2cac578da275399fb20a34bf11e1cedacf787e9f3/subgrounds_gnosis-1.9.2-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "0bd865e593d2b1690001cf08ceab15677ca78a1be860f3457d5add6e09c17b70",
"md5": "135bfc71dae8574135000f51e92e1771",
"sha256": "7f1fddc821a108cfc0e585584b8c8ae466c1b8db0cfec7a95a0b330eede47071"
},
"downloads": -1,
"filename": "subgrounds_gnosis-1.9.2.tar.gz",
"has_sig": false,
"md5_digest": "135bfc71dae8574135000f51e92e1771",
"packagetype": "sdist",
"python_version": "source",
"requires_python": "<4.0,>=3.10",
"size": 60754,
"upload_time": "2025-02-12T14:36:24",
"upload_time_iso_8601": "2025-02-12T14:36:24.931224Z",
"url": "https://files.pythonhosted.org/packages/0b/d8/65e593d2b1690001cf08ceab15677ca78a1be860f3457d5add6e09c17b70/subgrounds_gnosis-1.9.2.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-02-12 14:36:24",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "gnosis",
"github_project": "subgrounds",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "subgrounds-gnosis"
}
JSON
