Get 25 (per page) addresses or entities with the most common interactions with input addresses Default sort is net value transferred between them. Also returns the top 3 tokens transferred by count for each counterparty

Note: To get related wallets:

• Focus on direct value transfers to get most likely addresses.

• Include CEX deposit addresses (not withdrawal addresses!) as well.

• Also go one level deeper:

  • Find addresses that interacted with the most likely addresses.

  • Find addresses that deposited to the same CEX deposit (NOT withdrawal!) addresses.

• Address structure / string is not important, but the relationship is!

Sorting Options (all fields support "asc"/"desc"): Available for sorting: volOut, volIn, numTxOut, numTxIn, usdNetflow

Examples:

Query by addresses with new type-safe sorting

{ "addresses": ["0x123..."], "sourceInput": "Combined", "groupBy": "wallet", "chain": "ethereum", "timeRange": {"from": "30D_AGO", "to": "NOW"}, "order_by": "usdNetflow", "order_by_direction": "desc" }

Query by entity

{ "entityId": "Binance", "sourceInput": "Combined", "groupBy": "entity", "chain": "all", "timeRange": {"from": "7D_AGO", "to": "NOW"} }

Get historical native coin & token balances of address.

Get comprehensive portfolio overview for a wallet address or entity.

Hyperliquid perpetual positions include liquidation prices to support risk analysis workflows.

For wallet addresses, supports different modes:

• 'fast-mode-default': Wallet balances + Hyperliquid positions (skip defi, for fast mode only)

• 'all': Wallet balances + DeFi positions + Hyperliquid positions

• 'wallet_balances': Only token balances (tokens and native coins across all chains)

• 'defi': Only DeFi positions (lending, staking, LP tokens, etc., excluding Hyperliquid)

• 'hyperliquid': Only Hyperliquid positions (perps include liquidation price, plus spot, staking, vault, free tokens)

For entities (e.g., "Binance", "Paradigm Fund"), only on-chain token balances are returned, aggregated across all addresses associated with the entity.

This tool provides flexible portfolio analysis in a single request, allowing users to focus on specific aspects of their holdings.

The output is pre-formatted markdown that should be presented exactly as returned, preserving all tables, sections, and formatting without reinterpretation.

Example Usage: Get full comprehensive portfolio for a wallet: { "walletAddress": "0x28c6c06298d514db089934071355e5743bf21d60", "mode": "all" }

Get only DeFi positions (returns raw JSON):
```
{
    "walletAddress": "0x28c6c06298d514db089934071355e5743bf21d60",
    "mode": "defi"
}
```

Get only Hyperliquid positions (returns raw JSON):
```
{
    "walletAddress": "0x28c6c06298d514db089934071355e5743bf21d60",
    "mode": "hyperliquid"
}
```

Get token balances for an entity:
```
{
    "entity_id": "Binance"
}
```

Get information about related addresses of an input address.

Note: This only includes the the "special" connections 'First Funder', 'Signer', 'Previous Signer', 'Multisig Signer of', 'Previous Multisig Signer of', 'Deployed via', 'Deployed by', 'Deployed Contract', 'Created Contract', 'Created by'. To get related wallets, also check address counterparties. First funder exchange withdrawal address does usually NOT belong to the same entity as the address, only deposit addresses. Only information is that it has been funded by the exchange.

Examples: # Query by addresses request = AddressRelatedAddressesRequest( addresses=["0x123...", "0x456..."], chain="all" )

Args: request: AddressRelatedAddressesRequest containing parameters and pagination settings

Returns: Formatted related addresses data as markdown table, grouped by chain when chain="evm"

Get list of 20 MOST RECENT transactions made by an address (per page). Only the latest transactions according to the date range are returned.

General search tool. This is your FIRST entry point to look up for possible tokens, entities, and addresses related to a query.

Nansen MCP does not support NFTs, however check using this tool if the query relates to a token. Regular tokens and NFTs can have the same name.

This tool allows you to:

• Check if a (fungible) token exists by name, symbol, or contract address

• Search information about a token

  • Current price in USD

  • Trading volume

  • Contract address and chain information

  • Market cap and supply data when available

• Search information about an entity

• Find Nansen labels of an address (EOA) or resolve a domain (.eth, .sol)

Args: query: The search term - token symbol, name, or address. DO NOT include chain name here! result_type: Type filter - "token", "entity", "eoa", or "any" max_results: Maximum number of results (default: 25, max: 25) chain: Optional chain filter to narrow down token results to specific blockchain. If not further specified, leave it as None. If a chain is specified, ALWAYS use this parameter instead of adding chain name to the query string. Valid values: "ethereum", "solana", "base", "bnb", "polygon", "arbitrum", "avalanche", "optimism", etc.

How to choose result_type:

• token: Use when searching for a token by name, symbol, or contract address. CRITICAL: Use the chain parameter to filter by blockchain, NOT the query string! ✅ CORRECT: query="AAVE", chain="base" ❌ WRONG: query="AAVE base", chain=None

• entity: Use when you want entity info by name/label (exchanges, funds, etc.)

• eoa: Use when you have an address and need its labels or you have an ENS/SNS domain and need the resolved address

• any: Mixed results (tokens/entities). Also auto-resolves ENS/SNS domains and, if token/entity results are empty and the query looks like an address, falls back to EOA labels.

Important:

• This is the only tool that can resolve domains. If you start from a domain, pass the Resolved Address to other tools.

• DOMAINS: Strings ending in .eth (ENS) or .sol (SNS) are DOMAIN NAMES, not tokens. Use result_type="eoa" or "any" to resolve them. Examples: "vitalik.eth", "abracadabra.sol", "y22.eth" are domains that resolve to addresses.

• DO NOT ASSUME that token is a NFT, always verify the name by using this tool first.

• DO NOT add keyword token or chain names to the query string, unless this is explicitly in the token name or symbol!

• Focus on popular chains like ethereum, solana, base and bnb when no chain is specified and the same token is deployed on multiple chains.

• If a chain is specified, use the chain parameter to filter tokens by blockchain instead of including chain in query.

• DO NOT rely on this endpoint for LATEST prices as this is delayed. Use token_ohlcv for latest prices.

Get chain growth rankings by active addresses, transactions, gas fees and DEX volume.

Args: request: GrowthChainRankRequest containing parameters and pagination settings

Returns: Formatted markdown table with chain growth metrics

Get Hyperliquid perpetual futures trader leaderboard with performance metrics.

Returns: Trader performance rankings as markdown.

Columns returned:
- **Address**: Trader's wallet address
- **Label**: Nansen label of the trader (if available)
- **Total PnL**: Total profit/loss in USD (currency formatted, can be negative)
- **ROI**: Return on investment as percentage (percentage formatted)
- **Account Value**: Total account value in USD (currency formatted)

Sorting and Filtering Options: You can sort and filter (from/to amounts) on these fields: totalPnl, accountValue, roi

Example: { "date": {"from": "7D_AGO", "to": "NOW"}, "accountValue": {"from": 100000, "to": 1000000}, "totalPnl": {"from": 10000}, "order_by": "totalPnl", "orderByDirection": "DESC" }

Notes: - Hyperliquid-specific endpoint (perpetual futures only)

Discover and filter a daily list of attractive tokens using Nansen Score Indicators weighted by coefficients (= Performance Score).

Use this tool when you don't know which tokens to buy and need recommendations based on backtested indicators. For specific token analysis (e.g., "should I buy AAVE?"), use token_quant_scores instead.

When to use this tool vs token_discovery_screener:

• Use this tool when you want pre-scored buying recommendations without specifying criteria. It answers "what should I buy?" by returning tokens that already meet a quantitative buying threshold (Performance Score ≥15) based on alpha indicators like price momentum, chain fees, and protocol fees. Data is updated in batches.

• Use token_discovery_screener when you want live data or to explore tokens by specific criteria like sectors (e.g., "AI memecoins"), token age (e.g., "new launches"), smart money activity, or custom volume/liquidity thresholds. It's a filtering tool with real-time metrics where you define what you're looking for.

Returns tokens pre-filtered by: performance_score >= 15 (buying threshold).

Example queries: "what tokens should I buy?", "which tokens look good?", "best tokens to buy today"

Scoring:

• Performance Score (range -60 to +75): Higher = better alpha opportunity. Buy threshold: ≥15

• Risk Score (range -60 to +80): Higher = safer token. >0 indicates low to medium risk.

Every time you give the Performance Score to the user, explain the scoring thresholds above. Same for the Risk Score. Every time quote the underlying indicators that contributed the most to the Performance/ Risk score and recall their definition to the user.

Returns: A list of tokens with the highest Performance Score as markdown.

Core fields: Token Address, Token Symbol, Chain, Performance Score, Risk Score.
Indicator columns are included dynamically based on data availability (columns with all zeros are excluded).

Get recent Hyperliquid perpetual futures trades from Smart Traders and Funds across all tokens.

This tool provides granular smart trader and funds activity. For a big picture view of smart traders and funds activity across all tokens, use token_discovery_screener with onlySmartTradersAndFunds filter.

Note: This endpoint is Hyperliquid-only (perpetual futures data). It returns recent trades only (no date filtering available).

Columns returned:

• Time: Timestamp when the trade occurred (datetime: YYYY-MM-DD HH:MM:SS)

• Side: Position direction - Long or Short

• Action: Order action - Add, Reduce, Open, Close

• Token: Symbol of the perpetual contract

• Size: Quantity of the perpetual contract (numeric)

• Price USD: Price per token at time of trade (price formatted)

• Value USD: Total USD value of the trade (currency formatted)

• Trader: Nansen label of the trading address

• Tx Hash: Blockchain transaction hash for verification

Sorting Options (all fields support "asc"/"desc"): Available for sorting: timestamp, valueUsd, amount, priceUsd

Examples: # Get recent smart money perp trades (sorted by value) { "order_by": "valueUsd", "order_by_direction": "desc" }

# Filter by action and side
```
{
  "action": "Open",
  "side": "Long",
  "includeSmartMoneyLabels": ["Fund", "All Time Smart Trader"]
}
```

Get aggregated (not per wallet) smart trader and fund (EXCLUDES whales, large holders, influencers, etc.) token balances and 24h change per chain for all chains (default is ['all'], which queries all supported chains) or specific chain(s). Use filters to narrow down the results.

Get upto 25 (per page) top holders information for a specific token.

Note: Using labelType: smart_money is not a good proxy for an overall market view. Use it only if user explicitly requests it, or to combine it with other non smart money data.

Modes:

• onchain_tokens (default): Analyze on-chain tokens by contract address

• perps: Analyze Hyperliquid perpetual futures by symbol (chain auto-set to "hyperliquid")

Columns returned (onchain_tokens mode):

• Address: Wallet/contract address of the token holder

• Label: Nansen label (e.g., exchange, whale, etc.)

• Balance: Current balance held (numeric with K/M/B formatting)

• Balance USD: USD value of token holdings (currency formatted)

• Ownership %: Percentage of total token supply owned (percentage, 2 decimal places)

• Sent: Total tokens sent from this address historically (numeric)

• Received: Total tokens received by this address historically (numeric)

• 24h Change: Balance change in last 24 hours (numeric, can be negative)

• 7d Change: Balance change in last 7 days (numeric, can be negative)

• 30d Change: Balance change in last 30 days (numeric, can be negative)

Columns returned (perps mode):

• Trader Address: Address of the trader

• Trader Label: Nansen label for the trader

• Side: Position direction (Long/Short)

• Position Value USD: Total USD value of the position (currency formatted)

• Position Size: Size of the position in tokens (numeric)

• Leverage: Leverage multiplier (e.g., "20X")

• Leverage Type: Type of leverage (cross/isolated)

• Entry Price: Average entry price (price formatted)

• Mark Price: Current mark price (price formatted)

• Liquidation Price: Liquidation price (price formatted)

• Funding USD: Cumulative funding payments (currency formatted)

• Unrealized PnL USD: Unrealized profit/loss (currency formatted)

Sorting Options (default: amount desc): onchain_tokens mode: amount, valueUsd, total_outflow, total_inflow, balance_change_24h, balance_change_7d, balance_change_30d, ownership_percentage perps mode: position_size, position_value_usd, entry_price, leverage, upnl_usd, funding_usd, mark_price, liquidation_price

Examples: # On-chain tokens (default mode) { "mode": "onchain_tokens", "chain": "ethereum", "token_address": "0xa0b86a33e6b6c4b3add000b44b3a1234567890ab", "label_type": "top_100_holders" }

# Hyperliquid perpetual futures
```
{
  "mode": "perps",
  "token_address": "PENGU",
  "label_type": "smart_money"
}
```

# Find most active senders using filters
```
{
  "mode": "onchain_tokens",
  "chain": "ethereum",
  "token_address": "0xa0b86a33e6b6c4b3add000b44b3a1234567890ab",
  "label_type": "smart_money",
  "includeSmartMoneyLabels": ["All Time Smart Trader", "Fund"],
  "order_by": "total_outflow",
  "order_by_direction": "desc"
}
```

# Find biggest accumulators (who received most tokens)
```
{
  "mode": "onchain_tokens",
  "chain": "ethereum",
  "token_address": "0xa0b86a33e6b6c4b3add000b44b3a1234567890ab",
  "label_type": "whale",
  "order_by": "total_inflow",
  "order_by_direction": "desc"
}
```

# Perps mode with filters
```
{
  "mode": "perps",
  "token_address": "ETH",
  "label_type": "smart_money",
  "side": "Long",
  "upnlUsd": {"from": 10000},
  "positionValueUsd": {"from": 100000},
  "order_by": "position_value_usd",
  "order_by_direction": "desc"
}
```

**Restrictions exclusively when querying for native tokens (ETH, BNB, etc.):**
- Only supports sorting by `order_by='balance'` (others will fail)
- With `label_type='top_100_holders'`: limited filters (balance, total_outflow, total_inflow, address, smart money labels)
- For advanced filters, use different`label_type` or set `aggregate_by_entity=true`

**orderBy Restrictions (use 'balance' to avoid API errors):**
- Token address: 0xa0b86a33e6b6c4b3add000b44b3a1234567890ab

**Does not** work for the following native tokens, DO NOT call with these as you will get an error:
- tokenAddress So11111111111111111111111111111111111111112 (SOL on solana chain).

Get DEX trades for a specific token.

Modes:

• onchain_tokens (default): Analyze on-chain tokens by contract address

• perps: Analyze Hyperliquid perpetual futures by symbol (chain auto-set to "hyperliquid")

Args: request: TokenDexTradesRequest containing parameters, pagination settings, and optional sorting

Returns: DEX trading activity as markdown. Returns empty string if no trades found.

**Common Columns (all modes):**
- **Time**: Timestamp when the trade occurred (datetime: YYYY-MM-DD HH:MM:SS)
- **Token**: Symbol of the token/perpetual contract
- **Price USD**: Price per token in USD at time of trade (currency formatted)
- **Value USD**: Total USD value of the trade/position change (currency formatted)
- **Trader**: Nansen label or name of the trading address
- **Tx Hash**: Blockchain transaction hash for verification

**onchain_tokens mode:**
- **Action**: Trade direction - BUY or SELL from perspective of the token
- **Token Amount**: Quantity of the target token traded (numeric)
- **Traded Amount**: Quantity of the other token in the swap (numeric)
- **Traded Token**: Symbol of the token traded against (e.g., WETH, USDC)

**perps mode:**
- **Side**: Position direction - Long or Short
- **Action**: Order action - Add, Reduce, Open, Close
- **Size**: Quantity of the perpetual contract (numeric)

Sorting Options (all fields support "asc"/"desc"): Available for sorting: timestamp, valueUsd, amount, priceUsd

Examples: # On-chain tokens (default mode) { "mode": "onchain_tokens", "chain": "ethereum", "tokenAddress": "0xa0b86a33e6b6c4b3add000b44b3a1234567890ab", "dateRange": {"from": "24H_AGO", "to": "NOW"} }

# Hyperliquid perpetual futures
```
{
  "mode": "perps",
  "tokenAddress": "PENGU",
  "dateRange": {"from": "7D_AGO", "to": "NOW"},
  "action": "Open",
  "side": "Long"
}
```

# Find biggest trades by USD value (whale watching)
```
{
  "mode": "onchain_tokens",
  "chain": "ethereum",
  "tokenAddress": "0xa0b86a33e6b6c4b3add000b44b3a1234567890ab",
  "dateRange": {"from": "7D_AGO", "to": "NOW"},
  "order_by": "valueUsd",
  "order_by_direction": "desc"
}
```

# Find who bought the dip vs who bought the top (price analysis)
```
{
  "chain": "ethereum",
  "tokenAddress": "0xa0b86a33e6b6c4b3add000b44b3a1234567890ab",
  "dateRange": {"from": "30D_AGO", "to": "NOW"},
  "order_by": "priceUsd",
  "order_by_direction": "asc"
}
```

Get comprehensive token screening data across multiple blockchain networks with advanced filtering.

A maximum of 25 results are returned out of 1000s of tokens. Use the sorting and filtering options to narrow down the results. A maximum of 5 chains can be specified per request (excess chains are automatically trimmed).

This tool helps with token discovery and finding trending tokens by combining different metrics: volume, liquidity, market cap, smart money activity, and token age.

IMPORTANT - Hyperliquid Special Case:

• Hyperliquid chain queries perpetual futures (perps), not spot tokens

• When hyperliquid is mixed with other chains, two sections of up to 25 results each are returned - one for spot tokens and one for perps.

• For perps, only these filters are supported: volume, buyVolume, sellVolume, openInterest, netflow, nofTraders, onlySmartTradersAndFunds

• Additional orderBy fields for perps: openInterest, funding

• Unsupported filters/orderBy will fallback to defaults

INPUT EXAMPLES:

Find tokens which are going up in price.

Added some liquidity filter to remove spam and low quality tokens.

{
    "chains": ["ethereum", "solana", "bnb", "base"],
    "timeframe": "24h",
    "liquidity": {"from": 100000},
    "nofTraders": {"from": 10},
    "orderBy": "priceChange",
    "orderByDirection": "desc"
}

Find top stablecoins by market cap

{
    "chains": ["ethereum", "solana", "bnb", "base"],
    "timeframe": "7d",
    "sectors": ["Stablecoin"],
    "orderBy": "marketCapUsd",
    "orderByDirection": "desc"
}

Find AI memecoins with high trading activity

{ "chains": ["ethereum", "solana", "bnb", "base"], "timeframe": "7d", "sectors": ["AI Meme"], "liquidity": {"from": 100000}, "volume": {"from": 1000000} }

Find DeFi lending tokens

{ "chains": ["ethereum", "solana", "bnb", "base"], "timeframe": "24h", "sectors": ["DeFi Lending (Money Markets)"], "netflow": {"from": 1000000} }

Find tokens which have a lot of buying activity (high nofBuyers and buyVolume)

Note that we added some filters to remove spam and low quality tokens. We added liquidity filter so that we only surface tokens which we can buy or sell.

We sort by netflow descending to get tokens with the most net buying activity.

{
    "chains": ["ethereum", "solana", "bnb", "base"],
    "timeframe": "24h",
    "liquidity": {"from": 100000},
    "buyVolume": {"from": 1000000},
    "marketCapUsd": {"from": 1000000},
    "nofBuyers": {"from": 10},
    "orderBy": "netflow",
    "orderByDirection": "desc"
}

Find Hyperliquid perps with high open interest and positive net flow

{
    "chains": ["hyperliquid"],
    "timeframe": "7d",
    "openInterest": {"from": 100000},
    "volume": {"from": 1000000},
    "netflow": {"from": 0},
    "nofTraders": {"from": 10},
    "orderBy": "netflow",
    "orderByDirection": "desc"
}

WARNING: To avoid timeouts, it's recommended to:

• Use 4 chains or less at a time (API tends to timeout with more chains)

• Use shorter timeframes (e.g., 24h or 1h instead of 7d or 30d)

Args:

Returns: Comprehensive token metrics as markdown. Returns empty string if no tokens found.

Columns returned:
- **Token Address**: Token address (e.g., 0x1234567890123456789012345678901234567890)
- **Symbol**: Token trading symbol (e.g., ETH, BTC, DOGE)
- **Chain**: Blockchain network (ethereum, solana, polygon, etc.)
- **Price USD**: Current token price in USD (currency formatted)
- **Price Change**: Price change percentage over the date range (percentage, can be negative)
- **Market Cap**: Current market capitalization (currency formatted)
- **Fully Diluted Valuation (FDV)**: Market cap if all tokens were circulating (currency formatted)
- **FDV/MC Ratio**: Ratio indicating how much supply is locked/vested (numeric, >1 means locked supply)
- **USD Volume**: Total trading volume in USD (currency formatted)
- **Buy USD Volume**: Total buy volume in USD (currency formatted)
- **Sell USD Volume**: Total sell volume in USD (currency formatted)
- **Net Flow USD**: Net flow (buys minus sells) in USD (currency formatted, can be negative)
- **DEX Liquidity**: Available liquidity for trading (currency formatted)
- **Inflow/FDV**: Inflow as percentage of FDV (percentage formatted)
- **Outflow/FDV**: Outflow as percentage of FDV (percentage formatted)
- **Token Age (Days)**: Days since token was first deployed
- **Sectors**: List of token sectors/categories

Notes: - Positive Net Flow indicates more buying than selling - High FDV/MC Ratio suggests significant locked or vested tokens

Filtering Options (filters parameter): - Numeric Ranges: volume, liquidity, marketCapUsd, netflow, tokenAgeDays, nofTraders, nofBuyers, nofSellers, nofBuys, nofSells, buyVolume, sellVolume, fdv, fdvMcRatio, inflowFdvRatio, outflowFdvRatio - Categories: sectors (e.g. ["AI", "Meme"]), includeSmartMoneyLabels - Flags: onlySmartTradersAndFunds (boolean) - Use ONLY when user explicitly asks for "smart money". - Data with this filter is sparse. Pairing this with other filters (volume, liquidity, netflow) is likely to return no results. - Only pair onlySmartTradersAndFunds with other filters (volume, liquidity, netflow) if the user request explicitly requires it. - Instead of pairing this with other filters, you can rely on orderBy to sort by netflow, volume, liquidity, etc.

**CRITICAL WARNING:** 'priceChange' is NOT a valid filter. You cannot filter for "tokens up > 10%". Use `orderBy="priceChange"` instead.

Sorting Options (orderBy field): Available fields (use with orderByDirection: "asc" or "desc"):

- **priceUsd**: Sort by token price
- **priceChange**: Sort by price change percentage
- **marketCapUsd**: Sort by market capitalization
- **volume**: Sort by total trading volume
- **buyVolume**: Sort by buy volume
- **sellVolume**: Sort by sell volume
- **netflow**: Sort by net flow (buys - sells)
- **liquidity**: Sort by DEX liquidity
- **nofTraders**: Sort by number of traders

(Note: Fields like `tokenAgeDays` or `outflowFdvRatio` are for FILTERING only, not sorting)

Default: orderBy="netflow", orderByDirection="desc"

Get hourly aggregated token flows for a specific segment of holders over a date range. The segments are Top 100 holders, Whale, Public Figure, Smart Money and Exchange.

Note: Using holder_segment: smart_money is not a good proxy for an overall market view. Use it only if user explicitly requests it, or to combine it with other non smart money data.

This is a more granular tool than token_recent_flows_summary and provides the TOTAL flows over the entire time frame broken down by segment.

NOTE: This tool does not support native tokens (so11111111111111111111111111111111111111112, 0xeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee) in onchain_tokens mode.

Modes:

• onchain_tokens (default): Analyze on-chain tokens by contract address

• perps: Analyze Hyperliquid perpetual futures by symbol (chain auto-set to "hyperliquid")

Args: request: TokenFlowsRequest containing parameters and pagination settings

Returns: Token flow statistics as markdown.

Columns returned:
- **Hour Timestamp**: Timestamp of the hour that the flow is calculated for (datetime: YYYY-MM-DD HH:MM:SS)
- **Price USD**: Token price in USD on this date (currency formatted)
- **Total Balance**: Aggregate token balance held by tracked addresses (numeric)
- **Balance USD**: USD value of the total tracked balance (currency formatted)
- **Holders**: Number of unique addresses in the tracked group
- **Inflows/Longs**: Total tokens flowing into tracked addresses (onchain_tokens mode) or Long positions (perps mode) (numeric)
- **Outflows/Shorts**: Total tokens flowing out of tracked addresses (onchain_tokens mode) or Short positions (perps mode) (numeric)

Notes: - Tracks Smart Money holders and their collective behavior - Label parameter determines which group of holders to track - In perps mode: Shorts that are added will show with a negative sign - this indicates new short positions, not closed positions

Get OHLCV (Open, High, Low, Close, Volume) price data for a token with automatic interval resolution.

NOTE: chain=Hyperliquid is a perps chain AND IS NOT supported for token_ohlcv ENDPOINT ONLY SUPPORTS EVM CHAINS AND SOLANA.

YOU MUST USE THIS over general_search to get prices. general_search To get LATEST price set from to '5MIN_AGO' and to to 'NOW'.

Resolution is automatically calculated based on the date range

• < 6 hours: 5 minutes

• 6 hours - 1 day: 15 minutes

• 1-3 days: 30 minutes

• 3-7 days: 60 minutes (1 hour)

• 7-90 days: Daily

• 90+ days: Weekly

Columns returned:

• Interval Start: Timestamp of the start of the interval (datetime: YYYY-MM-DD HH:MM:SS)

• Open: Opening price of the interval

• High: Highest price of the interval

• Low: Lowest price of the interval

• Close: Closing price of the interval

• Volume USD: Volume in USD of the interval

Additional columns (when includeMarketCap=true):

• Open Market Cap: Opening market cap in USD

• Close Market Cap: Closing market cap in USD

• High Market Cap: Highest market cap in USD

• Low Market Cap: Lowest market cap in USD

Example Usage: Get OHLCV for WETH over the past week (auto-resolution): { "chain": "ethereum", "tokenAddress": "0xba5ddd1f9d7f570dc94a51479a000e3bce967196", "date": { "from": "7D_AGO", "to": "NOW" } }

Get OHLCV for WETH over 30 days (will use daily resolution):
```
{
    "chain": "ethereum",
    "tokenAddress": "0xba5ddd1f9d7f570dc94a51479a000e3bce967196",
    "date": {
        "from": "30D_AGO",
        "to": "NOW"
    }
}
```
Get OHLCV for WETH for last 20 minutes (will use 5 minute resolution):
```
{
    "chain": "ethereum",
    "tokenAddress": "0xba5ddd1f9d7f570dc94a51479a000e3bce967196",
    "date": {
        "from": "20MIN_AGO",
        "to": "NOW"
    }
}
```

Upto 25 results (per page) of trader PnL for a token. Use the sorting and filtering options to narrow down the results.

Modes:

• onchain_tokens (default): Analyze on-chain tokens by contract address

• perps: Analyze Hyperliquid perpetual futures by symbol (chain auto-set to "hyperliquid")

NOTE: This tool does not support native tokens (so11111111111111111111111111111111111111112, 0xeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee) in onchain_tokens mode.

Returns: Trader performance rankings as markdown. Returns empty string if no trading data found.

Columns returned:
- **Address**: Trader's wallet address
- **Label**: Nansen label of the trader
- **Total PnL**: Combined realized and unrealized PnL (currency formatted, can be negative)
- **Total ROI**: Total return on investment as percentage (percentage formatted)
- **Realized PnL**: Profit/loss from completed trades (currency formatted, can be negative)
- **Realized ROI**: Return on investment from realized trades only (percentage formatted)
- **Unrealized PnL**: Current profit/loss on open positions (currency formatted, can be negative)
- **Unrealized ROI**: Return on investment from unrealized positions only (percentage formatted)
- **Token Holdings**: Current token quantity held (numeric formatted)
- **Holdings USD**: Current USD value of token holdings (currency formatted)
- **Token Price**: Current price per token (price formatted)
- **Peak Token Holdings**: Maximum token quantity ever held in the date range (numeric formatted)
- **Peak Holdings USD**: Maximum USD value ever held in the date range (currency formatted)
- **Still Holding %**: Percentage of peak holdings still held (percentage formatted)
- **Total Trades**: Number of trades executed by this address
- **Net Flow**: Net money flow - negative means net seller (currency formatted, can be negative)

Sorting Options You can ONLY sort by pnlUsdTotal, roiPercentTotal, pnlUsdRealised, roiPercentRealised, pnlUsdUnrealised, roiPercentUnrealised, valueUsd, nofTrades, stillHoldingBalanceRatio, netflowAmountUsd

Filtering Options: 📋 List filters: traderAddress, fullName 📊 Numeric range filters: All sorting fields PLUS holdingAmount, nofBuys, nofSells, boughtAmount, soldAmount, boughtUsd, soldUsd, maxBalanceHeld, maxBalanceHeldUsd

Examples: # On-chain tokens (default mode) { "mode": "onchain_tokens", "chain": "ethereum", "tokenAddress": "0xa0b86a33e6ba3e5b9e4b1b1b1b1b1b1b1b1b1b1b", "dateRange": {"from": "30D_AGO", "to": "NOW"}, "order_by": "pnlUsdTotal", "order_by_direction": "desc" }

# Hyperliquid perpetual futures
```
{
  "mode": "perps",
  "tokenAddress": "ETH",
  "dateRange": {"from": "7D_AGO", "to": "NOW"}
}
```

# Advanced filtering: Find profitable active traders with significant holdings
```
{
  "chain": "ethereum",
  "tokenAddress": "0xa0b86a33e6ba3e5b9e4b1b1b1b1b1b1b1b1b1b1b",
  "dateRange": {"from": "30D_AGO", "to": "NOW"},
  "pnlUsdTotal": {"from": 1000, "to": 999999999},
  "nofTrades": {"from": 5, "to": 100},
  "holdingUsd": {"from": 10000, "to": 999999999},
  "stillHoldingBalanceRatio": {"from": 0.1, "to": 1.0},
  "order_by": "roiPercentTotal",
  "order_by_direction": "desc"
}
```

Notes: - Ranked by total PnL performance by default - Useful for identifying successful traders and copying strategies - Both ascending and descending sorts provide valuable insights (winners vs losers) - ONLY RETURNS TOP 25 RESULTS for the sort order. Hence the result is NEVER complete. - Make sure the sort order is relevant to your analysis as otherwise you will miss data.

** This tool does not support hyperevm as chain **

Get Nansen Score Indicators for a token - quantitative risk and reward signals.

Use this tool when assessing a token's risk/reward profile, evaluating buy/sell decisions, or when the user needs quantitative data to make trading decisions.

Returns: Token risk/reward indicators as markdown with interpretation guidance.

Token info:
- **Market Cap**: Current market cap in USD
- **Market Cap Group**: largecap (>$1B), midcap ($100M-$1B), or lowcap (<$100M)
- **Is Stablecoin**: Whether token is a stablecoin (some indicators don't apply to stablecoins)

Fields returned per indicator:
- **Score**: Signal classification (bullish/neutral/bearish for reward; low/medium/high for risk)
- **Signal**: Raw numeric value of the indicator
- **Percentile**: Rank vs same market cap group (0-100%)
- **Last Trigger**: Date when signal was last calculated

Indicator types:
- **Reward Indicators**: price-momentum, funding-rate, chain-fees, chain-tvl, protocol-fees, trading-range
- **Risk Indicators**: btc-reflexivity, liquidity-risk, token-supply-inflation, concentration-risk, cex-flows

Notes: - Not all indicators available for every token/chain combination - Percentile compares against same market cap group (largecap >$1B, midcap $100M-$1B, lowcap <$100M)

Get TOTAL token flows per segment: 1. Public Figures 2. Top PnL Traders 3. Whales 4. Smart Traders 5. Exchanges 6. Fresh Wallets

Inflow and outflow of tokens between the segments is CRITICAL in identifying token price trends.

The values provided are aggregated over the specific lookback period (last 5min, 1d, 7d etc) specified. If you have SPECIFIC date ranges in mind, use token_flows instead.

NOTE Use token_flows for more granular data as it can filter between exact dates and provides HOURLY breakdowns.

Returns: Categorized token flow analysis as markdown.

For each segment, returns:
- Flow amount in USD
- Ratio compared to average flow
- Number of wallets

Format: "{Segment} wallet flow of {amount} ({ratio}x average, from {count} wallets)"

Notes: - Positive flow = net buying, negative flow = net selling - For Exchange Flow, positive means more inflow to exchanges, negative means more outflow from exchanges - Categorizes market participants by their historical behavior and characteristics

NOTE: Bitcoin is not supported. DO NOT use this tool for bitcoin. NOTE: Hyperliquid is a perps chain and is NOT supported for token_recent_flows_summary

Get 25 token transfers (per page) for a specific token based on the sort order. Default is most recent transfers first.

NOTE: This tool does not support native tokens (so11111111111111111111111111111111111111112, 0xeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee).

Columns returned:

• Time: Timestamp when the transfer occurred (block_timestamp: ISO 8601 format)

• From Label: Source address label (from_address_label: sender of tokens)

• To Label: Destination address label (to_address_label: receiver of tokens)

• From Address: Raw source address (from_address: hex address)

• To Address: Raw destination address (to_address: hex address)

• Amount: Quantity of tokens transferred (transfer_amount: numeric)

• Value USD: USD value of the transfer at time of transaction (transfer_value_usd: currency formatted)

• Type: Transfer category (transaction_type: DEX, CEX, transfer, etc.)

• Tx Hash: Blockchain transaction hash for verification (transaction_hash)

Sorting Options (all fields support "asc"/"desc"): Available for sorting: timestamp, amount, valueUsd

Examples: # Basic request (most recent transfers first) { "chain": "ethereum", "tokenAddress": "0xa0b86a33e6b6c4b3add000b44b3a1234567890ab", "dateRange": {"from": "24H_AGO", "to": "NOW"}, "order_by": "timestamp", "order_by_direction": "desc" }

# Smart money only filter (largest transfers first)
```
{
  "chain": "ethereum",
  "tokenAddress": "0xa0b86a33e6b6c4b3add000b44b3a1234567890ab",
  "dateRange": {"from": "7D_AGO", "to": "NOW"},
  "transferOriginCategories": ["all_transfers"],
  "onlySmartTradersAndFunds": true,
  "order_by": "valueUsd",
  "order_by_direction": "desc"
}
```

# Filter by DEX only with minimum transfer value (USD)
```
{
  "chain": "ethereum",
  "tokenAddress": "0xa0b86a33e6b6c4b3add000b44b3a1234567890ab",
  "dateRange": {"from": "24H_AGO", "to": "NOW"},
  "transferOriginCategories": ["dex"],
  "transferValueUsd": {"from": 1000}
}
```

Available Filters:

Transfer Origin Categories:

• transferOriginCategories (list[str]): List of transfer types to include Possible values: ['dex', 'cex', 'non_exchange_transfers', 'all_transfers'] Default: ['all_transfers'] Examples:

  • ['dex'] - only DEX transfers

  • ['cex'] - only CEX transfers

  • ['dex', 'cex'] - both DEX and CEX

  • ['non_exchange_transfers'] - only non-exchange transfers

  • ['all_transfers'] - all types (default)

Smart Money Filter:

• onlySmartTradersAndFunds (bool): Only show smart money transfers (default: false) When true, filters to show only transfers involving profitable addresses

Numeric Range Filter:

• transferValueUsd (object, optional): Filter by USD value of transfer Format: {"from": X, "to": Y} or {"from": X} or {"to": Y}

  • Specify only from for minimum bound (no maximum)

  • Specify only to for maximum bound (no minimum)

  • Specify both for a bounded range Example: {"from": 1000} - only transfers worth at least $1,000 USD Example: {"to": 50000} - only transfers up to $50,000 USD Example: {"from": 1000, "to": 50000} - transfers between $1,000 and $50,000 USD Note: This filters by the USD value of the transfer at time of transaction

Notes: - Use transferOriginCategories to control which transfer origins are included - Smart Money filter shows only transfers involving profitable addresses (definition of Smart Money) - transferValueUsd filters by USD value at time of transaction

Get TOTAL amount of tokens bought/sold by address for a token on DEX (Decentralised Exchanges) ONLY.

Use this tool to find out WHO is buying or selling a token (on DEX) AND then you can check if they are liquidating profits or accumulating more.

Returns: Aggregated buyer/seller activity as markdown. Returns empty string if no trading data found.

Columns returned:
- **Address**: Trader's wallet address
- **Label**: Nansen label of the address
- **Bought Token Volume**: Total quantity of tokens purchased
- **Sold Token Volume**: Total quantity of tokens sold
- **Gross Token Volume**: Combined buy and sell volume in tokens
- **Bought Volume USD**: USD value of all token purchases
- **Sold Volume USD**: USD value of all token sales
- **Gross Volume USD**: Combined USD trading volume

Sorting Options: You can sort asc or desc by bought_volume_usd or sold_volume_usd

Notes: - buy_or_sell parameter filters for "BUY" (net buyers) or "SELL" (net sellers) - Aggregates all trading activity within the specified time range

Get comprehensive transaction details including token transfers.

Args: request: TransactionLookupRequest containing parameters and pagination settings

Returns: Formatted markdown table with transaction details and token transfers

Get PnL stats for a specific token traded by the input address during a specific date range. Use this tool for analysing the performance of the wallet for the specific token over a time period.

Get aggregate stats of overall realized PnL for the input address. Note, this tool DOES NOT include unrealized PnL. For unrealized PnL you need to check change in token prices of the current holdings. Use this tool for analysing the performance of the wallet over a time period. You can analyse the wallet portfolio performance over a specific time period.