{"uid":"cap_mGbvCLlUhsRdZDxZh77HX","slug":"mangrove-token-holders-by-symbol-08971a2d","name":"Mangrove Token Holders by Symbol","description":"Developer references for Mangrove Agent, API contracts, MCP and AI integrations.","url":"https://api.mangrovedeveloper.ai/api/v1/on-chain/token-holders/%7Bsymbol%7D?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","properties":{"properties":{"type":"string"}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.02","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.02/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_9hzn4_VOq4qRYY6475WS7","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.02","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns the list of token holders for a given on-chain token identified by its ticker symbol.","exampleAgentPrompt":"Can you pull up the list of on-chain token holders for UNI — I want to see who the major wallet holders are for that token?","exampleUseCases":[{"title":"Whale concentration analysis for DeFi token","prompt":"Show me the top token holders for AAVE so I can see how concentrated ownership is among whale wallets."},{"title":"Due diligence on a new token listing","prompt":"Before I invest, can you check who the major holders of PEPE are on-chain? I want to know if it's too concentrated at the top."},{"title":"Monitoring holder distribution for portfolio token","prompt":"Pull up the current holder list for LINK — I want to track how the ownership distribution has changed and whether any large wallets have been accumulating."}],"resultDescription":"A structured list of on-chain token holders for the specified symbol, typically including wallet addresses, the amount of tokens held by each address, and potentially ranking or percentage share of total supply. Useful for assessing token concentration, identifying whale wallets, and performing holder distribution analysis.","failureModes":["Unknown or unsupported token symbol returns an error or empty result","Symbol ambiguity (e.g. multiple tokens with the same ticker) may return incorrect holders","Rate limiting or payment failure via x402 results in a 402 Payment Required response","Newly listed or low-liquidity tokens may have incomplete holder data","Network unavailability returns a 5xx server error"],"whenToPreferThis":"Use this endpoint when you need on-chain token holder data keyed by a token's ticker symbol. It is ideal for quick holder lookups without needing a contract address, making it accessible for non-technical queries. Prefer this over raw blockchain node queries when you want pre-processed, structured holder data with minimal setup. Best suited for DeFi research, whale tracking, and token distribution analysis.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-11-04T06:32:14.442Z","isFirstParty":false,"canonicalSlug":"mangrove-token-holders-by-symbol-08971a2d"}