{"uid":"cap_p-OLpGS1dfG55gKfSFC2p","slug":"near-token-holders-2da0d433","name":"NEAR Token Holders","description":"Top holders of a NEP-141 token on NEAR with each one's share of total supply, labelled as the token itself, an issuer treasury, a contract (pool, bridge, custodian) or a plain account, so neither a pool nor unissued stock is mistaken for a whale. Holder count, shares, and LOW / MEDIUM / HIGH concentration of plain accounts over circulating supply. Supply from the NEAR RPC, holders from NearBlocks.","url":"https://402.com.tr/api/x402/near-token-holders?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"},"pathParams":{"type":"object"},"queryParams":{"type":"object","required":["token"],"properties":{"top":{"type":"string","description":"Holders to list (optional, 1-25)"},"token":{"type":"string","description":"NEAR token contract account"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"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_2LtHW3E-vv7goJ71c5CNK","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 top holders of a NEP-141 token on NEAR with labelled account types, concentration metrics, and share of circulating supply","exampleAgentPrompt":"Show me the top 20 holders of the NEAR token contract token.v2.ref-finance.near, labelled by account type, and tell me how concentrated ownership is among regular wallets.","exampleUseCases":[{"title":"Token concentration risk check","prompt":"Pull the top 25 holders of meta-token.near and tell me whether plain account ownership is LOW, MEDIUM, or HIGH concentration — I want to know if this token is dominated by a few whales before I invest."},{"title":"Identify treasury and bridge wallets","prompt":"For the NEAR token contract aurora.token.near, list the top 10 holders and flag which ones are issuer treasuries, bridges, or custodian contracts so I can see the real circulating distribution."},{"title":"DeFi pool vs whale distinction","prompt":"I'm researching ft.shitzu.near — can you get its top holders and separate out the liquidity pool contracts from actual whale accounts so I know who the real large holders are?"}],"resultDescription":"Returns an ordered list of top holders (up to 25), each with wallet address, account type label (token, issuer treasury, contract such as pool/bridge/custodian, or plain account), percentage share of total supply, and the holder's raw balance. Also includes total holder count, overall token supply sourced from NEAR RPC, and a concentration rating (LOW/MEDIUM/HIGH) for plain accounts relative to circulating supply.","failureModes":["Invalid or non-existent token contract account returns an error or empty holder list","Token with no NEP-141 compliance may fail to return supply data","top parameter outside 1-25 range may be rejected or clamped","NearBlocks data lag may cause slightly stale holder rankings","Network or RPC timeout could result in partial data"],"whenToPreferThis":"Choose this endpoint when you need labelled, context-aware holder analysis for a NEAR NEP-141 token — specifically when you want to distinguish genuine whale accounts from liquidity pools, bridges, or treasury contracts. It is superior to raw blockchain queries because it normalises circulating supply and applies concentration scoring. Prefer it over generic block explorer lookups when you need structured JSON output ready for agent consumption.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-19T12:36:17.531Z","isFirstParty":false,"canonicalSlug":"near-token-holders-2da0d433"}