This post is of a more technical nature, covering the programming side of crypto rather than the yield aspect. Specifically, using SubQuery Network to extract data from Polkadot and Kusama blockchains, which are known as substrate. On the Ethereum blockchain there are similar projects such as The Graph and Dune Analytics. What all of these projects do is index blockchain data and make it available to the public to query it. First we will review some of the Ethereum options, then go on to SubQuery.

The Graph

I will start with The Graph since they are the first one that I heard about. The idea is that anyone can write queries using blockchain data and then other people will pay them GRT tokens in order to use those queries. Users needing Ethereum blockchain data can look to the queries with the largest number of GRT tokens backing them to find the most trustworthy queries. Learning how to write queries for The Graph involves learning the Typescript programming language and learning GraphQL, which is an API interface language. These are not trivial tasks.

Dune Analytics

Dune Analytics has taken a different approach. Instead of making you learn typescript and GraphQL, the team at Dune Analytics has imported all the Ethereum blockchain data (or at least most of it) into their relational databases and built a web-based front end where you can query the data using stand SQL commands. Once you have the data you want, you can publish it into tables and graphs as dashboard and share those dashboards with others.

Here is a simple dashboard I made. You can see more dashboards here. If you don’t know SQL, you can still look at all the dashboards other people have built and gain some valuable insights about the Ethereum network that way.


One problem is that The Graph and Dune Analytics only support Ethereum, so you can’t use one service to get data from all the different blockchains out there. SubQuery Network is focused on the Polkadot and Kusama ecosystems, including all the parachains like Acala, Moonbeam, Parallel Finance, etc.

If you really want to learn how to use SubQuery and create your own projects and queries, there are a lot of resources on their website, one of them being The Hero Course. Before you begin you should be familiar with Typescript, GraphQL, and Docker. I will very briefly outline the steps involved, along with some of the issues I encountered while working through the exercises. I had two main problems. The first was getting the tutorials on Github to work on my local machine and the second was getting the SubQuery command line interface (CLI) to connect to my postgres database. I will explain the solution to both of those problems.

Outline of steps

This is not a full tutorial, just an outline of the steps involved. Once you do it a few times it will become second nature. Assuming you have all the necessary software installed, the firs step is to initialize a new project in the terminal.

subsql init

This will create a new directory with a number of files and folders. There are three primary files you will need to learn about, two of which are in the root directory and one of which is in the src/mappings folder. You can click the links to see an examples of these files.

  • schema.graphql - this file defines the structure of the data you want to query.
  • project.yaml - this file lists the data sources (handlers) and filters (modules and methods)
  • src/mappings/mappingHandlers.ts - this is the typescript file that defines the function that will extract the blockchain data and save it into the tables defined in the schema.graphql file.

Once you have modified all those files to your needs, you can run the following code to install all the dependencies.

yarn install

Next you can run the following code to generate the rest of code for your project. This command also creates documentation for your project which will be very useful to you and others who use the project to extract data.

yarn codegen

Finally, you can build the project using the build command.

yarn build

Once the build completes successfully, you are test it out in one of two ways: 1) using docker and 2) using the SubQuery command line interface. Using the docker instance is probably the easier route and would be accomplished by running the following two commands.

docker-compose pull
docker-composr up

You can issue both of those commands on the same line, but I like to break them up. If you get any error with the pull command, make sure the docker application is running. It is easy to forget that. Once the docker instance is up and running, you will see your project start to record blocks. At that point you can connect to localhost:3000 in your browser to access the playground where you can write your GraphQL query to access your data.

If you have trouble following the steps in the exercises, you can download completed tutorials from SubQuery’s github account, but I found that the localhost:3000 connection wasn’t working with the tutorials I downloaded from Github. Turns out the docker-compose.yml file is outdated on the Github site and that was causing a problem. You can get the latest version of the docker-compose.yml file from any project that you create locally using the subql init command, then copy that file to the folder you downloaded from Github. The file is generic so you don’t need to change anything. That should fix the connection problem.

An alternative to using docker is to use the subql-node command. I saw this in some of the videos and I really wanted to try it, but you need to install and configure postgres if it is not already installed. Here is the full command.

subql-node -f .

The . in the command above is a reference to the current folder. You can also use the folder name in that instance. An added benefit of this method is that you can view the postgres tables that are created. This is good to verify that the column names do indeed match what you specified in the schema.graphql file and the mappings file.

I had a problem with this setup on my Mac because I was getting permission denied errors when subql-node tried to connect to the postgres database. The instructions SubQuery provides in their documentation are pretty straightforward. The database name is postgres and the username is postgres and the password is postgres, as shown below.

export DB_USER=postgres
export DB_PASS=postgres
export DB_DATABASE=postgres
export DB_HOST=localhost
export DB_PORT=5432
subql-node -f .

Upon running subql-node -f . Exporting those parameters didn’t help and I was getting the same permission denied error. Running as sudo did not help either. It took a long time for me to figure out the problem so I decided to post it here in case anyone else comes across it.

I kept trying to log into postgres as the postgres user to figure out what the problem was, but I noticed that I was getting permission denied errors inside postgres as well. It turns out that the default superuser is not postgres, but the current mac-os user. In order to solve the problem I had to log into the postgres database without specifying the user (hence the current mac-os user), as such:

psql -d postgres

You will know this works when the prompt changes to postgres=#. Then you can make the postgres user a superuser using the following command:

ALTER ROLE postgres superuser;

The response should be ALTER ROLE. That fixed the problem for me.

If you want to see a project I did using data from the Karura blockchain, you can check it out here.


Learning how to create SubQuery projects has been a fun learning experience, but there were some simple problems that did cost me some time and frustration. I hope this post helps a few people, encourages them to learn more about Substrate blockchain data, and saves them some time in the process.


These posts are for informational and educational purposes only and should not be construed as investment advice or a recommendation to buy or sell any tokens. In this series I am just outlining what I am doing to learn more about the crypto space. Just because I am comfortable doing this, that does not necessarily mean these activities are suitable for you. I have not received any compensation from any of the products or services mentioned herein. Please do your own research and stay skeptical. These markets are not normal.