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 Business plan or a custom Enterprise plan.

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 based on contract address, token name or token symbol. Premium endpoint available as an add-on. Please contact support for access details.

QUERY PARAMS

querystringrequired

Search query - can be token address, token name or token symbol

chainsstring

The chain(s) to query

limitnumber

The desired page size of the result.

isVerifiedContractboolean

Whether the contract is verified

falsetrue

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/tokens/search?query=pepe&chains=eth&isVerifiedContract=true', 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&chains=eth&isVerifiedContract=true"

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/tokens/search?query=pepe&chains=eth&isVerifiedContract=true' \
     --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/tokens/search?query=pepe&chains=eth&isVerifiedContract=true"

  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/tokens/search?query=pepe&chains=eth&isVerifiedContract=true', [
  'headers' => [
    'Accept' => 'application/json',
    'X-API-Key' => 'YOUR_API_KEY',
  ],
]);

echo $response->getBody();

Response Example

200 Returns search results for tokens

{
  "total": 10,
  "result": [
    {
      "tokenAddress": "0x6982508145454ce325ddbe47a25d4ec3d2311933",
      "chainId": "0x1",
      "name": "Pepe",
      "symbol": "PEPE",
      "blockNumber": 17046105,
      "blockTimestamp": 1681483883,
      "usdPrice": 0.000012302426023896,
      "marketCap": 5056032434.591353,
      "experiencedNetBuyers": {
        "oneDay": -34,
        "oneWeek": -176
      },
      "netVolumeUsd": {
        "oneDay": -212308.385726963
      },
      "liquidityChangeUSD": {
        "oneDay": -298883.8224104196
      },
      "usdPricePercentChange": {
        "oneDay": -3.7369101031758394
      },
      "volumeUsd": {
        "oneDay": 8575800.708427625
      },
      "securityScore": 92,
      "logo": "https://adds-token-info-29a861f.s3.eu-central-1.amazonaws.com/marketing/evm/0x6982508145454ce325ddbe47a25d4ec3d2311933_icon.png",
      "isVerifiedContract": true
    }
  ]
}