Holdings

Deprecation Notice: The ‎/beta API endpoints will be deprecated on 01 October 2025. Please migrate your integrations to the ‎/v1 endpoints before this date to ensure uninterrupted service.

smart-money/holdings

post

This model provides holdings of tokens by Smart Money addresses.

Questions

1. What tokens are Smart Money holding?

Authorizations

ApiKeyAuth

Body

application/json

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

/api/beta/smart-money/holdings

HTTPcURLJavaScriptPython

POST /api/beta/smart-money/holdings HTTP/1.1
Host: api.nansen.ai
apiKey: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 220

{
  "parameters": {
    "smFilter": [
      "180D Smart Trader",
      "Fund",
      "Smart Trader"
    ],
    "chains": [
      "ethereum",
      "solana"
    ],
    "includeStablecoin": true,
    "includeNativeTokens": true,
    "excludeSmFilter": []
  },
  "pagination": {
    "page": 1,
    "recordsPerPage": 100
  }
}

[
  {
    "chain": "text",
    "tokenAddress": "text",
    "symbol": "text",
    "sectors": [
      "text"
    ],
    "balanceUsd": 1,
    "balancePctChange24H": 1,
    "nofHolders": "text",
    "shareOfHoldings": 1,
    "tokenAgeDays": "text",
    "marketCap": 1
  }
]

Usage Tips

• To query smart money activity across all chains, simply use

  "chains": []

• To query smart money activity across multiple chains, specify the chains in the array

    "chains": [
              "solana",
              "base"
          ],

• You can also use filters to only query smart money data for tokens of interest by adding these filters:

     "filters": {
          "symbol": [
              "FARTCOIN",
              "USELESS"
          ]
      },
  
  or 
  
      "filters": {
          "tokenAddress": [
              "9BB6NFEcjBCtnNLFko2FqVQBq8HHM13kCyYcdQbgpump"
          ]
      },

• You can also filter responses based on token age or sectors

     "filters": {
          "tokenAgeDays": {
              "from": 0,
              "to": 30
          },
          "sectors": [
              "GameFi"
          ]
      },