Moonstream is a product which helps anyone participate in decentralized finance.
Go to file
Andrey Dolgolev 1d4ef733c8
Merge pull request #1067 from moonstream-to/metadata-crawler-headers
Add headers.
2024-05-13 16:49:40 +03:00
.github/workflows Moonstream DB V3 release workflow 2024-04-08 14:24:20 +00:00
clients/python Fix: typo 2023-07-12 10:17:53 +02:00
crawlers Add headers. 2024-05-13 16:20:20 +03:00
datasets/nfts fixed cli choices, added help messages 2022-05-26 15:22:09 +03:00
docs Fix: typo 2023-07-12 10:16:26 +02:00
engineapi Merge pull request #1062 from moonstream-to/verify-call-requests-post 2024-05-07 19:16:42 +03:00
moonstreamapi Fix typo 2024-05-07 05:40:33 +00:00
moonstreamdb Merge branch 'add-arbitrum-one' of into add-arbitrum-one 2024-05-06 02:56:14 +03:00
moonstreamdb-v3 Arbitrum One for moonstreamdb v3 models 2024-05-10 10:40:20 +00:00
nodebalancer Fix rewrite env params for nodebalancer 2024-04-10 08:05:23 +00:00
nodes Updated nodebalancer placement 2023-06-06 11:35:51 +00:00
probes Build executables via deployment 2023-07-05 12:12:48 +00:00
robots Robots deployment from api repo 2023-06-06 12:29:29 +00:00
.gitignore Merge branch 'main' into blancer-app-auth 2022-03-16 21:38:43 +00:00
LICENSE Initial commit 2021-07-01 16:01:22 -07:00 Update 2022-12-07 09:03:12 -08:00
docker-compose.yml Docker and docker compose setup for db and moonstream api 2021-11-30 14:29:10 +00:00

github read me header



Join our Discord

What is Moonstream?

Moonstream creates economic infrastructure for web3 projects with a focus on blockchain games.

This repository contains Moonstream's complete data analysis stack. The emphasis of it is on collecting actionable data related to the blockchain. The repository contains:

  1. Database management tools
  2. Blockchain node management tools
  3. Blockchain data crawlers
  4. Access-controlled API which exposes collected data

Important resources

  1. Documentation
  2. Status page
  3. On-chain mechanics
  4. How to create a dashboard to analyze a smart contract?

Who uses Moonstream?

People from different backgrounds who are interested in data, crypto and code. Moonstream tools are often used by game designers and economists, data scientists, smart contract developers, backend engineers, and teams managing loyalty programs for blockchain projects.

Some projects currently using Moonstream:

  1. Laguna Games, makers of Crypto Unicorns
  2. Game7
  3. Champions Ascension

Please read the Game Master's Guide to Moonstream Solutions if you want to know how Moonstream tools are applied in web3 games.

Moonworm tool is used to build datasets of on-chain data related to market activity. The dataset with on-chain activity from the Ethereum NFT market (April 1 to September 25, 2021) is available on Kaggle. The full report on it is published on GitHub.

Free software

Proprietary technologies are not inclusive technologies, and we believe in inclusion.

All of our technology is open source. This repository contains all the code that powers The code is licensed with the Apache License, Version 2.0.

You are and will always be free to host your own instance of Moonstream.


This monorepo contains the following components:

  1. frontend: A web frontend for Moonstream. Allows users to create dashboards and monitor the activity of accounts and smart contracts on multiple blockchains. Built in React.
  2. backend': The Moonstream API allows users to programmatically consume data about transactions and events taking place on blockchains crawled by Moonstream. Built in Python using Fast API.
  3. crawlers: This part of the code base contains workers which extract data from blockchains, transaction pools, and other sources. We have many crawlers and each crawler can utilize a different tech stack.
  4. db: Moonstream stores blockchain data in Postgres. This directory contains the code we use to manage the schema in our Postgres database. For sources that send higher volumes of data, we use a separate Postgres database and interface with it using Bugout.

Installation and setup

Run server with Docker Compose

If you want to deploy Moonstream in isolation against live services, then docker compose is your choice!

  • Run script backend/configs/docker_generate_env.bash which prepare for you:
    • backend/configs/docker.moonstreamapi.env with environment variables
  • Run script db/configs/docker_generate_env.bash which prepare for you:
    • db/configs/alembic.moonstreamdb.ini with postgresql uri
  • Run local setup
docker-compose up --build


We are working on contributing guidelines. In the meantime, please reach out to @zomglings on the Moonstream Discord.