MPPtempoquality 0.88

Aggregated token balances held by smart money traders and funds across multiple blockchains.

Price
$0.05 / call
Protocol
mpp
Verified
no
Endpoint
https://api.nansen.ai/api/v1/smart-money/holdings

What it does

The Nansen Smart Money Holdings endpoint returns aggregated token balances currently held by sophisticated traders and funds across multiple chains (Ethereum, Solana, Base, BNB, Arbitrum, and more). It excludes whales, large holders, and influencers to focus specifically on trading expertise. Data includes 24-hour balance change tracking updated in real time, sector categorization for tokens, holder counts, market cap, token age, and share-of-holdings percentages.

The endpoint accepts a POST request with a JSON body specifying chains to analyze and optional filters such as smart money label inclusion/exclusion (Fund, Smart Trader, 30D/90D/180D Smart Trader), stablecoin/native token toggles, value ranges, holder counts, token age, market cap, and token sector. Results are paginated (up to 1000 per page) and sortable by fields like value_usd, holders_count, balance_24h_percent_change, and more.

Pricing is $0.05 per call via the x402 protocol. The endpoint also supports Nansen's credit system (50 credits on free tier, 5 on pro). Rate limits are enforced per-second and per-minute, reported via response headers. The API uses OpenAPI 3.1 and requires an API key in the `apiKey` header, or x402 payment via the `Payment-Signature` header.

Capabilities

smart-money-holdingsmulti-chain-analyticstoken-balance-aggregation24h-balance-changesector-categorizationsmart-money-label-filteringpaginationsortingx402-payment

Use cases

  • —Identify which tokens sophisticated traders are accumulating across chains
  • —Monitor 24-hour balance changes of smart money wallets for trading signals
  • —Screen tokens by sector and smart money holder count for research
  • —Build dashboards showing smart money allocation shifts in real time
  • —Filter holdings by market cap, token age, or specific smart money labels for alpha generation

Fit

Best for

  • —Crypto traders tracking smart money accumulation patterns
  • —DeFi researchers analyzing fund and smart trader portfolios
  • —Trading bots that need real-time smart money position data
  • —Portfolio managers benchmarking against sophisticated on-chain participants

Not for

  • —Historical time-series analysis (use the historical-holdings endpoint instead)
  • —Individual wallet-level breakdowns (this returns aggregated data only)
  • —Non-crypto or traditional finance portfolio tracking

Quick start

curl -X POST https://api.nansen.ai/api/v1/smart-money/holdings \
  -H 'Content-Type: application/json' \
  -H 'apiKey: YOUR_API_KEY' \
  -d '{"chains":["ethereum"],"pagination":{"page":1,"per_page":10}}'

Example

Request

{
  "chains": [
    "ethereum",
    "solana"
  ],
  "filters": {
    "value_usd": {
      "min": 1000
    },
    "token_age_days": {
      "max": 365
    },
    "include_stablecoins": false,
    "include_native_tokens": false,
    "include_smart_money_labels": [
      "Fund",
      "Smart Trader"
    ]
  },
  "order_by": [
    {
      "field": "value_usd",
      "direction": "DESC"
    }
  ],
  "pagination": {
    "page": 1,
    "per_page": 10
  }
}

Response

{
  "data": [
    {
      "chain": "ethereum",
      "value_usd": 5200000.5,
      "token_symbol": "PEPE",
      "holders_count": 87,
      "token_address": "0x6982508145454ce325ddbe47a25d4ec3d2311933",
      "token_sectors": [
        "Memecoin"
      ],
      "market_cap_usd": 3500000000,
      "token_age_days": 420,
      "share_of_holdings_percent": 0.035,
      "balance_24h_percent_change": 0.12
    }
  ],
  "pagination": {
    "page": 1,
    "per_page": 10,
    "is_last_page": false
  }
}

Endpoint

URLhttps://api.nansen.ai/api/v1/smart-money/holdings
Transporthttp
Protocolmpp
CurrencypathUSD

Quality

0.88/ 1.00

Full OpenAPI 3.1 schema with detailed request/response models, clear pricing ($0.05/call via x402), and a live 402 MPP challenge confirmed. Docs are embedded in the OpenAPI spec rather than external pages, and no example responses were captured from the probe, but the schema is comprehensive enough to infer them confidently.

Warnings

  • —No external documentation pages were reachable (docs, pricing, README all returned 404-like errors); all information is derived from the OpenAPI spec.
  • —Response schema references ($ref SmartMoneyHoldingsResponse) were not fully resolved in the probe bundle, so the example response is inferred from field descriptions in the OpenAPI spec.

Citations

Provenance

Indexed frommpp_dev
Enriched2026-04-19 15:47:37Z · anthropic/claude-opus-4.6 · v2
First seen2026-04-18
Last seen2026-04-22

Agent access

JSONhttps://clawmart.sh/api/listings/mZBy6p
Aggregated token balances held by smart money traders and funds across multiple blockchains. — Clawmart · Clawmart