{"uid":"cap_DmNtoDbKtmjtOcqvSeEOz","slug":"agent-data-bench-per-wallet-trader-leaderboard-76ff9c6c","name":"Agent Data Bench – Per-Wallet Trader Leaderboard","description":"Per-wallet results for a pool or token: bought/sold volume and counts, realized PnL, remaining balance, hold duration and bot/KOL labels. Sort by PnL, filter to up to 30 wallets, and page the leaderboard. Use it to find smart money in a token, benchmark a wallet or size a copy-trade set.","url":"https://x402.deepsense.stream/api/v1/market/traders?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"queryParams":{"type":"object","required":["chain"],"properties":{"pool":{"type":"string","description":"Pool / pair address"},"chain":{"enum":["sol","eth","base"],"type":"string","description":"Chain id: sol (Solana), eth (Ethereum), base (Base)"},"limit":{"type":"integer","default":25,"maximum":100,"minimum":1},"since":{"type":"integer","description":"Unix seconds; only traders active after this"},"token":{"type":"string","description":"Token address (pool or token is required)"},"offset":{"type":"integer","default":0,"maximum":10000,"minimum":0},"wallets":{"type":"string","description":"Comma-separated addresses (max 30)"},"direction":{"enum":["asc","desc"],"type":"string","default":"desc"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.005","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","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.005/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_8rBZAOex9RmDv91NcDBit","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.005","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns per-wallet trading stats (volume, PnL, bot/KOL labels, hold duration) for a DEX pool or token, sortable and pageable for smart-money discovery and copy-trade sizing.","exampleAgentPrompt":"Show me the top 10 wallets by realized PnL trading the Solana token EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v, sorted descending, so I can find smart money to copy-trade.","exampleUseCases":[{"title":"Smart money discovery for new token","prompt":"Pull the top 25 wallets by realized PnL for this Base token 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913, sorted descending — I want to find the best traders to follow."},{"title":"Benchmarking a specific wallet in a pool","prompt":"Look up wallet 7xKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuJosgAsU in the Solana pool FpCMFDFGYotvufJ7HAsj3qQKDj8RVgK7HE4Fqz4Cg9jb and tell me its buy/sell volume, realized PnL, hold duration, and whether it's flagged as a bot."},{"title":"Filtering KOL wallets for copy-trade sizing","prompt":"Give me up to 30 wallets trading the Ethereum token 0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48 that have been active since January 1 2025, sorted by PnL descending — I'm sizing a copy-trade set and want to see who's actually profitable."}],"resultDescription":"A paginated list of wallet-level trading records for the queried pool or token, each containing bought and sold volume (USD and token units), number of buy/sell transactions, realized PnL, current remaining balance, average hold duration, and classification labels (bot or KOL). Results are sorted by the chosen direction (default: descending PnL) and support offset-based pagination.","failureModes":["Missing required 'chain' parameter returns a validation error","Neither 'pool' nor 'token' provided causes a 400-level error","Invalid chain enum value (not sol/eth/base) rejected","Wallet list exceeding 30 addresses may be truncated or rejected","Pool/token address not indexed on the specified chain returns empty results","Offset beyond 10000 rejected by schema","Payment failure (402) if x402 micropayment not completed"],"whenToPreferThis":"Use this endpoint when you need wallet-level trading analytics for a specific token or pool — PnL rankings, volume stats, bot/KOL classification, and hold duration — rather than aggregate pool metrics or raw trade prints. It is the right choice for smart-money discovery, copy-trade list building, or benchmarking individual wallets against the rest of the trader cohort. Prefer it over the top-holders endpoint when you care about trading behavior and profitability rather than current balance distribution.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-28T06:41:12.454Z","isFirstParty":false,"canonicalSlug":"agent-data-bench-per-wallet-trader-leaderboard-76ff9c6c"}