Get Token Pairs by Address

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

eth0x1sepolia0xaa36a7holesky0x4268polygon0x89polygon amoy0x13882bsc0x38bsc testnet0x61avalanche0xa86afantom0xfapalm0x2a15c308dcronos0x19arbitrum0xa4b1gnosis0x64gnosis testnet0x27d8chiliz0x15b38chiliz testnet0x15b32base0x2105base sepolia0x14a34optimism0xalinea0xe708linea sepolia0xe705moonbeam0x504moonriver0x505moonbase0x507flow0x2ebflow-testnet0x221ronin0x7e4ronin-testnet0x7e5lisk0x46flisk-sepolia0x106a

limitnumber

The desired page size of the result.

cursorstring

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

Responses

API KEY

Node.js

// Dependencies to install:
// $ npm install node-fetch --save
// add "type": "module" to package.json

import fetch from 'node-fetch';

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

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

Python

# Dependencies to install:

# $ python -m pip install requests

import requests

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

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

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

print(response.text)

cURL

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

Go

package main

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

func main() {

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

  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, _ := ioutil.ReadAll(res.Body)

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

}

PHP

<?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/0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48/pairs?chain=eth', [
  'headers' => [
    'Accept' => 'application/json',
    'X-API-Key' => 'YOUR_API_KEY',
  ],
]);

echo $response->getBody();

Response Example

200 Returns the supported pairs for the token.

{
  "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
        }
      ]
    }
  ]
}