Get Filtered 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 the filtered tokens API, please check out our Filtered Tokens FAQ. For tutorials, please see the Filtered Tokens API tutorials.

POSThttps://deep-index.moralis.io/api/v2.2/discovery/tokens

Returns filtered tokens based on specified metrics and criteria.

BODY PARAM

Request Bodyobjectrequired

The request payload for filtering tokens

{ "chain": "0x1", "filters": [ { "metric": "experiencedBuyers", "timeFrame": "oneMonth", "gt": "10" } ], "sortBy": { "metric": "experiencedBuyers", "timeFrame": "oneMonth", "type": "DESC" }, "timeFramesToReturn": [], "metricsToReturn": [], "limit": "25" }

Responses

200Returns filtered token data

400Bad Request

404Not Found

429Too Many Requests

500Internal Server Error

API KEY

cURL

curl --request POST \
     --url 'https://deep-index.moralis.io/api/v2.2/discovery/tokens' \
     --header 'accept: application/json' \
     --header 'X-API-Key: YOUR_API_KEY' \
     --header 'content-type: application/json' \
     --data '
{
  "chain": "0x1",
  "filters": [
    {
      "metric": "experiencedBuyers",
      "timeFrame": "oneMonth",
      "gt": "10"
    }
  ],
  "sortBy": {
    "metric": "experiencedBuyers",
    "timeFrame": "oneMonth",
    "type": "DESC"
  },
  "limit": "25"
}
'

Node.js

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

const options = {
  method: 'POST',
  headers: {
    accept: 'application/json',
    'content-type': 'application/json',
    'X-API-Key': 'YOUR_API_KEY'
  },
  body: JSON.stringify({
    "chain": "0x1",
    "filters": [
      {
        "metric": "experiencedBuyers",
        "timeFrame": "oneMonth",
        "gt": "10"
      }
    ],
    "sortBy": {
      "metric": "experiencedBuyers",
      "timeFrame": "oneMonth",
      "type": "DESC"
    },
    "limit": "25"
  })
};

fetch('https://deep-index.moralis.io/api/v2.2/discovery/tokens', 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/discovery/tokens"

payload = {
  "chain": "0x1",
  "filters": [
    {
      "metric": "experiencedBuyers",
      "timeFrame": "oneMonth",
      "gt": "10"
    }
  ],
  "sortBy": {
    "metric": "experiencedBuyers",
    "timeFrame": "oneMonth",
    "type": "DESC"
  },
  "limit": "25"
}
headers = {
  "Accept": "application/json",
  "Content-Type": "application/json",
  "X-API-Key": "YOUR_API_KEY"
}

response = requests.request("POST", url, json=payload, headers=headers)

print(response.text)

Go

package main

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

func main() {

  url := "https://deep-index.moralis.io/api/v2.2/discovery/tokens"

  payload := strings.NewReader("{\"chain\":\"0x1\",\"filters\":[{\"metric\":\"experiencedBuyers\",\"timeFrame\":\"oneMonth\",\"gt\":\"10\"}],\"sortBy\":{\"metric\":\"experiencedBuyers\",\"timeFrame\":\"oneMonth\",\"type\":\"DESC\"},\"limit\":\"25\"}")

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

  req.Header.Add("Accept", "application/json")
  req.Header.Add("Content-Type", "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('POST', 'https://deep-index.moralis.io/api/v2.2/discovery/tokens', [
  'body' => '{"chain":"0x1","filters":[{"metric":"experiencedBuyers","timeFrame":"oneMonth","gt":"10"}],"sortBy":{"metric":"experiencedBuyers","timeFrame":"oneMonth","type":"DESC"},"limit":"25"}',
  'headers' => [
    'Accept' => 'application/json',
    'X-API-Key' => 'YOUR_API_KEY',
    'Content-Type' => 'application/json',
  ],
]);

echo $response->getBody();

Response Example

200 Returns filtered token data

{
  "metadata": {
    "tokenAddress": "0x55d398326f99059ff775485246999027b3197955",
    "chainId": "0x1",
    "name": "Tether USD",
    "symbol": "USDT",
    "decimals": 18,
    "logo": "https://example.com/logo.png",
    "blockNumberMinted": 176416,
    "usdPrice": 0.9982436729635321,
    "security": {
      "isOpenSource": true,
      "isProxy": "",
      "isMintable": true,
      "hiddenOwner": "",
      "buyTax": "0",
      "sellTax": "0",
      "cannotBuy": "",
      "cannotSellAll": "",
      "isHoneyPot": ""
    }
  }
}