{"uid":"cap_sHbcbRizg0qSR_oX3J888","slug":"vybe-solana-analytics-api-top-traders-9e62bc76","name":"Vybe Solana Analytics API – Top Traders","description":"Solana API endpoint for fetching top traders on Solana ranked by PnL, win rate and volume. Power copy trading leaderboards and smart money discovery tools.","url":"https://x402-api.vybenetwork.xyz/v4/wallets/top-traders?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","properties":{"page":{"type":"integer","format":"int32","minimum":0,"nullable":true,"description":"The requested page."},"label":{"allOf":[{"enum":["All","Kol"],"type":"string","description":"Represents the label type for trader categorization."}],"nullable":true,"description":"Represents the label type for trader categorization. Default is 'all'."},"limit":{"type":"integer","format":"int32","minimum":0,"nullable":true,"description":"The limit of entries to return. If not passed, a maximum of 1000 entries are returned."},"sortByAsc":{"type":"string","nullable":true,"description":"Sort ascending by 'realizedPnlUsd', 'unrealizedPnlUsd', 'winRate', 'tradesVolumeUsd', 'tradesCount', 'accountAddress'. Only one of sort_by_asc or sort_by_desc can be used."},"resolution":{"allOf":[{"enum":["1d","7d","30d"],"type":"string","description":"Represents the supported time-window resolutions for account/PnL queries."}],"nullable":true,"description":"Resolution of the data. Possible values: 1d, 7d, 30d. Default is \"1d\"."},"sortByDesc":{"type":"string","nullable":true,"description":"Sort descending by 'realizedPnlUsd', 'unrealizedPnlUsd', 'winRate', 'tradesVolumeUsd', 'tradesCount', 'accountAddress'. Only one of sort_by_asc or sort_by_desc can be used."},"ilikeFilter":{"type":"string","nullable":true,"description":"Optional ILIKE filter applied to both trader names and address fields for any match."},"mintAddress":{"allOf":[{"type":"string","format":"pubkey"}],"nullable":true,"description":"The token mint address filter for tokens. Provides the token address to filter the requested data by."}}},"responseSchema":{"type":"object","required":["data"],"properties":{"data":{"type":"array","items":{"type":"object","required":["accountAddress","accountLabels","metrics"],"properties":{"metrics":{"type":"object","required":["realizedPnlUsd","unrealizedPnlUsd","winRate","tradesVolumeUsd","tradesCount","sevenDayPnl"],"properties":{"winRate":{"type":"number","format":"double","description":"The percentage of winning trades (0.0 to 100.0)."},"sevenDayPnl":{"type":"array","items":{"type":"array","items":{"type":"number","format":"double"}},"description":"The profit and loss trend over the last seven days."},"tradesCount":{"type":"integer","format":"int64","minimum":0,"description":"The total number of trades executed."},"realizedPnlUsd":{"type":"number","format":"double","description":"The total realized profit in USD."},"tradesVolumeUsd":{"type":"number","format":"double","description":"The total trading volume in USD."},"unrealizedPnlUsd":{"type":"number","format":"double","description":"The total unrealized profit in USD."},"uniqueTokensTraded":{"type":"integer","format":"int64","minimum":0,"nullable":true,"description":"The count of unique tokens traded by the account."},"bestPerformingToken":{"allOf":[{"type":"object","required":["mintAddress","pnlUsd"],"properties":{"pnlUsd":{"type":"number","format":"double","description":"The profit or loss for the token in USD."},"tokenName":{"type":"string","nullable":true,"description":"The name of token (if any)."},"mintAddress":{"type":"string","description":"The address of mint."},"tokenSymbol":{"type":"string","nullable":true,"description":"The symbol of token."},"tokenLogoUrl":{"type":"string","nullable":true,"description":"The logo URL of token (if any)."}},"description":"Summary of a token's performance."}],"nullable":true},"worstPerformingToken":{"allOf":[{"type":"object","required":["mintAddress","pnlUsd"],"properties":{"pnlUsd":{"type":"number","format":"double","description":"The profit or loss for the token in USD."},"tokenName":{"type":"string","nullable":true,"description":"The name of token (if any)."},"mintAddress":{"type":"string","description":"The address of mint."},"tokenSymbol":{"type":"string","nullable":true,"description":"The symbol of token."},"tokenLogoUrl":{"type":"string","nullable":true,"description":"The logo URL of token (if any)."}},"description":"Summary of a token's performance."}],"nullable":true}},"description":"Trading metrics and performance statistics for an account."},"accountName":{"type":"string","nullable":true,"description":"The display name of the account (optional)."},"accountLabels":{"type":"array","items":{"type":"string"},"description":"Custom account labels assigned internally by the Vybe system."},"accountAddress":{"type":"string","description":"The public key (pubKey) associated with the Solana account."},"accountLogoUrl":{"type":"string","nullable":true,"description":"The URL to the account's logo image (optional)."},"accountTwitterUrl":{"type":"string","nullable":true,"description":"The URL to the account's Twitter profile (optional)."}},"description":"The top trader wallet identity and performance metrics."}}},"description":"A collection of items"},"example":null,"exampleRequest":null,"tags":["x402","finance"],"displayCostAmount":"0.015","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.015/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.018","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.018","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_kwuTJLXsjEHjwFdFfqXHj","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.018","costPer":"request","priority":0,"asset":"EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns a ranked leaderboard of top Solana wallet traders with PnL, win rate, and volume metrics, filterable by token, label, and time resolution","exampleAgentPrompt":"Show me the top 50 Solana traders over the last 7 days sorted by realized PnL descending, and filter results to only show wallets trading the token at mint address So11111111111111111111111111111111111111112.","exampleUseCases":null,"resultDescription":"An array of trader records, each containing the wallet's public key, display name, labels, logo and Twitter URLs, and a metrics object with realized PnL, unrealized PnL, win rate, trade volume, and trade count — all denominated in USD and ranked per the requested sort field and time resolution.","failureModes":["Payment not provided or insufficient USDC balance — 402 Payment Required","Invalid mint address format — 400 Bad Request","Both sortByAsc and sortByDesc specified simultaneously — 400 Bad Request","Invalid resolution value outside 1d/7d/30d — 400 Bad Request","Page or limit out of range — 400 or empty data array","Network timeout or upstream Solana RPC lag — 503 or delayed response"],"whenToPreferThis":"Use this endpoint when you need a ranked leaderboard of Solana traders with rich performance metrics (PnL, win rate, volume) across configurable time windows. Prefer it over generic wallet lookup endpoints when the goal is comparative ranking, alpha research, or identifying whale wallets associated with a specific token. It is the right choice when you need paginated, sortable, filterable trader performance data rather than a single wallet's history.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-02T12:39:23.911Z","isFirstParty":false,"canonicalSlug":"vybe-solana-analytics-api-top-traders-9e62bc76"}