{"uid":"cap_2pMNLlqbNZRngUEtHCauM","slug":"onvexia-asset-holders-endpoint-cc7714d0","name":"Onvexia Asset Holders Endpoint","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/assets/%7Bsymbol%7D/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/assets/{symbol}/holders"}}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.001","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.001/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_Hdl9HMggRcjZ-zCEZRa3I","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.001","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns the holder distribution and address-level holder data for a specified blockchain asset symbol","exampleAgentPrompt":"Pull up the current holder distribution for ETH — I want to see which addresses are holding the most and whether any labelled wallets like exchanges or funds show up.","exampleUseCases":[{"title":"Whale concentration check for a token","prompt":"Show me the top holders of SOL and flag any labelled addresses like exchanges or custodians — I want to know if the supply is heavily concentrated."},{"title":"DeFi token due diligence","prompt":"Can you get the holder list for UNI and tell me how distributed the supply is? I'm trying to figure out if there are any obvious whale risks before I invest."},{"title":"On-chain research for a portfolio asset","prompt":"Look up who's holding LINK right now — give me the top wallet addresses with their share of supply, especially any that Onvexia has labelled as known entities."}],"resultDescription":"A JSON response containing an array of holder records for the requested asset symbol, including wallet addresses (some labelled as known entities like exchanges, funds, or custodians), their balances, percentage of total supply, and associated metadata. The meta field includes a link to the full OpenAPI spec.","failureModes":["Unknown or unsupported symbol returns empty data array","Symbol for a chain not among the ten supported chains returns no results","Malformed symbol path parameter may return 400 or empty response","Payment failure (x402) if USDC balance is insufficient","Rate limiting if called excessively without payment","Response may lag for assets with very large holder sets"],"whenToPreferThis":"Choose this endpoint when you need on-chain holder distribution data for a specific asset and want labelled address context (e.g. exchange wallets, known funds) rather than raw address lists. Onvexia covers thousands of assets across ten chains with historical data back to 2008, making it preferable to generic block explorers when you need fused, annotated holder intelligence in a single REST call.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-19T12:57:29.094Z","isFirstParty":false}