How to Build a DexScreener Clone

Introduction

In this tutorial, you’ll learn how to build a DEX token screener similar to DexScreener using the Moralis API. The screener will display tokens ranked by volume with real-time prices, market cap, and price changes. We’ll use the following Moralis API endpoint:

Token Search - Search and rank tokens by volume, market cap, or liquidity

Token Search requires a query, so it ranks the tokens matching your search rather than the entire token universe.

Prerequisites

Node.js v18+ installed
A Moralis API key (get one)

Step 1: Set Up Your Project

Create a new directory for your project and initialize it:

mkdir dex-screener && cd dex-screener
npm init -y

Step 2: Create the Script

Create a file called index.js and add the following code:

// index.js
const API_KEY = 'YOUR_API_KEY';

async function getTopTokens() {
  const params = new URLSearchParams({
    query: 'pepe',
    chains: 'eth',
    sortBy: 'volume24hDesc',
    isVerifiedContract: 'true',
    limit: '20',
  });

  const response = await fetch(
    `https://deep-index.moralis.io/api/v2.2/tokens/search?${params}`,
    {
      headers: {
        accept: 'application/json',
        'X-API-Key': API_KEY,
      },
    }
  );

  const data = await response.json();
  console.log(JSON.stringify(data, null, 2));
}

getTopTokens();

Replace YOUR_API_KEY with your actual Moralis API key.

Step 3: Run the Script

Execute the script to get the top tokens:

node index.js

Example Response

{
  "total": 10000,
  "result": [
    {
      "tokenAddress": "0x6982508145454ce325ddbe47a25d4ec3d2311933",
      "chainId": "0x1",
      "name": "Pepe",
      "symbol": "PEPE",
      "logo": "https://cdn.moralis.io/eth/0x6982508145454ce325ddbe47a25d4ec3d2311933.png",
      "usdPrice": 0.000024509478199144,
      "marketCap": 9825629287.860994,
      "fullyDilutedValuation": 71242582.97741453,
      "usdPricePercentChange": {
        "oneHour": 1.079210724244654,
        "oneDay": 2.079210724244654
      },
      "volumeUsd": {
        "oneHour": 188552.0639107914,
        "oneDay": 76927981.5281831
      },
      "totalLiquidityUsd": 18908.234,
      "totalHolders": 18908,
      "securityScore": 92,
      "isVerifiedContract": false
    }
  ]
}

Understanding the Response

Field	Description
`tokenAddress`	Contract address of the token
`chainId`	Chain the token is on, in hex
`name`	Token name
`symbol`	Token ticker symbol
`logo`	URL to token logo image
`usdPrice`	Current price in USD
`marketCap`	Total market capitalization in USD
`fullyDilutedValuation`	FDV based on total supply
`usdPricePercentChange.oneDay`	24-hour price change percentage
`volumeUsd.oneDay`	24-hour trading volume in USD
`totalLiquidityUsd`	Total liquidity across pairs, in USD
`totalHolders`	Number of token holders
`securityScore`	Token security score (0-100)
`isVerifiedContract`	Whether the contract is verified

Next Steps

Get Token Price - Price data
Get OHLC Data - Historical prices
Get Token Pairs - Liquidity data
API Reference - Full API documentation

Introduction

Getting Started

Pricing & Resources

Tutorials & Guides

How to Build a DexScreener Clone

Introduction

Prerequisites

Step 1: Set Up Your Project

Step 2: Create the Script

Step 3: Run the Script

Example Response

Understanding the Response

Next Steps

​Introduction

​Prerequisites

​Step 1: Set Up Your Project

​Step 2: Create the Script

​Step 3: Run the Script

​Example Response

​Understanding the Response

​Next Steps

Introduction

Prerequisites

Step 1: Set Up Your Project

Step 2: Create the Script

Step 3: Run the Script

Example Response

Understanding the Response

Next Steps