Moonstream is a product which helps anyone participate in decentralized finance.
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
Neeraj Kashyap 48ad43cd9b
Added banner to top of README.
5 days ago
.github/workflows Fix release client library github action 4 weeks ago
backend Fixed user go dir in deployment 3 weeks ago
clients/python Fix of redirect exception 1 month ago
crawlers Remove refetch add later after apear hash of paramaters in s3 route. 1 week ago
datasets/nfts fixed cli choices, added help messages 6 months ago
db scratch directory in db/ 1 month ago
docs Added Moonstream architecture documentation 1 year ago
frontend menu button style 7 days ago
nodes Lighthouse eth node service 2 months ago
.gitignore Merge branch 'main' into blancer-app-auth 9 months ago
LICENSE Initial commit 1 year ago Added banner to top of README. 5 days ago
docker-compose.yml Docker and docker compose setup for db and moonstream api 1 year ago

github read me header



Join our Discord

What is Moonstream?

Moonstream makes tools that help people build, manage, and maintain their blockchain economies.

In order to provide this functionality, we build a lot of technology to crawl blockchains and makes sense of crawled transactions and events. This repository contains that code.

Who uses Moonstream?

Game designers and economists, data scientists, smart contract developers, backend engineers, and teams managing loyalty programs for blockchain projects.

Some of our prominents customers:

  1. Laguna Games, makers of Crypto Unicorns
  2. RealtyBits

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


If you would like to contribute to Moonstream, please reach out to @zomglings on the Moonstream Discord.