Token Screener

token-screener

post

A comprehensive token screening interface that provides real-time analytics and insights across multiple blockchain networks. The screener combines market data, smart money flows, trading metrics, and holder statistics to enable data-driven token analysis and discovery.

Questions

1. Which tokens are experiencing significant smart money activity across different chains?

2. How do market metrics (price, volume, liquidity) correlate with holder behavior and smart money movements?

3. What tokens show strong fundamentals in terms of holder distribution and trading patterns?

4. Which emerging tokens are attracting fresh wallet inflows while maintaining healthy smart money participation?

Authorizations

Body

Responses

200

Successful response

application/json

400

Bad request

application/json

401

Authentication error

application/json

403

Forbidden - Subscription tier required

application/json

500

Internal server error

application/json

post

HTTPcURLJavaScriptPython

POST /api/beta/token-screener HTTP/1.1
Host: api.nansen.ai
apiKey: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 314

{
  "parameters": {
    "chains": [
      "ethereum",
      "solana"
    ],
    "date": {
      "from": "2025-05-01",
      "to": "2025-05-03"
    },
    "watchlistFilter": [
      "0x28c6c06298d514db089934071355e5743bf21d60"
    ],
    "sectorsFilter": [
      "Artificial Intelligence",
      "AI Agents"
    ],
    "smLabelFilter": [
      "Smart Money"
    ],
    "onlySmartMoney": true
  },
  "pagination": {
    "page": 1,
    "recordsPerPage": 100
  }
}

[
  {
    "chain": "text",
    "tokenAddressHex": "text",
    "tokenSymbol": "text",
    "tokenAgeDays": "text",
    "marketCap": 1,
    "liquidity": "text",
    "currentPriceUsd": "text",
    "priceChange": "text",
    "fdv": "text",
    "fdvMcRatio": "text",
    "nofBuyers": "text",
    "nofTraders": "text",
    "nofSellers": "text",
    "nofBuys": "text",
    "nofSells": "text",
    "buyVolume": "text",
    "inflowFdvRatio": "text",
    "outflowFdvRatio": "text",
    "sellVolume": "text",
    "volume": "text",
    "netflow": "text"
  }
]

Parameters & Filters Reference

The Token Screener API request body is composed of two key sections:

• parameters: Controls high-level configuration of the query — e.g., which chains to query, Smart Money toggles, date ranges, and label/scope filters. (Must Haves)

• filters: Defines numeric or categorical constraints for token-level metrics — e.g., liquidity, age, volume, holders, etc.

These work together to define your screening logic.

📌 Parameters

• All parameters in the API request are mandatory.

• If any parameter is missing or incorrectly formatted, the API will return an error and not process the request.

• You can leave parameters empty (e.g., use empty arrays), but you must still include them in the request payload.

chains	Blockchain networks to include (ethereum, base, solana)	Categorical (array of strings)	Can't be empty: must specify an option
onlySmartMoney	Only include tokens traded by Smart Money wallets	Boolean (true / false)	Can't be empty: must specify an option
smLabelFilter	Filter by Smart Money labels (e.g., Fund, Smart Trader)	Categorical (array of strings)	Can be empty
sectorsFilter	Filter by token sectors (e.g., DeFi, Memes)	Categorical (array of strings)	Can be empty
watchlistFilter	Filter by tokens	Categorical (array of token addresses)	Can be empty
date	Restricts trading/activity to a specific time range	Date (from, to) in ISO 8601 format	Can't be empty: must specify a range

🧮 Filters

Filters determine which tokens are returned based on their individual characteristics. You can apply multiple filters at once. All filters are optional. We support two types of filters:

• Categorical (Array of strings): To be used as ["0xab","0xbc"]

• Numeric (from, to): To be used as {"from": "2", "to": "5"}

tokenAgeDays	Token age in days	Numeric (from, to)
buyVolume	Total buy-side volume	Numeric (from, to)
sellVolume	Total sell-side volume	Numeric (from, to)
volume	Total trading volume	Numeric (from, to)
liquidity	Liquidity in pools (USD equivalent)	Numeric (from, to)
marketCap	Market capitalization	Numeric (from, to)
fdv	Fully Diluted Valuation	Numeric (from, to)
netflow	Net inflow (inflows - outflows)	Numeric (from, to)
holders	Number of token holders	Numeric (from, to)
nofBuyers	Count of unique buyers	Numeric (from, to)
nofSellers	Count of unique sellers	Numeric (from, to)
priceChange	Token price movement (e.g., in %)	Numeric (from, to)

Sorting

This endpoint supports sorting. You can use it by adding the column name and order (desc/asc):

  "order": {
    "orderBy": "liquidity", 
    "order": "desc"
  },

Example

Get the most liquid tokens under 7 days old on Ethereum and Base

{
    "parameters": {
      "chains": ["solana"],
      "date": {
        "from": "2025-06-25",
        "to": "2025-06-26"
      },
      "watchlistFilter": [],
      "sectorsFilter": [],
      "smLabelFilter": [],
      "onlySmartMoney": false,
      "tokenAgeDays": {
        "from": "0",
        "to": "7"
      },
    "pagination": {
      "page": 1,
      "recordsPerPage": 100
    },
    "order": {
        "order": "desc",
        "orderBy": "liquidity"
    }
  }
}