Nansen API
  • ✨Introduction
  • 📌Endpoints Overview
  • 🔴Rate Limits
  • 📈Credits & Pricing Guide
  • Getting Started
    • ☑️Prerequisites
    • 🌐API Structure & Base URL
    • 🔓Authentication
    • 🟢Understanding Responses and Handling Errors
    • ⛓️Chain Coverage
  • 📜Data Redistribution Guidelines
  • API
    • Smart Money
    • Profiler
      • Balances
      • Transactions
      • Counterparties
      • Trade Performance
    • Token God Mode
      • Token Overview
      • Holders
      • Flows
      • Transactions
      • PnL Leaderboard
  • Guides
    • 💻Endpoint Showcase
    • 🙋Frequently Asked Questions
  • 🔗Useful Links
Powered by GitBook
On this page

Was this helpful?

Export as PDF
  1. API

Smart Money

PreviousData Redistribution GuidelinesNextProfiler

Last updated 20 days ago

Was this helpful?

A curated list of the top 5 000 highest-performing wallets ranked by realised profit, winrate, and strong performance across market cycles. Available Smart Money labels:

  • 30D Smart Trader

  • 90D Smart Trader

  • 180D Smart Trader

  • Fund

  • Smart Trader

Performance Tips

To ensure you get the fastest and most reliable results from the Smart Money endpoints, follow this key recommendation:

  • Query up to 2 chains at a time for faster and more reliable responses.

  • Avoid querying all chains simultaneously.

  • POSTsmart-money/inflows
  • POSTsmart-money/holdings
  • POSTsmart-money/dex-trades
  • POSTsmart-money/dcas
  • Performance Tips

smart-money/inflows

post

This model provides net flow of tokens bought/sold by Smart Money addresses.

Questions

  1. What are the most commonly traded tokens by smart money addresses in the last day, and how does their trading volume in USD compare?

  2. Are there any new tokens (recently deployed) that have been significantly adopted by smart money traders, as indicated by the amount of USD traded?

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
POST /api/beta/smart-money/inflows 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"
    ],
    "volume24hUSD": 1,
    "volume7dUSD": 1,
    "volume30dUSD": 1,
    "nofTraders": "text",
    "tokenAgeDays": "text",
    "marketCap": 1
  }
]

smart-money/holdings

post

This model provides holdings of tokens by Smart Money addresses.

Questions

  1. What tokens are Smart Money holding?

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
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
  }
]

smart-money/dex-trades

post

This model provides all dex trades of smart money traders in the last 24 hours across all EVM chains. The signer of the transaction is considered as the smart money trader. The trade is based on token transfers of the transaction where the signer is a party to trade. Hence it excludes all intermediary trades and only considers tokens that where provided by signer and the ones received. It excludes transactions where the signer provided or received two or more different tokens.

Questions

  1. What are the latest traded tokens by smart money addresses?

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
POST /api/beta/smart-money/dex-trades HTTP/1.1
Host: api.nansen.ai
apiKey: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 168

{
  "parameters": {
    "chains": [
      "ethereum",
      "solana"
    ],
    "smFilter": [
      "180D Smart Trader",
      "Fund",
      "Smart Trader"
    ],
    "excludeSmFilter": []
  },
  "pagination": {
    "page": 1,
    "recordsPerPage": 100
  }
}
[
  {
    "chain": "text",
    "timestamp": "text",
    "txHash": "text",
    "address": "text",
    "name": "text",
    "tokenBoughtAddress": "text",
    "tokenSoldAddress": "text",
    "tokenBoughtAmount": 1,
    "tokenSoldAmount": 1,
    "tokenBoughtSymbol": "text",
    "tokenSoldSymbol": "text",
    "tokenBoughtAgeDays": "text",
    "tokenSoldAgeDays": "text",
    "tokenBoughtMarketCap": 1,
    "tokenSoldMarketCap": 1,
    "valueInUsd": 1
  }
]

smart-money/dcas

post

List of Jupiter DCA orders with stats per vault, created by Smart Money addresses

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
POST /api/beta/smart-money/dcas HTTP/1.1
Host: api.nansen.ai
apiKey: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 215

{
  "parameters": {
    "chain": "solana",
    "smFilter": [
      "180D Smart Trader",
      "Fund",
      "Smart Trader"
    ],
    "excludeSmFilter": [],
    "tokenAddress": "So11111111111111111111111111111111111111112"
  },
  "pagination": {
    "page": 1,
    "recordsPerPage": 100
  }
}
[
  {
    "sinceTimestamp": "text",
    "lastTimestamp": "text",
    "traderAddress": "text",
    "creationHash": "text",
    "traderLabel": "text",
    "dcaVaultAddress": "text",
    "inputMintAddress": "text",
    "outputMintAddress": "text",
    "depositAmount": "text",
    "depositSpent": "text",
    "otherTokenRedeemed": "text",
    "closed": "text",
    "tokenInput": "text",
    "tokenOutput": "text",
    "depositUsdValue": "text"
  }
]