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": {}
}
Endpoint cost: CUs. Learn more about compute units.

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,
0x7e5,
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