🚀Make Your First API Call

Welcome! In the next 2 minutes, you’ll make your first API call and unlock real-time blockchain insights.

Step 1: Get your API key

• Log in at Nansen (Click here)

• Navigate to the API tab in the left sidebar.

• Click Create API Key (See screenshot below for where to find this button)

• Copy your API Key

Step 2: Run this cURL Command

curl -L \
  --request POST \
  --url 'https://api.nansen.ai/api/v1/token-screener' \
  --header 'apiKey: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "chains": [
      "ethereum",
      "solana",
      "base"
    ],
    "date": {
      "from": "2025-01-01T00:00:00Z",
      "to": "2025-01-31T23:59:59Z"
    },
    "pagination": {
      "page": 1,
      "per_page": 10
    },
    "filters": {
      "only_smart_money": true,
      "token_age_days": {
        "max": 365,
        "min": 1
      }
    },
    "order_by": [
      {
        "field": "chain",
        "direction": "ASC"
      }
    ]
  }'

Step 3: Now try this in API Explorer

• Click on Test It button on the API codeblock below

• Paste your API Key under the value section (As shown in the screenshot)

  
• Click on "Send" or press CMD + Enter.

Get Token Screening Data

post

Discover and screen tokens across multiple blockchains with advanced filtering capabilities. This endpoint helps identify trending tokens, new launches, and smart money movements by combining metrics like volume, liquidity, market cap, and trading activity.

What it helps to answer:

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

ApiKeyAuth

apiKeystringRequired

API key for authentication

Body

application/json

Request model for Token Screener endpoint.

filtersany ofOptional

Additional filters to apply

Example: {"only_smart_money":true,"token_age_days":{"max":365,"min":1}}

order_byany ofOptional

Custom sort order to override the endpoint's default ordering.

Examples:

• [{"field": "buy_volume", "direction": "DESC"}] - Sort by buy volume descending
• [{"field": "price_change", "direction": "DESC"}] - Sort by price change descending

Responses

200

Token screening data

application/json

400

Bad Request

application/json

401

Unauthorized

application/json

403

Forbidden

application/json

404

Not Found

application/json

422

Unprocessable Entity

application/json

429

Too Many Requests

application/json

500

Internal Server Error

application/json

post

/api/v1/token-screener

HTTPcURLJavaScriptPython

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

{
  "chains": [
    "ethereum",
    "solana",
    "base"
  ],
  "date": {
    "from": "2025-01-01T00:00:00Z",
    "to": "2025-01-31T23:59:59Z"
  },
  "pagination": {
    "page": 1,
    "per_page": 10
  },
  "filters": {
    "only_smart_money": true,
    "token_age_days": {
      "max": 365,
      "min": 1
    }
  },
  "order_by": [
    {
      "field": "chain",
      "direction": "ASC"
    }
  ]
}

{
  "data": [
    {
      "chain": "text",
      "token_address": "text",
      "token_symbol": "text",
      "token_age_days": 1,
      "market_cap_usd": 1,
      "liquidity": 1,
      "price_usd": 1,
      "price_change": 1,
      "fdv": 1,
      "fdv_mc_ratio": 1,
      "buy_volume": 1,
      "inflow_fdv_ratio": 1,
      "outflow_fdv_ratio": 1,
      "sell_volume": 1,
      "volume": 1,
      "netflow": 1
    }
  ],
  "pagination": {
    "page": 1,
    "per_page": 10,
    "is_last_page": true
  }
}

Next Steps

1. Checkout these Usecase Templates

📜Use case Templates

1. Checkout all the available endpoints

Smart MoneyToken God ModeProfilerPortfolio