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 Business plan or higher.

For FAQs and more information about the filtered tokens API, please check out our Filtered Tokens FAQ.

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

Returns filtered tokens based on specified metrics and criteria.

BODY PARAM

chainstringrequired

The chain ID in hex format for EVM chains else solana

filtersarrayrequired

Array of filter criteria

filters[0]

metricstring

The metric to filter on

timeFramestring

The time frame for the filter

gtstring

Greater-than value for the filter.

ltstring

Less-than value for the filter.

eqstring

Equal to value for the filter.

sortByobject

Sorting criteria

metricstringrequired

Metric to sort by

timeFramestringrequired

Time frame for the metric

typestringrequired

Sort direction (ASC or DESC)

timeFramesToReturnarray

List of time frames to include in the response.

No items in the array

metricsToReturnarray

Metrics to include in response

No items in the array

limitnumber

Maximum number of results to return

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: 'POST',
  headers: {
    accept: 'application/json',
    'content-type': 'application/json',
    'X-API-Key': 'YOUR_API_KEY'
  },
  body: JSON.stringify({
    "chain": "solana",
    "filters": [
      {
        "metric": "experiencedBuyers",
        "timeFrame": "oneMonth",
        "gt": "10"
      }
    ],
    "sortBy": {
      "metric": "experiencedBuyers",
      "timeFrame": "oneMonth",
      "type": "DESC"
    },
    "limit": 5
  })
};

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": "solana",
  "filters": [
    {
      "metric": "experiencedBuyers",
      "timeFrame": "oneMonth",
      "gt": "10"
    }
  ],
  "sortBy": {
    "metric": "experiencedBuyers",
    "timeFrame": "oneMonth",
    "type": "DESC"
  },
  "limit": 5
}
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)

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": "solana",
  "filters": [
    {
      "metric": "experiencedBuyers",
      "timeFrame": "oneMonth",
      "gt": "10"
    }
  ],
  "sortBy": {
    "metric": "experiencedBuyers",
    "timeFrame": "oneMonth",
    "type": "DESC"
  },
  "limit": 5
}
'

Go

package main

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

func main() {

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

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

  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, _ := 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('POST', 'https://deep-index.moralis.io/api/v2.2/discovery/tokens', [
  'body' => '{"chain":"solana","filters":[{"metric":"experiencedBuyers","timeFrame":"oneMonth","gt":"10"}],"sortBy":{"metric":"experiencedBuyers","timeFrame":"oneMonth","type":"DESC"},"limit":5}',
  '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": ""
    }
  }
}