Get Token Pairs by Address Mainnet Only

GEThttps://deep-index.moralis.io/api/v2.2/erc20/:token_address/pairs

Get the supported pairs for a specific token address.

PATH PARAMS

token_addressstringrequired

The address of the token contract

QUERY PARAMS

chainstring

The chain to query

limitnumber

The desired page size of the result.

cursorstring

The cursor returned in the previous response (used for getting the next page).

Responses

200Returns the supported pairs for the token.

400Bad Request

404Not Found

429Too Many Requests

500Internal Server Error

API KEY

cURL
Node.js
Python
Go
PHP

curl --request GET \
     --url 'https://deep-index.moralis.io/api/v2.2/erc20/0x6982508145454ce325ddbe47a25d4ec3d2311933/pairs?chain=eth&limit=25' \
     --header 'accept: application/json' \
     --header 'X-API-Key: YOUR_API_KEY' 

// Node.js v18+ has native fetch support
// No additional dependencies required

const options = {
  method: 'GET',
  headers: {
    accept: 'application/json',
    'X-API-Key': 'YOUR_API_KEY'
  },
};

fetch('https://deep-index.moralis.io/api/v2.2/erc20/0x6982508145454ce325ddbe47a25d4ec3d2311933/pairs?chain=eth&limit=25', options)
  .then(response => response.json())
  .then(response => console.log(response))
  .catch(err => console.error(err));

# Dependencies to install:
# $ python -m pip install requests

import requests

url = "https://deep-index.moralis.io/api/v2.2/erc20/0x6982508145454ce325ddbe47a25d4ec3d2311933/pairs?chain=eth&limit=25"

headers = {
  "Accept": "application/json",
  "X-API-Key": "YOUR_API_KEY"
}

response = requests.request("GET", url, headers=headers)

print(response.text)

package main

import (
  "fmt"
  "net/http"
  "io"
)

func main() {

  url := "https://deep-index.moralis.io/api/v2.2/erc20/0x6982508145454ce325ddbe47a25d4ec3d2311933/pairs?chain=eth&limit=25"

  req, _ := http.NewRequest("GET", url, payload)

  req.Header.Add("Accept", "application/json")
  req.Header.Add("X-API-Key", "YOUR_API_KEY")

  res, _ := http.DefaultClient.Do(req)

  defer res.Body.Close()
  body, _ := io.ReadAll(res.Body)

  fmt.Println(res)
  fmt.Println(string(body))

}

<?php
// Dependencies to install:
// $ composer require guzzlehttp/guzzle

require_once('vendor/autoload.php');

$client = new \GuzzleHttp\Client();

$response = $client->request('GET', 'https://deep-index.moralis.io/api/v2.2/erc20/0x6982508145454ce325ddbe47a25d4ec3d2311933/pairs?chain=eth&limit=25', [
  'headers' => [
    'Accept' => 'application/json',
    'X-API-Key' => 'YOUR_API_KEY',
  ],
]);

echo $response->getBody();

Response Example

{
  "cursor": "string",
  "page_size": 100,
  "page": 2,
  "pairs": [
    {
      "exchange_address": "0x1f98431c8ad98523631ae4a59f267346ea31f984",
      "exchange_name": "Uniswap v3",
      "exchange_logo": "https://entities-logos.s3.us-east-1.amazonaws.com/uniswap.png",
      "pair_label": "USDC/WETH",
      "pair_address": "0x88e6a0c2ddd26feeb64f039a2c41296fcb3f5640",
      "from_address_entity_logo": "https://opensea.io/favicon.ico",
      "usd_price": 1.0006209353320241,
      "usd_price_24hr_percent_change": -0.060345507380585806,
      "usd_price_24hr_usd_change": -0.0006041943845493947,
      "liquidity_usd": 147124866.6,
      "base_token": "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48",
      "quote_token": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
      "pair": [
        {
          "token_address": "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48",
          "token_name": "USD Coin",
          "token_symbol": "USDC",
          "token_logo": "https://logo.moralis.io/0x1_0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48_d021d841dc113e213b32a0cb11ec2f86",
          "token_decimals": "6",
          "pair_token_type": "token0",
          "liquidity_usd": 81480213.24
        }
      ]
    }
  ]
}

Don't have an API key yet?

Get Token Pairs by Address Mainnet Only

Looking for token pairs by address on Solana?