{"uid":"cap_qdu5C29qFUwAG594mZ04D","slug":"nansen-smart-money-pnl-leaderboard-689a9e24","name":"Nansen Smart Money PnL Leaderboard","description":"Get Smart Money PnL Leaderboard","url":"https://api.nansen.ai/api/v1/smart-money/pnl-leaderboard","method":"GET","headers":{},"bodySchema":{"type":"object","properties":{"chains":{"type":"array"},"filters":{"type":"object"},"order_by":{"type":"array"},"timeframe":{"type":"integer"},"pagination":{"type":"object"}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.05","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.05/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.05","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.05","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_Y6A4vlKzGkH-3nYy761gC","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.05","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns a ranked leaderboard of smart money wallet addresses sorted by profit and loss (PnL) over a specified timeframe across one or more blockchain networks.","exampleAgentPrompt":"Pull up Nansen's smart money PnL leaderboard for all chains over the last 30 days, sorted by total PnL in USD descending, and show me the top 20 wallets.","exampleUseCases":[{"title":"Weekly top crypto trader rankings","prompt":"Who are the most profitable on-chain traders this week? Pull the Nansen smart money leaderboard for all chains over the last 7 days and show me the top 10 wallets with their total PnL."},{"title":"Ethereum and Solana PnL comparison","prompt":"I want to see which smart money wallets have made the most profit trading on Ethereum and Solana over the past 30 days — give me a ranked leaderboard sorted by total USD PnL descending."},{"title":"Identify top DeFi wallets monthly","prompt":"Find the best performing DeFi wallets by PnL this month across all chains. Show me the top 25 smart money addresses from Nansen ranked by how much they've made."}],"resultDescription":"A ranked list of wallet addresses labeled as 'smart money' by Nansen, each with their total PnL in USD and associated metadata, ordered by profit performance over the requested timeframe and filtered to the specified chains.","failureModes":["Invalid timeframe value returns a 400 error — only allowed integer day values are accepted","Unsupported chain identifier causes a 422 validation error","Missing or invalid API key returns 401 Unauthorized","Payment not fulfilled triggers 402 Payment Required","Pagination parameters out of range may return empty results","Rate limiting may cause 429 Too Many Requests"],"whenToPreferThis":"Use this endpoint when you need a ranked view of which smart money wallets have the highest profit and loss over a specific time window, across one or more chains. Prefer this over individual token PnL or DEX trade endpoints when the goal is portfolio-level performance ranking of notable on-chain traders rather than token-specific analysis.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-13T12:40:19.994Z","isFirstParty":false}