{"uid":"cap_Ln__v1HJWt18OauWjP1Io","slug":"nansen-dex-trades-token-pnl-leaderboard-01e5e481","name":"Nansen DEX Trades - Token PnL Leaderboard","description":"Get Wallet DEX Trades","url":"https://api.nansen.ai/api/v1/profiler/dex-trades","method":"GET","headers":{},"bodySchema":{"type":"object","properties":{"date":{"type":"object"},"chain":{"type":"string"},"address":{"type":"string"},"filters":{"type":"object"},"order_by":{"type":"array"},"pagination":{"type":"object"}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","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.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_1fVGp1BdUULUobN7Kdn0C","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns a PnL leaderboard of traders for a specific token on a given blockchain, ranked by profitability over a date range.","exampleAgentPrompt":"Show me the top PnL leaderboard for the PEPE token on Ethereum between January 1 and January 31 2025, filtering for traders with at least 10 trades — I want to see which wallets made the most money.","exampleUseCases":null,"resultDescription":"A ranked list of wallet addresses showing their profit and loss (PnL) metrics for trading a specific token over the requested date range, including number of trades, holding value in USD, realized and unrealized gains, and Nansen smart money labels where applicable.","failureModes":["Invalid or unsupported chain returns 400 or empty result","Token address not found on the specified chain returns empty leaderboard","Date range too wide or no data available for the period","Missing required fields (chain, token_address, date) returns 422 validation error","API key invalid or quota exceeded returns 401/429"],"whenToPreferThis":"Use this endpoint when you need to identify the most profitable traders of a specific token over a defined time window on a supported blockchain. Ideal for smart money analysis, alpha discovery, and understanding which wallets are winning on a particular token. Prefer this over generic DEX trade endpoints when a ranked PnL view is needed rather than raw trade-by-trade data.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T00:50:46.628Z","isFirstParty":false}