Tachi
03/02/2023
We're excited to release the all-new and enhanced Subgrounds docs and webpage, complete with a growing library of resources from beginner to advanced, tutorials, examples, blogs, and much more! All to get you started with or significantly improve your blockchain data analytics work using Subgraphs.
Our mission is to provide the simplest and most reliable data integration tools and resources so anyone can discover and leverage on-chain data to make better decisions, generate new insights, and tell meaningful stories. The release of the all-new subgrounds docs is the first step towards accomplishing our mission.
For the uninitiated, what is Subgrounds? And how will it supercharge the way you work with subgraphs and your on-chain data analytics workflow?
In this introductory blog post, we'll introduce Subgrounds from a top level, its key features and benefits, and how it can empower you with an advanced yet accessible set of tools for on-chain data analytics.
So, let's jump right in and explore Subgrounds!
Intro to Subgrounds
Put simply, Subgrounds is a python library designed to help you quickly interface with, query, and visualize indexed blockchain data from any subgraph deployed on The Graph Network.
A subgraph is a custom API built on blockchain data. Subgraphs are queried using the GraphQL query language and are deployed to a Graph Node using the Graph CLI. Once deployed and published to The Graph's decentralized network, Indexers process subgraphs and make them available to be queried by subgraph consumers.
Technically speaking, Subgrounds is a pythonic data access layer that quickly loads any subgraph and provides easy-to-use components to query, manipulate, and create powerful visualizations of on-chain data indexed by the Subgraph.
It does this by providing an API that seamlessly interfaces with a subgraph, exposes the underlying subgraph entities and fields as Python objects, and provides the option to receive query response as a flat table, nested JSON object, or chart. All while eliminating the need to manipulate raw GraphQL strings.
Why use Subgrounds?
Subgrounds is open source, extensible, and modular, allowing continuity and integration with preexisting python based data analytics environments, significantly reducing the learning curve to working with on-chain data.
This means that finally, anyone with basic python skills can leverage their existing environments, such as jupyter notebook, and the rich ecosystem of tools, i.e., pandas and matplotlib, to treat on-chain data the same as off-chain data with the best-in-class data solutions available.
The subgrounds community is growing, with data analysts from all corners of web3 leveraging on-chain data to make discoveries, find new insights, and share compelling stories from the blockchain. From OlympusDAO to Messari’s NFT data app to advanced research on MEV behaviors, blockchain data analysts are using Subgrounds to supercharge their data analytics work. We are excited and can’t wait to see the stories and insights you share!
So what are you waiting for? Join the Subgrounds community and explore The Graph network's vast libraries of subgraphs. Take your data analytics capabilities to the next level!
To get started with Subgrounds, the Playgrounds Analytics team has released a comprehensive and growing library of docs along with a new webpage where users can learn more about Subgrounds and its capabilities.