{"uid":"cap_tTOmP3WAVv0Yfz-IEV59g","slug":"onvexia-top-holders-whale-tracker-150bb9bb","name":"Onvexia Top Holders (Whale Tracker)","description":"Thousands of assets across ten chains, half a million analysed documents, labelled addresses and supply-age history reaching back to 2008 — fused into one reading per asset. REST, SQL, GraphQL and MCP.","url":"https://onvexia.com/v1/whales/top-holders","method":"GET","headers":{},"bodySchema":{"type":"object","properties":{"properties":{"type":"string"}}},"responseSchema":{"type":"json","example":{"data":[],"meta":{"docs":"https://onvexia.com/openapi.json","endpoint":"/v1/whales/top-holders"}}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.002","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.002/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_K8TNYYXwepgtTtkcT5yt3","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.002","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns the top token holders (whales) for a given blockchain asset, drawn from Onvexia's multi-chain labelled address database.","exampleAgentPrompt":"Who are the top holders of Chainlink on Ethereum right now? Pull the whale list from Onvexia so I can see which addresses hold the largest concentrations.","exampleUseCases":[{"title":"DeFi token concentration risk check","prompt":"Before I invest, can you pull the top holders for AAVE on Ethereum from Onvexia? I want to see if a handful of whales control most of the supply."},{"title":"Whale wallet monitoring for trading signals","prompt":"Get me the top 20 holder addresses for Uniswap's UNI token — I want to track whether whales are accumulating or distributing."},{"title":"Research report on token distribution","prompt":"I'm writing a report on Solana's token distribution. Pull the top holders list from Onvexia so I can quantify how concentrated the supply is."}],"resultDescription":"A JSON object with a `data` array containing ranked wallet addresses and their holdings for the requested asset, plus a `meta` object with documentation links and the endpoint path. Addresses may include Onvexia's proprietary labels (e.g. exchange names, known funds) derived from their labelled address database.","failureModes":["Unknown or unsupported asset/chain returns an empty data array","Malformed properties parameter returns a schema validation error","Payment not received (x402) causes a 402 Payment Required response","Rate limiting or quota exceeded returns a 429 error","Internal data pipeline delay may return stale or partial holder data"],"whenToPreferThis":"Choose this endpoint when you need a ranked, labelled list of the largest token holders for a specific on-chain asset, especially when address labelling (e.g. identifying known exchanges or funds) and cross-chain coverage matter. Prefer this over generic blockchain explorers when you need structured, enriched whale data via a simple REST call with per-query micropayment pricing.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-19T13:07:49.996Z","isFirstParty":false}