Search Tokens Mainnet Only Premium Endpoint

💡Premium Endpoint

To use this API, you will need an API key associated with a Moralis account on the Pro plan or higher.

For FAQs and more information about token search, please check out our Token Search API FAQ.

GEThttps://deep-index.moralis.io/api/v2.2/tokens/search

Search for tokens using their contract address, pair address, name, or symbol. Cross-chain by default with support to filter by chains. Additional options to sortBy various metrics, such as market cap, liquidity or volume.

QUERY PARAMS

chainsstring

The chains to query

querystringrequired

The query to search

limitnumber

The desired page size of the result.

isVerifiedContractboolean

True to include only verified contracts

falsetrue

sortBystring

Sort by volume1hDesc, volume24hDesc, liquidityDesc, marketCapDesc

boostVerifiedContractsboolean

True to boost verified contracts

falsetrue

Responses

200Returns the search results

400Bad Request

404Not Found

429Too Many Requests

500Internal Server Error

API KEY

cURL

curl --request GET \
     --url 'https://deep-index.moralis.io/api/v2.2/tokens/search?query=pepe&limit=25&sortBy=volume1hDesc' \
     --header 'accept: application/json' \
     --header 'X-API-Key: YOUR_API_KEY' 

Node.js

// 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/tokens/search?query=pepe&limit=25&sortBy=volume1hDesc', 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/tokens/search?query=pepe&limit=25&sortBy=volume1hDesc"

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

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

print(response.text)

Go

package main

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

func main() {

  url := "https://deep-index.moralis.io/api/v2.2/tokens/search?query=pepe&limit=25&sortBy=volume1hDesc"

  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

<?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/tokens/search?query=pepe&limit=25&sortBy=volume1hDesc', [
  'headers' => [
    'Accept' => 'application/json',
    'X-API-Key' => 'YOUR_API_KEY',
  ],
]);

echo $response->getBody();

Response Example

200 Returns the search results

{
  "total": 10000,
  "result": [
    {
      "tokenAddress": "0x6982508145454ce325ddbe47a25d4ec3d2311933",
      "chainId": "0x1",
      "name": "Pepe",
      "symbol": "PEPE",
      "blockNumber": 17046105,
      "blockTimestamp": 1681483883,
      "usdPrice": 0.000024509478199144,
      "marketCap": 9825629287.860994,
      "securityScore": 92,
      "logo": "https://adds-token-info-29a861f.s3.eu-central-1.amazonaws.com/marketing/evm/0x6982508145454ce325ddbe47a25d4ec3d2311933_icon.png",
      "isVerifiedContract": "",
      "fullyDilutedValuation": 71242582.97741453,
      "totalHolders": 18908,
      "totalLiquidityUsd": 18908.234,
      "implementations": [
        {
          "chain": "eth",
          "address": "0x6982508145454ce325ddbe47a25d4ec3d2311933"
        }
      ]
    }
  ]
}