Simple Use cases

Use the sample requests and responses to accelerate development and gain actionable insights from blockchain data.

1. Viewing DeFi Positions

Description: Get comprehensive information about a wallet's DeFi positions including balances, values, and token details.

Use Case: Analyze DeFi portfolio performance, track position changes, and understand asset allocation.

Endpoint Documentation: Click Here

cURL Command (Replace your API Key and run this in your terminal):

curl -L \
  --request POST \
  --url 'https://api.nansen.ai/api/v1/portfolio/defi-holdings' \
  --header 'apiKey: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "wallet_address": "0x4062b997279de7213731dbe00485722a26718892"
  }'

Key Benefits:

• Complete portfolio overview across multiple chains

• Real-time balance and value calculations

Common Use Cases:

• Portfolio tracking applications

• DeFi protocol analytics

• Risk management systems

---

2. Viewing Smart Money Holdings

Description: Discover which tokens top traders and funds are holding.

Use Case: Follow smart money movements, identify trending tokens, and make informed investment decisions.

Endpoint Documentation: Click Here

cURL Command (Replace your API Key and run this in your terminal):

curl -L \
  --request POST \
  --url 'https://api.nansen.ai/api/v1/smart-money/holdings' \
  --header 'apiKey: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
  "chains": [
    "ethereum",
    "solana",
    "base"
  ],
  "pagination": {
    "page": 1,
    "per_page": 50
  },
  "order_by": [
    {
      "field": "value_usd",
      "direction": "DESC"
    }
  ]
}'

Key Benefits:

• Identify institutional investment trends

• Track smart money portfolio changes

• Filter by smart money categories

Common Use Cases:

• Investment research and analysis

• Token discovery and trending analysis

• Market sentiment analysis

---

3. Finding Top Holders of a Token

Description: Discover the largest holders of a specific token, including their balances and wallet types.

Use Case: Analyze token distribution, identify major stakeholders, and understand market concentration.

Endpoint Documentation: Click Here

cURL Command (Replace your API Key and run this in your terminal):

curl -L \
  --request POST \
  --url 'https://api.nansen.ai/api/v1/tgm/holders' \
  --header 'apiKey: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "chain": "solana",
    "token_address": "2zMMhcVQEXDtdE6vsFS7S7D5oUodfJHE8vd1gnBouauv",
    "aggregate_by_entity": false,
    "label_type": "all_holders",
    "pagination": {
      "page": 1,
      "per_page": 10
    },
    "order_by": [
      {
        "field": "value_usd",
        "direction": "DESC"
      }
    ]
  }'

Key Benefits:

• Identify major token holders and their types

• Includes individual addresses and aggregated by entity views

• Track balance changes over time

• Understand token distribution patterns

Common Use Cases:

• Token governance analysis

• Market concentration studies

• Risk assessment for token holders

---

4. Using Token Screener to Find New Tokens

Description: Discover new and trending tokens based on various metrics like market cap, token age, volume, and smart money activity.

Use Case: Find emerging opportunities, track new token launches, and identify trending assets.

Endpoint Documentation: Click Here

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-08-27T00:00:00Z",
      "to": "2025-09-03T23:59:59Z"
    },
    "pagination": {
      "page": 1,
      "per_page": 10
    },
    "filters": {
      "token_age_days": {
        "max": 7
      }
    },
    "order_by": [
      {
        "field": "market_cap_usd",
        "direction": "DESC"
      }
    ]
  }'

Key Benefits:

• Discover new token opportunities

• Filter by market cap, volume, sectors and age

• Track trending metrics and holder growth

Common Use Cases:

• Token discovery using different metrics

---

Next Steps

Once you're comfortable with these easy-level use cases, explore:

• Medium Level: Advanced filtering, historical data analysis, and multi-chain operations

• Hard Level: Complex analytics, data aggregation, and real-time monitoring systems

For more information, refer to the complete API documentation and examples in the repository.