{"uid":"cap_FLe20Ie5pva6H41E-xaSX","slug":"token-top-holders-bsc-4417ef2a","name":"token-top-holders-bsc","description":"BNB Smart Chain: Top 50 holders of a token with share of supply, balances, contract/exchange labels, burned share and concentration (top 1/5/10/20). Spot whale-controlled and insider-heavy tokens. $0.03 per call.","url":"https://chain.intel.rallylive.ca/token/holders/bsc?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"},"queryParams":{"type":"object","properties":{}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.03","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.03/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.03","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.03","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_cDr6ViJ5RmAvZE0EZLG9O","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.03","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns the top 50 holders of a BNB Smart Chain ERC-20 token with balances, supply share, concentration metrics, contract/exchange labels, and burned token share.","exampleAgentPrompt":"Who are the top 50 holders of this BSC token at contract 0x2170Ed0880ac9A755fd29B2688956BD959F933F8 — I want to see their balances, what share of supply they hold, whether any are exchanges or contracts, how much has been burned, and the concentration breakdown for top 1, 5, 10, and 20 holders.","exampleUseCases":[{"title":"Whale risk check before investing","prompt":"Before I buy this BSC token at 0x0E09FaBB73Bd3Ade0a17ECC321fD13a19e81cE82, can you check who the top 50 holders are and whether a few whales control most of the supply? I want to know the concentration for the top 1, 5, 10, and 20 holders."},{"title":"Insider holding detection for new launch","prompt":"This new token just launched on BSC — contract 0xBf5140A22578168FD562DCcF235E5D43A02ce9B1. Can you check whether the top holders look like insider wallets or team addresses, and how much of the supply they collectively control?"},{"title":"Burned supply and exchange distribution audit","prompt":"For BSC token 0x1AF3F329e8BE154074D8769D1FFa4eE058B1DBc3, can you pull the top 50 holders and tell me what percentage of supply has been burned, and which holders are labeled as exchanges or contracts?"}],"resultDescription":"Returns a ranked list of the top 50 holders of the specified BSC token, including each holder's address, token balance, percentage share of total supply, and labels indicating whether the address is a contract, exchange, or known entity. Also includes aggregate concentration metrics (share held by top 1, 5, 10, and 20 holders), the percentage of supply held in burn addresses, and an overall supply distribution picture useful for spotting whale-dominated or insider-heavy tokens.","failureModes":["Invalid or non-existent contract address returns an error or empty result","Non-BSC contract addresses (e.g. Ethereum or Polygon) will not return valid data","Token with no on-chain holder data may return empty list","Rate limiting or payment failure (x402) if USDC payment is not processed","Newly launched tokens with very few holders may return incomplete concentration data"],"whenToPreferThis":"Choose this endpoint when you need on-chain holder distribution analysis specifically for a BNB Smart Chain token — particularly when evaluating whale concentration, insider risk, burned supply, or whether major holders are exchanges or contracts. Prefer this over generic token price or liquidity endpoints when your goal is supply concentration analysis or token safety due diligence on BSC. Use the Ethereum or Polygon equivalents for those chains.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-02T12:41:00.317Z","isFirstParty":false,"canonicalSlug":"token-top-holders-bsc-4417ef2a"}