dex_screener

This project is a Hydration blockchain indexer with DEX Screener API compatibility.

It consists of three components:

• dex_screener: the main indexer that processes DEX trades and pools
• reserves: a sub-indexer that processes raw balance/supply updates
• proxy: a simple HTTP proxy that adjusts Hasura response to match DEX Screener API specs

dex_screener and reserves run on different schemas in the same PostgreSQL database, while proxy is a separate service that connects to Hasura GraphQL endpoint.

Installation

This project is based on DipDup, a framework for building featureful dapps.

You need a Linux/macOS system with Python 3 installed. To install DipDup use uv tool install command or our installer script:

curl -Lsf https://dipdup.io/install.py | python3

See the Installation page for all options.

Usage

To spawn a Compose stack with PostgreSQL and Hasura:

# Create default env file
dipdup -C compose config env -o deploy/.env

# Edit `deploy/.env` before running
make up

Development setup

To set up the development environment run:

make install
source .venv/bin/activate

Don't forget to initialize project after significant changes and keep DipDup up to date:

dipdup init
make update

Run make all to run full CI check or make help to see other available commands.