Skip to main content
POST
/
discovery
/
tokens
Returns a list of tokens that match the specified filters and criteria
curl --request POST \
  --url https://deep-index.moralis.io/api/v2.2/discovery/tokens \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '
{
  "chain": "0x1",
  "filters": [
    {
      "metric": "experiencedBuyers",
      "timeFrame": "oneMonth",
      "gt": 100
    }
  ],
  "sortBy": {
    "metric": "experiencedBuyers",
    "timeFrame": "oneHour",
    "type": "DESC"
  },
  "limit": 100,
  "chains": [
    "eth"
  ],
  "categories": {
    "include": [
      "<string>"
    ],
    "exclude": [
      "<string>"
    ]
  },
  "timeFramesToReturn": [],
  "metricsToReturn": [],
  "excludeMetadata": false
}
'
{
  "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": false,
      "isMintable": true,
      "hiddenOwner": false,
      "buyTax": "0",
      "sellTax": "0",
      "cannotBuy": false,
      "cannotSellAll": false,
      "isHoneyPot": false,
      "securityScore": 70,
      "possibleSpam": false
    },
    "totalSupply": "1000000000",
    "fullyDilutedValue": 1000000000,
    "circulatingSupply": 1000000000,
    "marketCap": 1000000000,
    "totalHolders": 100000,
    "totalLiquidityUsd": 100000,
    "links": {
      "bitbucket": "<string>",
      "discord": "<string>",
      "facebook": "<string>",
      "github": "<string>",
      "instagram": "<string>",
      "linkedin": "<string>",
      "medium": "<string>",
      "reddit": "<string>",
      "telegram": "<string>",
      "tiktok": "<string>",
      "twitter": "<string>",
      "website": "<string>",
      "youtube": "<string>"
    },
    "categories": [
      "<string>"
    ]
  },
  "metrics": {}
}

Documentation Index

Fetch the complete documentation index at: https://docs.moralis.com/llms.txt

Use this file to discover all available pages before exploring further.

Deprecated — scheduled for removal on June 4, 2026. See the changelog for details and migration guidance.

Authorizations

​
X-API-Key
string
header
default:test
required

Body

application/json
​
chain
string
required

The blockchain identifier

Example:

"0x1"

​
filters
object[]
required

List of filters to apply

​
sortBy
object
required

Metric and time frame to sort by

​
limit
number
required

Maximum number of results

Example:

100

​
chains
enum<string>[]
Available options:
eth,
0x1,
sepolia,
0xaa36a7,
polygon,
0x89,
bsc,
0x38,
bsc testnet,
0x61,
avalanche,
0xa86a,
fantom,
0xfa,
cronos,
0x19,
arbitrum,
0xa4b1,
chiliz,
0x15b38,
chiliz testnet,
0x15b32,
gnosis,
0x64,
gnosis testnet,
0x27d8,
base,
0x2105,
base sepolia,
0x14a34,
optimism,
0xa,
polygon amoy,
0x13882,
linea,
0xe708,
moonbeam,
0x504,
moonriver,
0x505,
moonbase,
0x507,
linea sepolia,
0xe705,
flow,
0x2eb,
flow-testnet,
0x221,
ronin,
0x7e4,
ronin-testnet,
0x31769,
lisk,
0x46f,
lisk-sepolia,
0x106a,
pulse,
0x171,
sei-testnet,
0x530,
sei,
0x531,
monad,
0x8f,
solana
​
categories
object

Categories to filter tokens

​
timeFramesToReturn
enum<string>[]

List of time frames to return in the response

Available options:
oneMonth,
tenMinutes,
thirtyMinutes,
oneHour,
fourHours,
twelveHours,
oneDay,
oneWeek
Example:
[]
​
metricsToReturn
enum<string>[]

List of metrics to return in the response

Available options:
experiencedBuyers,
tokenAge,
holders,
buyers,
sellers,
netBuyers,
experiencedSellers,
netExperiencedBuyers,
fullyDilutedValuation,
marketCap,
usdPrice,
usdPricePercentChange,
liquidityChange,
liquidityChangeUSD,
volumeUsd,
buyVolumeUsd,
sellVolumeUsd,
netVolumeUsd,
securityScore,
totalHolders,
totalLiquidityUsd
Example:
[]
​
excludeMetadata
boolean

Whether to exclude metadata from the response

Example:

false

Response

200 - application/json

Returns the token details

​
metadata
object
​
metrics
object