Smart Money

The SmartMoney service provides access to Nansen's Smart Money intelligence: net capital flows, aggregated holdings, and real-time DEX trading activity.

Access it via client.SmartMoney.

Netflow

Netflow returns net capital flows for smart money wallets, aggregated by token.

Endpoint: POST /api/v1/smart-money/netflow

Request

type SmartMoneyNetflowRequest struct {
    Chains     []Chain                      `json:"chains"`
    Filters    *SmartMoneyNetflowFilters    `json:"filters,omitempty"`
    Pagination *PaginationRequest           `json:"pagination,omitempty"`
    OrderBy    []SortOrder                  `json:"order_by,omitempty"`
}

Filters (SmartMoneyNetflowFilters):

Field	Type	Description
IncludeSmartMoneyLabels	[]SmartMoneyLabel	Include only wallets with these labels.
ExcludeSmartMoneyLabels	[]SmartMoneyLabel	Exclude wallets with these labels.
TokenAddress	interface{}	Filter by a specific token address or list of addresses.
IncludeStablecoins	*bool	Whether to include stablecoins.
IncludeNativeTokens	*bool	Whether to include native tokens (e.g., ETH).
TokenSector	[]string	Filter by token sector(s).
TraderCount	*IntegerRangeFilter	Filter by number of unique traders.
TokenAgeDays	*NumericRangeFilter	Filter by token age in days.
MarketCapUSD	*NumericRangeFilter	Filter by market capitalisation in USD.

Sort fields (SmartMoneyNetflowSortField):

chain, token_address, token_symbol, net_flow_1h_usd, net_flow_24h_usd, net_flow_7d_usd, net_flow_30d_usd, token_sectors, trader_count, token_age_days, market_cap_usd

Example

resp, err := client.SmartMoney.Netflow(ctx, &nansen.SmartMoneyNetflowRequest{
    Chains: []nansen.Chain{nansen.ChainSolana},
    Filters: &nansen.SmartMoneyNetflowFilters{
        IncludeSmartMoneyLabels: []nansen.SmartMoneyLabel{nansen.LabelFund},
        IncludeStablecoins:      nansen.BoolPtr(false),
    },
    Pagination: &nansen.PaginationRequest{
        Page:    nansen.IntPtr(1),
        PerPage: nansen.IntPtr(10),
    },
    OrderBy: []nansen.SortOrder{
        {Field: string(nansen.NetflowSortNetFlow7DUSD), Direction: nansen.SortDesc},
    },
})

Response

Each item in resp.Data is a SmartMoneyNetflow:

Field	Type	Description
TokenAddress	string	Contract address of the token.
TokenSymbol	string	Token ticker symbol.
NetFlow1HUsd	*float64	Net flow in the last 1 hour (USD).
NetFlow24HUsd	*float64	Net flow in the last 24 hours (USD).
NetFlow7DUsd	*float64	Net flow in the last 7 days (USD).
NetFlow30DUsd	*float64	Net flow in the last 30 days (USD).
Chain	string	Blockchain the token is on.
TokenSectors	[]string	Sector classifications.
TraderCount	int	Number of unique smart money traders.
TokenAgeDays	int	Age of the token in days.
MarketCapUsd	*float64	Market capitalisation in USD.

---

Holdings

Holdings returns aggregated token balances held by smart money wallets.

Endpoint: POST /api/v1/smart-money/holdings

Request

type SmartMoneyHoldingsRequest struct {
    Chains     []Chain                       `json:"chains"`
    Filters    *SmartMoneyHoldingsFilters    `json:"filters,omitempty"`
    Pagination *PaginationRequest            `json:"pagination,omitempty"`
    OrderBy    []SortOrder                   `json:"order_by,omitempty"`
}

Sort fields (SmartMoneyHoldingsSortField):

chain, token_address, token_symbol, value_usd, balance_24h_percent_change, holders_count, share_of_holdings_percent, token_age_days, market_cap_usd

Example

resp, err := client.SmartMoney.Holdings(ctx, &nansen.SmartMoneyHoldingsRequest{
    Chains: []nansen.Chain{nansen.ChainEthereum},
    Filters: &nansen.SmartMoneyHoldingsFilters{
        IncludeStablecoins: nansen.BoolPtr(false),
    },
    Pagination: &nansen.PaginationRequest{
        Page:    nansen.IntPtr(1),
        PerPage: nansen.IntPtr(10),
    },
    OrderBy: []nansen.SortOrder{
        {Field: string(nansen.HoldingsSortValueUSD), Direction: nansen.SortDesc},
    },
})

---

DEX Trades

DEXTrades returns real-time DEX trading activity from smart money wallets.

Endpoint: POST /api/v1/smart-money/dex-trades

Request

type SmartMoneyDexTradesRequest struct {
    Chains     []Chain                        `json:"chains"`
    Filters    *SmartMoneyDexTradesFilters    `json:"filters,omitempty"`
    Pagination *PaginationRequest             `json:"pagination,omitempty"`
    OrderBy    []SortOrder                    `json:"order_by,omitempty"`
}

Sort fields (SmartMoneyDexTradesSortField):

chain, block_timestamp, transaction_hash, trader_address, trader_address_label, token_bought_address, token_sold_address, token_bought_amount, token_sold_amount, token_bought_symbol, token_sold_symbol, token_bought_age_days, token_sold_age_days, token_bought_market_cap, token_sold_market_cap, token_bought_fdv, token_sold_fdv, trade_value_usd

Example

resp, err := client.SmartMoney.DEXTrades(ctx, &nansen.SmartMoneyDexTradesRequest{
    Chains: []nansen.Chain{nansen.ChainEthereum, nansen.ChainSolana},
    Pagination: &nansen.PaginationRequest{
        Page:    nansen.IntPtr(1),
        PerPage: nansen.IntPtr(5),
    },
    OrderBy: []nansen.SortOrder{
        {Field: string(nansen.DexTradesSortTradeValueUSD), Direction: nansen.SortDesc},
    },
})