How to Get Token Pairs and Liquidity Data

Introduction

In this tutorial, you’ll learn how to retrieve all trading pairs and liquidity data for any ERC20 token using the Moralis API. This includes pair addresses, liquidity amounts, volume data, and exchange information. This is essential for building token analytics, DEX aggregators, or trading interfaces. We’ll use the following Moralis API endpoint:

Get Token Pairs - Fetch all trading pairs and liquidity data for a token

Prerequisites

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

Step 1: Set Up Your Project

Create a new directory for your project and initialize it:

mkdir get-token-pairs && cd get-token-pairs
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';
const TOKEN_ADDRESS = '0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48'; // USDC

async function getTokenPairs() {
  const response = await fetch(
    `https://deep-index.moralis.io/api/v2.2/erc20/${TOKEN_ADDRESS}/pairs?chain=eth`,
    {
      headers: {
        'X-API-Key': API_KEY,
      },
    }
  );

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

getTokenPairs();

Replace YOUR_API_KEY with your actual Moralis API key.

Step 3: Run the Script

Execute the script to fetch the token pairs:

node index.js

Example Response

{
  "page": 1,
  "page_size": 100,
  "cursor": null,
  "result": [
    {
      "pairAddress": "0x88e6a0c2ddd26feeb64f039a2c41296fcb3f5640",
      "pairLabel": "WETH/USDC",
      "exchange": "uniswapv3",
      "exchangeAddress": "0x1f98431c8ad98523631ae4a59f267346ea31f984",
      "exchangeLogo": "https://cdn.moralis.io/eth/0x1f98431c8ad98523631ae4a59f267346ea31f984.png",
      "token0": {
        "address": "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48",
        "name": "USD Coin",
        "symbol": "USDC",
        "decimals": 6,
        "logo": "https://cdn.moralis.io/eth/0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48.png"
      },
      "token1": {
        "address": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
        "name": "Wrapped Ether",
        "symbol": "WETH",
        "decimals": 18,
        "logo": "https://cdn.moralis.io/eth/0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2.png"
      },
      "usdPrice": 3500.50,
      "usdPriceFormatted": "3500.50",
      "liquidityUsd": 250000000,
      "volume24h": 15000000,
      "priceChange24h": 2.5
    }
  ]
}

Understanding the Response

Field	Description
`pairAddress`	The liquidity pair contract address
`pairLabel`	Human-readable pair name (e.g., WETH/USDC)
`exchange`	DEX name (uniswapv2, uniswapv3, sushiswap)
`token0` / `token1`	Token metadata for both sides of the pair
`usdPrice`	Current price in USD
`liquidityUsd`	Total liquidity in USD
`volume24h`	24-hour trading volume in USD
`priceChange24h`	24-hour price change percentage

Next Steps

Get OHLC Data - Get price history
Get Pair Stats - detailed market data
Build a DEX Screener - Build a trading dashboard
API Reference - Full API documentation

​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