{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Etherscan","description":"The complete onchain data API for the crypto ecosystem, across 60+ chains.","colors":{"primary":"#0784C3","light":"#0784C3","dark":"#0784C3"},"logo":{"light":"https://mintcdn.com/etherscan/O446YQrF1qMjlNwS/logo/etherscan-logo-dark.svg?fit=max\u0026auto=format\u0026n=O446YQrF1qMjlNwS\u0026q=85\u0026s=4e966e2dc30e631ecd17c82d5445201f","dark":"https://mintcdn.com/etherscan/O446YQrF1qMjlNwS/logo/etherscan-logo-light.svg?fit=max\u0026auto=format\u0026n=O446YQrF1qMjlNwS\u0026q=85\u0026s=61cb0a4a7a22bd9667ac9f22f72ed85e"},"favicon":"https://mintcdn.com/etherscan/O446YQrF1qMjlNwS/logo/etherscan-logo-circle.svg?fit=max\u0026auto=format\u0026n=O446YQrF1qMjlNwS\u0026q=85\u0026s=e0afd6fa2127dcb9f05292b819cddb9f","api":{"playground":{"display":"interactive"},"examples":{"prefill":false},"mdx":{"server":"https://api.etherscan.io"}},"navbar":{"links":[{"href":"https://etherscan.io/api/pricing","label":"Pricing"},{"href":"https://etherscan.io/contactus","label":"Support"}],"primary":{"type":"button","label":"Get started","href":"/set-up-your-api-key"}},"footer":{"socials":{"x":"https://x.com/etherscan","website":"https://etherscan.io"}},"errors":{"404":{"redirect":true}},"contextual":{"options":["copy","chatgpt","claude","cursor","vscode"],"display":"header"},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"etherscan","hasAudioNarration":false,"actualSubdomain":"etherscan","customDomains":["docs.etherscan.io"],"gitSource":{"type":"github","owner":"blocksolutions","repo":"mintlify-docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6ad863010415e81028113de7","collectionId":"a68d60f9-2b4d-45bf-8bc6-afdb6c575b67","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6ad863010415e81028113de7"},"entitlements":{"AI_CHAT":{"status":"DISABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"DISABLED"}},"buildId":"6ad863010415e81028113de7","clientVersion":"0.0.3971","searchFilterCounts":[{"language":"default","tag":"API Endpoints","count":190},{"language":"default","tag":"Overview","count":27},{"language":"default","tag":"Account","count":18},{"language":"default","tag":"Guides","count":18},{"language":"default","tag":"Stats","count":14},{"language":"default","tag":"Geth/Parity Proxy","count":14},{"language":"default","tag":"Contract Verification","count":13},{"language":"default","tag":"Tokens","count":11},{"language":"default","tag":"Blocks","count":9},{"language":"default","tag":"Build with AI","count":9}]},"assistantConfig":{"deflection":{"enabled":true,"email":"apisupport@etherscan.io"}},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":true,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-v7-file-tree","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"pause-universal-search-reconcile","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"per-site-search-delta","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-private-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-nav-generations","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"byok-sep-25","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"vite-origin","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-agent-model-picker","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-updated-9-15","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"privacy":{"consentBanner":{"enabled":true}},"isAtlas":false,"googleFontsInlined":false},"customCss":[{"filePath":"style.css","content":":root{--color-rgb:36, 107, 238;--navbar-bg-hsl:220, 25%, 100%}:root.dark{--navbar-bg-hsl:209, 23%, 9%}#navbar{overflow:hidden;background-color:hsla(var(--navbar-bg-hsl),1);background-image:radial-gradient(at 14% 42%,hsla(var(--navbar-bg-hsl),1) 0,transparent 50%),radial-gradient(at 39% 9%,hsla(var(--navbar-bg-hsl),1) 0,transparent 50%),radial-gradient(at 95% 85%,hsla(var(--navbar-bg-hsl),1) 0,transparent 50%),radial-gradient(at 99% 61%,hsla(var(--navbar-bg-hsl),1) 0,transparent 50%),radial-gradient(at 91% 60%,rgba(var(--color-rgb),.4) 0,transparent 50%),radial-gradient(at 69% 0%,rgba(var(--color-rgb),.4) 0,transparent 50%)}#navbar::after{content:'';width:60rem;height:60rem;position:absolute;top:-150%;right:-30%;background-image:url(/images/abstract-lines-kb.svg);background-size:40rem;background-repeat:no-repeat;cursor:default;pointer-events:none}.data-\\[is-opaque\\=true\\]\\:bg-background-light[data-is-opaque=true]{background-color:initial!important}.data-\\[is-opaque\\=true\\]\\:dark\\:bg-background-dark\\/75:is(.dark *)[data-is-opaque=true]{background-color:initial!important}.prose:is(.dark *){color:#d1d1d1}.nav-tag-pill-text[data-nav-tag],.tryit-button{background-color:#0784c3!important}.nav-tag-pill-text[data-nav-tag]{color:#fff!important}.nav-tag-pill-text[data-nav-tag=\"PRO+\"]{background-color:#055a8c!important}a:has(.nav-tag-pill) div:has(>div>span.nav-tag-pill){display:block}a:has(.nav-tag-pill) div:has(>div>span.nav-tag-pill)>div:last-child{display:inline-flex;vertical-align:middle;margin-left:.375rem}"}],"page":{"pagePath":"api-reference/endpoint/topholders","slug":"/api-reference/endpoint/topholders","pageMetadata":{"title":"Get Top Token Holders","sidebarTitle":"Get Top Token Holders","tag":"PRO","openapi":"openapi/api-reference/endpoint/topholders.json GET /v2/api","keywords":["top token holders","erc20 analytics"],"description":"Returns the list of top holders for a specified ERC-20 token.","href":"/api-reference/endpoint/topholders"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Returns the list of top holders for a specified ERC-20 token.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];const chain=`1`;function _createMdxContent(props){const _components={a:`a`,strong:`strong`,..._provideComponents(),...props.components},{Callout,Note,OptimizedImage,Warning}=_components;if(!Callout)_missingMdxReference(`Callout`,true);if(!Note)_missingMdxReference(`Note`,true);if(!OptimizedImage)_missingMdxReference(`OptimizedImage`,true);if(!Warning)_missingMdxReference(`Warning`,true);return _jsxs(_Fragment,{children:[_jsxs(Note,{children:[`This is a PRO endpoint, available to the `,_jsx(_components.a,{href:`/rate-limits`,children:`Standard Plan`}),` and above.`]}),`\n`,_jsxs(Warning,{children:[`This endpoint is throttled to `,_jsx(_components.strong,{children:`2 calls/second`}),` regardless of API Pro tier.`]}),`\n`,_jsx(Callout,{icon:`globe`,iconType:`regular`,children:`HyperEVM (999) is not supported yet.`}),`\n`,_jsx(OptimizedImage,{src:`https://mintcdn.com/etherscan/_gIsWVKPgcVhiZQW/images/features/holders.png?fit=max\u0026auto=format\u0026n=_gIsWVKPgcVhiZQW\u0026q=85\u0026s=9e6457139c74e1173d79e860ae4c9b08`,alt:`Token holders`,\"data-og-width\":`1440`,width:`1440`,\"data-og-height\":`550`,height:`550`,\"data-path\":`images/features/holders.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/etherscan/_gIsWVKPgcVhiZQW/images/features/holders.png?w=280\u0026fit=max\u0026auto=format\u0026n=_gIsWVKPgcVhiZQW\u0026q=85\u0026s=e221b7e761d61c170022a36d3b77a4a0 280w, https://mintcdn.com/etherscan/_gIsWVKPgcVhiZQW/images/features/holders.png?w=560\u0026fit=max\u0026auto=format\u0026n=_gIsWVKPgcVhiZQW\u0026q=85\u0026s=a67bf803f38d4344f22a1fd0b35f9d8c 560w, https://mintcdn.com/etherscan/_gIsWVKPgcVhiZQW/images/features/holders.png?w=840\u0026fit=max\u0026auto=format\u0026n=_gIsWVKPgcVhiZQW\u0026q=85\u0026s=657668003e5b1d9befe7dd6c732f5b87 840w, https://mintcdn.com/etherscan/_gIsWVKPgcVhiZQW/images/features/holders.png?w=1100\u0026fit=max\u0026auto=format\u0026n=_gIsWVKPgcVhiZQW\u0026q=85\u0026s=95cb3838dda9a7de24b736ebb31b584b 1100w, https://mintcdn.com/etherscan/_gIsWVKPgcVhiZQW/images/features/holders.png?w=1650\u0026fit=max\u0026auto=format\u0026n=_gIsWVKPgcVhiZQW\u0026q=85\u0026s=1ca9bb49cd735e8bbc68a64b2f0203e3 1650w, https://mintcdn.com/etherscan/_gIsWVKPgcVhiZQW/images/features/holders.png?w=2500\u0026fit=max\u0026auto=format\u0026n=_gIsWVKPgcVhiZQW\u0026q=85\u0026s=10569f23cde4d2374743a40c7f6fc00d 2500w`})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{chain,default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Get Top Token Holders","sidebarTitle":"Get Top Token Holders","tag":"PRO","openapi":"openapi/api-reference/endpoint/topholders.json GET /v2/api","keywords":["top token holders","erc20 analytics"],"description":"Returns the list of top holders for a specified ERC-20 token.","href":"/api-reference/endpoint/topholders"}}},"mdxSourceWithNoJs":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];const chain=`1`;function _createMdxContent(props){const _components={a:`a`,code:`code`,pre:`pre`,span:`span`,strong:`strong`,..._provideComponents(),...props.components},{Callout,CodeBlock,Note,OptimizedImage,ResponseExample,Warning}=_components;if(!Callout)_missingMdxReference(`Callout`,true);if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!Note)_missingMdxReference(`Note`,true);if(!OptimizedImage)_missingMdxReference(`OptimizedImage`,true);if(!ResponseExample)_missingMdxReference(`ResponseExample`,true);if(!Warning)_missingMdxReference(`Warning`,true);return _jsxs(_Fragment,{children:[_jsxs(Note,{children:[`This is a PRO endpoint, available to the `,_jsx(_components.a,{href:`/rate-limits`,children:`Standard Plan`}),` and above.`]}),`\n`,_jsxs(Warning,{children:[`This endpoint is throttled to `,_jsx(_components.strong,{children:`2 calls/second`}),` regardless of API Pro tier.`]}),`\n`,_jsx(Callout,{icon:`globe`,iconType:`regular`,children:`HyperEVM (999) is not supported yet.`}),`\n`,_jsx(OptimizedImage,{src:`https://mintcdn.com/etherscan/_gIsWVKPgcVhiZQW/images/features/holders.png?fit=max\u0026auto=format\u0026n=_gIsWVKPgcVhiZQW\u0026q=85\u0026s=9e6457139c74e1173d79e860ae4c9b08`,alt:`Token holders`,\"data-og-width\":`1440`,width:`1440`,\"data-og-height\":`550`,height:`550`,\"data-path\":`images/features/holders.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/etherscan/_gIsWVKPgcVhiZQW/images/features/holders.png?w=280\u0026fit=max\u0026auto=format\u0026n=_gIsWVKPgcVhiZQW\u0026q=85\u0026s=e221b7e761d61c170022a36d3b77a4a0 280w, https://mintcdn.com/etherscan/_gIsWVKPgcVhiZQW/images/features/holders.png?w=560\u0026fit=max\u0026auto=format\u0026n=_gIsWVKPgcVhiZQW\u0026q=85\u0026s=a67bf803f38d4344f22a1fd0b35f9d8c 560w, https://mintcdn.com/etherscan/_gIsWVKPgcVhiZQW/images/features/holders.png?w=840\u0026fit=max\u0026auto=format\u0026n=_gIsWVKPgcVhiZQW\u0026q=85\u0026s=657668003e5b1d9befe7dd6c732f5b87 840w, https://mintcdn.com/etherscan/_gIsWVKPgcVhiZQW/images/features/holders.png?w=1100\u0026fit=max\u0026auto=format\u0026n=_gIsWVKPgcVhiZQW\u0026q=85\u0026s=95cb3838dda9a7de24b736ebb31b584b 1100w, https://mintcdn.com/etherscan/_gIsWVKPgcVhiZQW/images/features/holders.png?w=1650\u0026fit=max\u0026auto=format\u0026n=_gIsWVKPgcVhiZQW\u0026q=85\u0026s=1ca9bb49cd735e8bbc68a64b2f0203e3 1650w, https://mintcdn.com/etherscan/_gIsWVKPgcVhiZQW/images/features/holders.png?w=2500\u0026fit=max\u0026auto=format\u0026n=_gIsWVKPgcVhiZQW\u0026q=85\u0026s=10569f23cde4d2374743a40c7f6fc00d 2500w`}),`\n`,_jsx(ResponseExample,{children:_jsx(CodeBlock,{filename:`Example response`,numberOfLines:`16`,language:`json`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`16`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"status\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"1\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"message\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Ok\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"result\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: [`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` {`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"TokenHolderAddress\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"0x4da27a545c0c5b758a6ba100e3a049001de870f5\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"TokenHolderQuantity\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"2696124.3026660371030000\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"TokenHolderAddressType\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"C\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` },`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` {`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"TokenHolderAddress\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"0xa700b4eb416be35b2911fd5dee80678ff64ff6c9\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"TokenHolderQuantity\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"1650828.8050095955930000\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"TokenHolderAddressType\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"C\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` }`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` ]`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})})})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{chain,default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Get Top Token Holders","sidebarTitle":"Get Top Token Holders","tag":"PRO","openapi":"openapi/api-reference/endpoint/topholders.json GET /v2/api","keywords":["top token holders","erc20 analytics"],"description":"Returns the list of top holders for a specified ERC-20 token.","href":"/api-reference/endpoint/topholders"}}}},"mdxExtracts":{"tableOfContents":[],"codeExamples":{"response":{"type":"ResponseExample","children":[{"filename":"Example response","html":"\u003cpre class=\"shiki shiki-themes github-light-default dark-plus\" style=\"background-color:#ffffff;--shiki-dark-bg:#0B0C0E;color:#1f2328;--shiki-dark:#D4D4D4\" language=\"json\">\u003ccode language=\"json\" numberOfLines=\"16\">\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">{\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"status\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"1\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"message\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"Ok\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"result\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: [\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> {\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"TokenHolderAddress\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"0x4da27a545c0c5b758a6ba100e3a049001de870f5\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"TokenHolderQuantity\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"2696124.3026660371030000\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"TokenHolderAddressType\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"C\"\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> },\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> {\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"TokenHolderAddress\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"0xa700b4eb416be35b2911fd5dee80678ff64ff6c9\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"TokenHolderQuantity\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"1650828.8050095955930000\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"TokenHolderAddressType\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"C\"\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> }\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> ]\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">}\u003c/span>\u003c/span>\n\u003c/code>\u003c/pre>"}],"attributes":[]}}},"jsLinks":[],"openApiReferenceData":{"operation":{"operationId":"getTopholders","summary":"Get Top Token Holders","description":"Returns the list of top holders for a specified ERC-20 token.","parameters":["3a300f7d-23eb-4c6f-8d40-197128122e9d","5f0c3374-094b-4feb-aedb-3a032f2ec80e","69333a4c-b8bf-4266-8209-3e97791f8fa4","352e11ea-e294-4705-bc45-dea7e76c9800","6ad6209d-7cd3-4400-8150-b22a2d8c3ff1"],"security":["6b49486b-ef8a-4cdd-bc8e-896ce54faa2c"],"responses":{"200":"009f3e2a-7685-437a-b7cd-227ba436d75a"},"x-mint":{"metadata":{"title":"Get Top Token Holders","description":"Returns the list of top holders for a specified ERC-20 token."}},"x-etherscan-source-page":{"page":"api-reference/endpoint/topholders","title":"Get Top Token Holders","module":"token","action":"topholders"},"method":"get","type":"path","servers":["58502fa8-a988-4c03-bc9d-e222631103b2"],"path":"/v2/api","baseUrlOptions":["https://api.etherscan.io"],"title":"Get Top Token Holders","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExamples":[{"dropdown":false,"language":"json","code":{"type":"pre","key":null,"ref":null,"props":{"className":"shiki shiki-themes github-light-default dark-plus","style":{"backgroundColor":"#ffffff","--shiki-dark-bg":"#0B0C0E","color":"#1f2328","--shiki-dark":"#D4D4D4"},"language":"json","children":{"type":"code","key":null,"ref":null,"props":{"language":"json","numberOfLines":"16","children":[{"type":"span","key":"0","ref":null,"props":{"className":"line","children":{"type":"span","key":null,"ref":null,"props":{"style":{"color":"#1F2328","--shiki-dark":"#D4D4D4"},"children":"{"}}}},"\n",{"type":"span","key":"2","ref":null,"props":{"className":"line","children":[{"type":"span","key":"0","ref":null,"props":{"style":{"color":"#116329","--shiki-dark":"#9CDCFE"},"children":" \"status\""}},{"type":"span","key":"1","ref":null,"props":{"style":{"color":"#1F2328","--shiki-dark":"#D4D4D4"},"children":": "}},{"type":"span","key":"2","ref":null,"props":{"style":{"color":"#0A3069","--shiki-dark":"#CE9178"},"children":"\"1\""}},{"type":"span","key":"3","ref":null,"props":{"style":{"color":"#1F2328","--shiki-dark":"#D4D4D4"},"children":","}}]}},"\n",{"type":"span","key":"4","ref":null,"props":{"className":"line","children":[{"type":"span","key":"0","ref":null,"props":{"style":{"color":"#116329","--shiki-dark":"#9CDCFE"},"children":" \"message\""}},{"type":"span","key":"1","ref":null,"props":{"style":{"color":"#1F2328","--shiki-dark":"#D4D4D4"},"children":": "}},{"type":"span","key":"2","ref":null,"props":{"style":{"color":"#0A3069","--shiki-dark":"#CE9178"},"children":"\"Ok\""}},{"type":"span","key":"3","ref":null,"props":{"style":{"color":"#1F2328","--shiki-dark":"#D4D4D4"},"children":","}}]}},"\n",{"type":"span","key":"6","ref":null,"props":{"className":"line","children":[{"type":"span","key":"0","ref":null,"props":{"style":{"color":"#116329","--shiki-dark":"#9CDCFE"},"children":" \"result\""}},{"type":"span","key":"1","ref":null,"props":{"style":{"color":"#1F2328","--shiki-dark":"#D4D4D4"},"children":": ["}}]}},"\n",{"type":"span","key":"8","ref":null,"props":{"className":"line","children":{"type":"span","key":null,"ref":null,"props":{"style":{"color":"#1F2328","--shiki-dark":"#D4D4D4"},"children":" {"}}}},"\n",{"type":"span","key":"10","ref":null,"props":{"className":"line","children":[{"type":"span","key":"0","ref":null,"props":{"style":{"color":"#116329","--shiki-dark":"#9CDCFE"},"children":" \"TokenHolderAddress\""}},{"type":"span","key":"1","ref":null,"props":{"style":{"color":"#1F2328","--shiki-dark":"#D4D4D4"},"children":": "}},{"type":"span","key":"2","ref":null,"props":{"style":{"color":"#0A3069","--shiki-dark":"#CE9178"},"children":"\"0x4da27a545c0c5b758a6ba100e3a049001de870f5\""}},{"type":"span","key":"3","ref":null,"props":{"style":{"color":"#1F2328","--shiki-dark":"#D4D4D4"},"children":","}}]}},"\n",{"type":"span","key":"12","ref":null,"props":{"className":"line","children":[{"type":"span","key":"0","ref":null,"props":{"style":{"color":"#116329","--shiki-dark":"#9CDCFE"},"children":" \"TokenHolderQuantity\""}},{"type":"span","key":"1","ref":null,"props":{"style":{"color":"#1F2328","--shiki-dark":"#D4D4D4"},"children":": "}},{"type":"span","key":"2","ref":null,"props":{"style":{"color":"#0A3069","--shiki-dark":"#CE9178"},"children":"\"2696124.3026660371030000\""}},{"type":"span","key":"3","ref":null,"props":{"style":{"color":"#1F2328","--shiki-dark":"#D4D4D4"},"children":","}}]}},"\n",{"type":"span","key":"14","ref":null,"props":{"className":"line","children":[{"type":"span","key":"0","ref":null,"props":{"style":{"color":"#116329","--shiki-dark":"#9CDCFE"},"children":" \"TokenHolderAddressType\""}},{"type":"span","key":"1","ref":null,"props":{"style":{"color":"#1F2328","--shiki-dark":"#D4D4D4"},"children":": "}},{"type":"span","key":"2","ref":null,"props":{"style":{"color":"#0A3069","--shiki-dark":"#CE9178"},"children":"\"C\""}}]}},"\n",{"type":"span","key":"16","ref":null,"props":{"className":"line","children":{"type":"span","key":null,"ref":null,"props":{"style":{"color":"#1F2328","--shiki-dark":"#D4D4D4"},"children":" },"}}}},"\n",{"type":"span","key":"18","ref":null,"props":{"className":"line","children":{"type":"span","key":null,"ref":null,"props":{"style":{"color":"#1F2328","--shiki-dark":"#D4D4D4"},"children":" {"}}}},"\n",{"type":"span","key":"20","ref":null,"props":{"className":"line","children":[{"type":"span","key":"0","ref":null,"props":{"style":{"color":"#116329","--shiki-dark":"#9CDCFE"},"children":" \"TokenHolderAddress\""}},{"type":"span","key":"1","ref":null,"props":{"style":{"color":"#1F2328","--shiki-dark":"#D4D4D4"},"children":": "}},{"type":"span","key":"2","ref":null,"props":{"style":{"color":"#0A3069","--shiki-dark":"#CE9178"},"children":"\"0xa700b4eb416be35b2911fd5dee80678ff64ff6c9\""}},{"type":"span","key":"3","ref":null,"props":{"style":{"color":"#1F2328","--shiki-dark":"#D4D4D4"},"children":","}}]}},"\n",{"type":"span","key":"22","ref":null,"props":{"className":"line","children":[{"type":"span","key":"0","ref":null,"props":{"style":{"color":"#116329","--shiki-dark":"#9CDCFE"},"children":" \"TokenHolderQuantity\""}},{"type":"span","key":"1","ref":null,"props":{"style":{"color":"#1F2328","--shiki-dark":"#D4D4D4"},"children":": "}},{"type":"span","key":"2","ref":null,"props":{"style":{"color":"#0A3069","--shiki-dark":"#CE9178"},"children":"\"1650828.8050095955930000\""}},{"type":"span","key":"3","ref":null,"props":{"style":{"color":"#1F2328","--shiki-dark":"#D4D4D4"},"children":","}}]}},"\n",{"type":"span","key":"24","ref":null,"props":{"className":"line","children":[{"type":"span","key":"0","ref":null,"props":{"style":{"color":"#116329","--shiki-dark":"#9CDCFE"},"children":" \"TokenHolderAddressType\""}},{"type":"span","key":"1","ref":null,"props":{"style":{"color":"#1F2328","--shiki-dark":"#D4D4D4"},"children":": "}},{"type":"span","key":"2","ref":null,"props":{"style":{"color":"#0A3069","--shiki-dark":"#CE9178"},"children":"\"C\""}}]}},"\n",{"type":"span","key":"26","ref":null,"props":{"className":"line","children":{"type":"span","key":null,"ref":null,"props":{"style":{"color":"#1F2328","--shiki-dark":"#D4D4D4"},"children":" }"}}}},"\n",{"type":"span","key":"28","ref":null,"props":{"className":"line","children":{"type":"span","key":null,"ref":null,"props":{"style":{"color":"#1F2328","--shiki-dark":"#D4D4D4"},"children":" ]"}}}},"\n",{"type":"span","key":"30","ref":null,"props":{"className":"line","children":{"type":"span","key":null,"ref":null,"props":{"style":{"color":"#1F2328","--shiki-dark":"#D4D4D4"},"children":"}"}}}},"\n"]}}}},"filename":"Example response"}],"responseExampleType":"mdx"},"dependencies":{"parameters":{"3a300f7d-23eb-4c6f-8d40-197128122e9d":{"name":"chainid","in":"query","required":true,"description":"Chain ID to query, eg 1 for Ethereum, 42161 for Arbitrum from our [supported chains](/supported-chains).","schema":{"type":"string","isRequired":true,"description":"Chain ID to query, eg 1 for Ethereum, 42161 for Arbitrum from our [supported chains](/supported-chains).","uniqueKey":"","typeLabel":"string"},"example":"1"},"5f0c3374-094b-4feb-aedb-3a032f2ec80e":{"name":"module","in":"query","required":true,"description":"Set to token for this endpoint.","schema":{"type":"string","default":"token","isRequired":true,"description":"Set to token for this endpoint.","uniqueKey":"","typeLabel":"string"},"example":"token"},"69333a4c-b8bf-4266-8209-3e97791f8fa4":{"name":"action","in":"query","required":true,"description":"Set to topholders for this endpoint.","schema":{"type":"string","default":"topholders","isRequired":true,"description":"Set to topholders for this endpoint.","uniqueKey":"","typeLabel":"string"},"example":"topholders"},"352e11ea-e294-4705-bc45-dea7e76c9800":{"name":"contractaddress","in":"query","required":true,"description":"Contract address of the ERC-20 token.","schema":{"type":"string","isRequired":true,"description":"Contract address of the ERC-20 token.","uniqueKey":"","typeLabel":"string"},"example":"0x7fc66500c84a76ad7e9c93437bfc5ac33e2ddae9"},"6ad6209d-7cd3-4400-8150-b22a2d8c3ff1":{"name":"offset","in":"query","required":false,"description":"Number of top holders to return, up to 1000.","schema":{"type":"integer","isRequired":false,"description":"Number of top holders to return, up to 1000.","uniqueKey":"","typeLabel":"integer"},"example":100}},"responses":{"009f3e2a-7685-437a-b7cd-227ba436d75a":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"string","description":"1 if the request returned data, 0 otherwise. A status of 0 can indicate an error or a valid request that returned no records.","uniqueKey":"status","typeLabel":"string"},"message":{"type":"string","description":"OK on success, otherwise an error description such as NOTOK. See [common error messages](/common-error-messages).","uniqueKey":"message","typeLabel":"string"},"result":{"type":"array","items":{"type":"object","properties":{"TokenHolderAddress":{"type":"string","description":"Address holding the token.","uniqueKey":"result.items.[INDEX].TokenHolderAddress","typeLabel":"string"},"TokenHolderQuantity":{"type":"string","description":"Quantity of the token held by the address.","uniqueKey":"result.items.[INDEX].TokenHolderQuantity","typeLabel":"string"},"TokenHolderAddressType":{"type":"string","description":"Type of holder address. C for a contract, A for an externally owned account (EOA).","uniqueKey":"result.items.[INDEX].TokenHolderAddressType","typeLabel":"string"}},"uniqueKey":"result.items.[INDEX]","typeLabel":"object"},"uniqueKey":"result","typeLabel":"object[]"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"status":"\u003cstring>","message":"\u003cstring>","result":[{"TokenHolderAddress":"\u003cstring>","TokenHolderQuantity":"\u003cstring>","TokenHolderAddressType":"\u003cstring>"}]}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"6b49486b-ef8a-4cdd-bc8e-896ce54faa2c":{"apiKey":{"type":"apiKey","in":"query","name":"apikey","description":"Enter your Etherscan API key, or [set one up](/set-up-your-api-key) if you don't have one.","scopes":[]}}},"servers":{"58502fa8-a988-4c03-bc9d-e222631103b2":{"url":"https://api.etherscan.io","description":"Etherscan API."}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"apiKey","in":"query","name":"apikey","description":"Enter your Etherscan API key, or [set one up](/set-up-your-api-key) if you don't have one.","scopes":[]},"schema":{"title":"apikey","type":"string","description":"Enter your Etherscan API key, or [set one up](/set-up-your-api-key) if you don't have one.","isRequired":true,"typeLabel":"string","deprecated":false},"schemeName":"apiKey","name":"apikey"}],"title":"apiKey"}]},"originalFileLocation":"openapi/api-reference/endpoint/topholders.json"},"subdomain":"etherscan","siteName":"Etherscan","title":"Get Top Token Holders - Etherscan","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-08-20T09:11:04.089Z","originalFileLocation":"api-reference/endpoint/topholders.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Returns the list of top holders for a specified ERC-20 token.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Etherscan\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/etherscan/PMbbZQeU1A_1WqNP/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/etherscan/PMbbZQeU1A_1WqNP/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/etherscan/PMbbZQeU1A_1WqNP/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/etherscan/PMbbZQeU1A_1WqNP/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/etherscan/PMbbZQeU1A_1WqNP/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/etherscan/PMbbZQeU1A_1WqNP/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/etherscan/PMbbZQeU1A_1WqNP/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/etherscan/PMbbZQeU1A_1WqNP/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/etherscan/PMbbZQeU1A_1WqNP/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Get Top Token Holders - Etherscan\">\u003cmeta data-mint-head property=\"og:description\" content=\"Returns the list of top holders for a specified ERC-20 token.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Etherscan\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.etherscan.io/api-reference/endpoint/topholders\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://etherscan.mintlify.app/_mintlify/api/og/v2?division=Tokens\u0026amp;title=Get+Top+Token+Holders\u0026amp;description=Returns+the+list+of+top+holders+for+a+specified+ERC-20+token.\u0026amp;theme=508771c6adde6156ee350715\u0026amp;signature=657360e6cb807e78ebbf5ffb2debf224a1f92024926bb8de59d07fabafc5992a\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Get Top Token Holders - Etherscan\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Returns the list of top holders for a specified ERC-20 token.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://etherscan.mintlify.app/_mintlify/api/og/v2?division=Tokens\u0026amp;title=Get+Top+Token+Holders\u0026amp;description=Returns+the+list+of+top+holders+for+a+specified+ERC-20+token.\u0026amp;theme=508771c6adde6156ee350715\u0026amp;signature=657360e6cb807e78ebbf5ffb2debf224a1f92024926bb8de59d07fabafc5992a\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/etherscan/PMbbZQeU1A_1WqNP/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Etherscan\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#0784C3\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.etherscan.io/api-reference/endpoint/topholders\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/endpoint/topholders.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.etherscan.io/#organization\",\"name\":\"Etherscan\",\"url\":\"https://docs.etherscan.io\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/etherscan/O446YQrF1qMjlNwS/logo/etherscan-logo-dark.svg?fit=max\u0026auto=format\u0026n=O446YQrF1qMjlNwS\u0026q=85\u0026s=4e966e2dc30e631ecd17c82d5445201f\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.etherscan.io#website\",\"name\":\"Etherscan\",\"url\":\"https://docs.etherscan.io\",\"publisher\":{\"@id\":\"https://docs.etherscan.io/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.etherscan.io/api-reference/endpoint/topholders#webpage\",\"url\":\"https://docs.etherscan.io/api-reference/endpoint/topholders\",\"name\":\"Get Top Token Holders\",\"description\":\"Returns the list of top holders for a specified ERC-20 token.\",\"dateModified\":\"2026-08-20T09:11:04.089Z\",\"isPartOf\":{\"@id\":\"https://docs.etherscan.io#website\"},\"breadcrumb\":{\"@id\":\"https://docs.etherscan.io/api-reference/endpoint/topholders#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.etherscan.io/api-reference/endpoint/topholders#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"API Endpoints\",\"item\":\"https://docs.etherscan.io/api-reference/endpoint/balance\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Tokens\",\"item\":\"https://docs.etherscan.io/api-reference/endpoint/tokensupply\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Get Top Token Holders\",\"item\":\"https://docs.etherscan.io/api-reference/endpoint/topholders\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.etherscan.io/api-reference/endpoint/topholders#apireference\",\"headline\":\"Get Top Token Holders\",\"name\":\"Get Top Token Holders\",\"description\":\"Returns the list of top holders for a specified ERC-20 token.\",\"url\":\"https://docs.etherscan.io/api-reference/endpoint/topholders\",\"mainEntityOfPage\":{\"@id\":\"https://docs.etherscan.io/api-reference/endpoint/topholders#webpage\"},\"dateModified\":\"2026-08-20T09:11:04.089Z\",\"keywords\":\"top token holders, erc20 analytics\",\"publisher\":{\"@id\":\"https://docs.etherscan.io/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.etherscan.io#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Etherscan\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Etherscan","nav":{"global":null,"tabs":[{"tab":"Overview","pages":[{"title":"Overview","href":"/introduction"}]},{"tab":"Build with AI","pages":[{"title":"Build with AI","href":"/build-with-ai/introduction"}]},{"tab":"API Endpoints","pages":[{"title":"Endpoint Overview","href":"/endpoint-overview"},{"group":"API Endpoints","pages":[{"group":"Account","pages":[{"title":"Get Native Balance for an Address","openapi":"openapi/api-reference/endpoint/balance.json GET /v2/api","href":"/api-reference/endpoint/balance"},{"title":"Get Native Balance for Multiple Addresses","openapi":"openapi/api-reference/endpoint/balancemulti.json GET /v2/api","href":"/api-reference/endpoint/balancemulti"},{"title":"Get Historical Native Balance for an Address","sidebarTitle":"Get Historical Native Balance for an Address","tag":"PRO","openapi":"openapi/api-reference/endpoint/balancehistory.json GET /v2/api","href":"/api-reference/endpoint/balancehistory"},{"title":"Get Normal Transactions By Address","openapi":"openapi/api-reference/endpoint/txlist.json GET /v2/api","href":"/api-reference/endpoint/txlist"},{"title":"Normal Transactions Advanced Filter","openapi":"openapi/api-reference/endpoint/advanced-filter-txlist.json GET /v2/api","href":"/api-reference/endpoint/advanced-filter-txlist"},{"title":"Get ERC20 Token Transfers by Address","openapi":"openapi/api-reference/endpoint/tokentx.json GET /v2/api","href":"/api-reference/endpoint/tokentx"},{"title":"ERC20 Token Transfers Advanced Filter","openapi":"openapi/api-reference/endpoint/advanced-filter-tokentx.json GET /v2/api","href":"/api-reference/endpoint/advanced-filter-tokentx"},{"title":"Get ERC721 Token Transfers by Address","openapi":"openapi/api-reference/endpoint/tokennfttx.json GET /v2/api","href":"/api-reference/endpoint/tokennfttx"},{"title":"ERC721 Token Transfers Advanced Filter","openapi":"openapi/api-reference/endpoint/advanced-filter-tokennfttx.json GET /v2/api","href":"/api-reference/endpoint/advanced-filter-tokennfttx"},{"title":"Get ERC1155 Token Transfers by Address","openapi":"openapi/api-reference/endpoint/token1155tx.json GET /v2/api","href":"/api-reference/endpoint/token1155tx"},{"title":"ERC1155 Token Transfers Advanced Filter","openapi":"openapi/api-reference/endpoint/advanced-filter-token1155tx.json GET /v2/api","href":"/api-reference/endpoint/advanced-filter-token1155tx"},{"title":"Get Internal Transactions by Address","openapi":"openapi/api-reference/endpoint/txlistinternal.json GET /v2/api","href":"/api-reference/endpoint/txlistinternal"},{"title":"Internal Transactions Advanced Filter","openapi":"openapi/api-reference/endpoint/advanced-filter-txlistinternal.json GET /v2/api","href":"/api-reference/endpoint/advanced-filter-txlistinternal"},{"title":"Get Internal Transactions by Block Range","sidebarTitle":"Get Internal Transactions by Block Range","tag":"PRO","openapi":"openapi/api-reference/endpoint/txlistinternal-blockrange.json GET /v2/api","href":"/api-reference/endpoint/txlistinternal-blockrange"},{"title":"Get Internal Transactions by Transaction Hash","openapi":"openapi/api-reference/endpoint/txlistinternal-txhash.json GET /v2/api","href":"/api-reference/endpoint/txlistinternal-txhash"},{"title":"Get Blocks Validated by Address","openapi":"openapi/api-reference/endpoint/getminedblocks.json GET /v2/api","href":"/api-reference/endpoint/getminedblocks"},{"title":"Get Beacon Chain Withdrawals by Address","openapi":"openapi/api-reference/endpoint/txsbeaconwithdrawal.json GET /v2/api","href":"/api-reference/endpoint/txsbeaconwithdrawal"},{"title":"Get Address Funded By","sidebarTitle":"Get Address Funded By","tag":"PRO","openapi":"openapi/api-reference/endpoint/fundedby.json GET /v2/api","href":"/api-reference/endpoint/fundedby"}]},{"group":"Blocks","pages":[{"title":"Get Block and Uncle Rewards by Block Number","openapi":"openapi/api-reference/endpoint/getblockreward.json GET /v2/api","href":"/api-reference/endpoint/getblockreward"},{"title":"Get Block Transaction Counts by Block Number","openapi":"openapi/api-reference/endpoint/getblocktxnscount.json GET /v2/api","href":"/api-reference/endpoint/getblocktxnscount"},{"title":"Get Estimated Block Countdown by Block Number","openapi":"openapi/api-reference/endpoint/getblockcountdown.json GET /v2/api","href":"/api-reference/endpoint/getblockcountdown"},{"title":"Get Block Number by Timestamp","openapi":"openapi/api-reference/endpoint/getblocknobytime.json GET /v2/api","href":"/api-reference/endpoint/getblocknobytime"},{"title":"Get Daily Average Block Size","sidebarTitle":"Get Daily Average Block Size","tag":"PRO","openapi":"openapi/api-reference/endpoint/dailyavgblocksize.json GET /v2/api","href":"/api-reference/endpoint/dailyavgblocksize"},{"title":"Get Daily Block Count and Rewards","sidebarTitle":"Get Daily Block Count and Rewards","tag":"PRO","openapi":"openapi/api-reference/endpoint/dailyblkcount.json GET /v2/api","href":"/api-reference/endpoint/dailyblkcount"},{"title":"Get Daily Block Rewards","sidebarTitle":"Get Daily Block Rewards","tag":"PRO","openapi":"openapi/api-reference/endpoint/dailyblockrewards.json GET /v2/api","href":"/api-reference/endpoint/dailyblockrewards"},{"title":"Get Daily Average Block Time","sidebarTitle":"Get Daily Average Block Time","tag":"PRO","openapi":"openapi/api-reference/endpoint/dailyavgblocktime.json GET /v2/api","href":"/api-reference/endpoint/dailyavgblocktime"},{"title":"Get Daily Uncle Block Count and Rewards","sidebarTitle":"Get Daily Uncle Block Count and Rewards","tag":"PRO","openapi":"openapi/api-reference/endpoint/dailyuncleblkcount.json GET /v2/api","href":"/api-reference/endpoint/dailyuncleblkcount"}]},{"group":"Contracts","pages":[{"title":"Get Contract ABI","openapi":"openapi/api-reference/endpoint/getabi.json GET /v2/api","href":"/api-reference/endpoint/getabi"},{"title":"Get Contract Source Code","openapi":"openapi/api-reference/endpoint/getsourcecode.json GET /v2/api","href":"/api-reference/endpoint/getsourcecode"},{"title":"Get Contract Creator and Creation Tx Hash","openapi":"openapi/api-reference/endpoint/getcontractcreation.json GET /v2/api","href":"/api-reference/endpoint/getcontractcreation"}]},{"group":"Contract Verification","pages":[{"title":"Verify Solidity Source Code","openapi":"openapi/api-reference/endpoint/verifysourcecode.json POST /v2/api","href":"/api-reference/endpoint/verifysourcecode"},{"title":"Verify zkSync Source Code","openapi":"openapi/api-reference/endpoint/verifyzksyncsourcecode.json POST /v2/api","href":"/api-reference/endpoint/verifyzksyncsourcecode"},{"title":"Verify Vyper Source Code","openapi":"openapi/api-reference/endpoint/verifyvyper.json POST /v2/api","href":"/api-reference/endpoint/verifyvyper"},{"title":"Verify Stylus Source Code","openapi":"openapi/api-reference/endpoint/verifystylus.json POST /v2/api","href":"/api-reference/endpoint/verifystylus"},{"title":"Verify Proxy Contract","openapi":"openapi/api-reference/endpoint/verifyproxycontract.json POST /v2/api","href":"/api-reference/endpoint/verifyproxycontract"},{"title":"Check Source Code Verification Status","openapi":"openapi/api-reference/endpoint/checkverifystatus.json GET /v2/api","href":"/api-reference/endpoint/checkverifystatus"},{"title":"Check Proxy Contract Verification Status","openapi":"openapi/api-reference/endpoint/checkproxyverification.json GET /v2/api","href":"/api-reference/endpoint/checkproxyverification"}]},{"group":"Gas Tracker","pages":[{"title":"Get Estimation of Confirmation Time","openapi":"openapi/api-reference/endpoint/gasestimate.json GET /v2/api","href":"/api-reference/endpoint/gasestimate"},{"title":"Get Gas Oracle","openapi":"openapi/api-reference/endpoint/gasoracle.json GET /v2/api","href":"/api-reference/endpoint/gasoracle"},{"title":"Get Daily Average Gas Limit","sidebarTitle":"Get Daily Average Gas Limit","tag":"PRO","openapi":"openapi/api-reference/endpoint/dailyavggaslimit.json GET /v2/api","href":"/api-reference/endpoint/dailyavggaslimit"},{"title":"Get Ethereum Daily Total Gas Used","sidebarTitle":"Get Ethereum Daily Total Gas Used","tag":"PRO","openapi":"openapi/api-reference/endpoint/dailygasused.json GET /v2/api","href":"/api-reference/endpoint/dailygasused"},{"title":"Get Daily Average Gas Price","sidebarTitle":"Get Daily Average Gas Price","tag":"PRO","openapi":"openapi/api-reference/endpoint/dailyavggasprice.json GET /v2/api","href":"/api-reference/endpoint/dailyavggasprice"}]},{"group":"Geth/Parity Proxy","pages":[{"title":"eth_blockNumber","openapi":"openapi/api-reference/endpoint/ethblocknumber.json GET /v2/api","href":"/api-reference/endpoint/ethblocknumber"},{"title":"eth_getBlockByNumber","openapi":"openapi/api-reference/endpoint/ethgetblockbynumber.json GET /v2/api","href":"/api-reference/endpoint/ethgetblockbynumber"},{"title":"eth_getUncleByBlockNumberAndIndex","openapi":"openapi/api-reference/endpoint/ethgetunclebyblocknumberandindex.json GET /v2/api","href":"/api-reference/endpoint/ethgetunclebyblocknumberandindex"},{"title":"eth_getBlockTransactionCountByNumber","openapi":"openapi/api-reference/endpoint/ethgetblocktransactioncountbynumber.json GET /v2/api","href":"/api-reference/endpoint/ethgetblocktransactioncountbynumber"},{"title":"eth_getTransactionByHash","openapi":"openapi/api-reference/endpoint/ethgettransactionbyhash.json GET /v2/api","href":"/api-reference/endpoint/ethgettransactionbyhash"},{"title":"eth_getTransactionByBlockNumberAndIndex","openapi":"openapi/api-reference/endpoint/ethgettransactionbyblocknumberandindex.json GET /v2/api","href":"/api-reference/endpoint/ethgettransactionbyblocknumberandindex"},{"title":"eth_getTransactionCount","openapi":"openapi/api-reference/endpoint/ethgettransactioncount.json GET /v2/api","href":"/api-reference/endpoint/ethgettransactioncount"},{"title":"eth_sendRawTransaction","openapi":"openapi/api-reference/endpoint/ethsendrawtransaction.json GET /v2/api","href":"/api-reference/endpoint/ethsendrawtransaction"},{"title":"eth_getTransactionReceipt","openapi":"openapi/api-reference/endpoint/ethgettransactionreceipt.json GET /v2/api","href":"/api-reference/endpoint/ethgettransactionreceipt"},{"title":"eth_call","openapi":"openapi/api-reference/endpoint/ethcall.json GET /v2/api","href":"/api-reference/endpoint/ethcall"},{"title":"eth_getCode","openapi":"openapi/api-reference/endpoint/ethgetcode.json GET /v2/api","href":"/api-reference/endpoint/ethgetcode"},{"title":"eth_getStorageAt","openapi":"openapi/api-reference/endpoint/ethgetstorageat.json GET /v2/api","href":"/api-reference/endpoint/ethgetstorageat"},{"title":"eth_gasPrice","openapi":"openapi/api-reference/endpoint/ethgasprice.json GET /v2/api","href":"/api-reference/endpoint/ethgasprice"},{"title":"eth_estimateGas","openapi":"openapi/api-reference/endpoint/ethestimategas.json GET /v2/api","href":"/api-reference/endpoint/ethestimategas"}]},{"group":"Logs","pages":[{"title":"Get Event Logs by Address","openapi":"openapi/api-reference/endpoint/getlogs.json GET /v2/api","href":"/api-reference/endpoint/getlogs"},{"title":"Get Event Logs by Topics","openapi":"openapi/api-reference/endpoint/getlogs-topics.json GET /v2/api","href":"/api-reference/endpoint/getlogs-topics"},{"title":"Get Event Logs by Address and Topics","openapi":"openapi/api-reference/endpoint/getlogs-address-topics.json GET /v2/api","href":"/api-reference/endpoint/getlogs-address-topics"}]},{"group":"Stats","pages":[{"title":"Get Total Supply of Ether","openapi":"openapi/api-reference/endpoint/ethsupply.json GET /v2/api","href":"/api-reference/endpoint/ethsupply"},{"title":"Get Total Supply of Ether 2","openapi":"openapi/api-reference/endpoint/ethsupply2.json GET /v2/api","href":"/api-reference/endpoint/ethsupply2"},{"title":"Get Ether Last Price","openapi":"openapi/api-reference/endpoint/ethprice.json GET /v2/api","href":"/api-reference/endpoint/ethprice"},{"title":"Get Ethereum Nodes Size","openapi":"openapi/api-reference/endpoint/chainsize.json GET /v2/api","href":"/api-reference/endpoint/chainsize"},{"title":"Get Total Nodes Count","openapi":"openapi/api-reference/endpoint/nodecount.json GET /v2/api","href":"/api-reference/endpoint/nodecount"},{"title":"Get Historical Total Nodes Count","sidebarTitle":"Get Historical Total Nodes Count","tag":"PRO","openapi":"openapi/api-reference/endpoint/nodecounthistory.json GET /v2/api","href":"/api-reference/endpoint/nodecounthistory"},{"title":"Get Daily Network Transaction Fee","sidebarTitle":"Get Daily Network Transaction Fee","tag":"PRO","openapi":"openapi/api-reference/endpoint/dailytxnfee.json GET /v2/api","href":"/api-reference/endpoint/dailytxnfee"},{"title":"Get Daily New Address Count","sidebarTitle":"Get Daily New Address Count","tag":"PRO","openapi":"openapi/api-reference/endpoint/dailynewaddress.json GET /v2/api","href":"/api-reference/endpoint/dailynewaddress"},{"title":"Get Daily ENS Registration Count","sidebarTitle":"Get Daily ENS Registration Count","tag":"PRO","openapi":"openapi/api-reference/endpoint/dailyensregister.json GET /v2/api","href":"/api-reference/endpoint/dailyensregister"},{"title":"Get Daily Network Utilization","sidebarTitle":"Get Daily Network Utilization","tag":"PRO","openapi":"openapi/api-reference/endpoint/dailynetutilization.json GET /v2/api","href":"/api-reference/endpoint/dailynetutilization"},{"title":"Get Daily Average Network Hash Rate","sidebarTitle":"Get Daily Average Network Hash Rate","tag":"PRO","openapi":"openapi/api-reference/endpoint/dailyavghashrate.json GET /v2/api","href":"/api-reference/endpoint/dailyavghashrate"},{"title":"Get Daily Transaction Count","sidebarTitle":"Get Daily Transaction Count","tag":"PRO","openapi":"openapi/api-reference/endpoint/dailytx.json GET /v2/api","href":"/api-reference/endpoint/dailytx"},{"title":"Get Daily Average Network Difficulty","sidebarTitle":"Get Daily Average Network Difficulty","tag":"PRO","openapi":"openapi/api-reference/endpoint/dailyavgnetdifficulty.json GET /v2/api","href":"/api-reference/endpoint/dailyavgnetdifficulty"},{"title":"Get Ether Historical Price","sidebarTitle":"Get Ether Historical Price","tag":"PRO","openapi":"openapi/api-reference/endpoint/ethdailyprice.json GET /v2/api","href":"/api-reference/endpoint/ethdailyprice"}]},{"group":"Transactions","pages":[{"title":"Check Contract Execution Status","openapi":"openapi/api-reference/endpoint/getstatus.json GET /v2/api","href":"/api-reference/endpoint/getstatus"},{"title":"Check Transaction Receipt Status","openapi":"openapi/api-reference/endpoint/gettxreceiptstatus.json GET /v2/api","href":"/api-reference/endpoint/gettxreceiptstatus"}]},{"group":"Tokens","pages":[{"title":"Get ERC20-Token TotalSupply by ContractAddress","openapi":"openapi/api-reference/endpoint/tokensupply.json GET /v2/api","href":"/api-reference/endpoint/tokensupply"},{"title":"Get Historical ERC20-Token TotalSupply by ContractAddress \u0026 BlockNo","sidebarTitle":"Get Historical ERC20-Token TotalSupply by ContractAddress \u0026 BlockNo","tag":"PRO","openapi":"openapi/api-reference/endpoint/tokensupplyhistory.json GET /v2/api","href":"/api-reference/endpoint/tokensupplyhistory"},{"title":"Get ERC20-Token Account Balance for TokenContractAddress","openapi":"openapi/api-reference/endpoint/tokenbalance.json GET /v2/api","href":"/api-reference/endpoint/tokenbalance"},{"title":"Get Historical ERC20-Token Account Balance by BlockNo","sidebarTitle":"Get Historical ERC20-Token Account Balance by BlockNo","tag":"PRO","openapi":"openapi/api-reference/endpoint/tokenbalancehistory.json GET /v2/api","description":"Retrieves the ERC-20 token balance for a specified address at a given block height.","href":"/api-reference/endpoint/tokenbalancehistory"},{"title":"Get Top Token Holders","sidebarTitle":"Get Top Token Holders","tag":"PRO","openapi":"openapi/api-reference/endpoint/topholders.json GET /v2/api","href":"/api-reference/endpoint/topholders"},{"title":"Get Token Holder List by Contract Address","sidebarTitle":"Get Token Holder List by Contract Address","tag":"PRO","openapi":"openapi/api-reference/endpoint/tokenholderlist.json GET /v2/api","description":"Retrieves the current list of ERC-20 token holders and their token balances.","href":"/api-reference/endpoint/tokenholderlist"},{"title":"Get Token Holder Count by Contract Address","sidebarTitle":"Get Token Holder Count by Contract Address","tag":"PRO","openapi":"openapi/api-reference/endpoint/tokenholdercount.json GET /v2/api","href":"/api-reference/endpoint/tokenholdercount"},{"title":"Get Token Info by ContractAddress","sidebarTitle":"Get Token Info by ContractAddress","tag":"PRO","openapi":"openapi/api-reference/endpoint/tokeninfo.json GET /v2/api","href":"/api-reference/endpoint/tokeninfo"},{"title":"Get Address ERC20 Token Holding","sidebarTitle":"Get Address ERC20 Token Holding","tag":"PRO","openapi":"openapi/api-reference/endpoint/addresstokenbalance.json GET /v2/api","href":"/api-reference/endpoint/addresstokenbalance"},{"title":"Get Address ERC721 Token Holding","sidebarTitle":"Get Address ERC721 Token Holding","tag":"PRO","openapi":"openapi/api-reference/endpoint/addresstokennftbalance.json GET /v2/api","href":"/api-reference/endpoint/addresstokennftbalance"},{"title":"Get Address ERC721 Token Inventory by Contract","sidebarTitle":"Get Address ERC721 Token Inventory by Contract","tag":"PRO","openapi":"openapi/api-reference/endpoint/addresstokennftinventory.json GET /v2/api","href":"/api-reference/endpoint/addresstokennftinventory"}]},{"group":"L2 Deposits/Withdrawals","pages":[{"title":"Get Plasma Deposits by Address","openapi":"openapi/api-reference/endpoint/txnbridge.json GET /v2/api","href":"/api-reference/endpoint/txnbridge"},{"title":"Get Deposit Transactions by Address","openapi":"openapi/api-reference/endpoint/getdeposittxs.json GET /v2/api","href":"/api-reference/endpoint/getdeposittxs"},{"title":"Get Withdrawal Transactions by Address","openapi":"openapi/api-reference/endpoint/getwithdrawaltxs.json GET /v2/api","href":"/api-reference/endpoint/getwithdrawaltxs"}]},{"group":"ENS","pages":[{"title":"Resolve an ENS Name to an Address","openapi":"openapi/api-reference/endpoint/forwardresolve.json GET /v2/api","href":"/api-reference/endpoint/forwardresolve"}]},{"group":"Nametags","pages":[{"title":"Get Metadata for an Address","sidebarTitle":"Get Metadata for an Address","tag":"PRO+","openapi":"openapi/api-reference/endpoint/getaddresstag.json GET /v2/api","href":"/api-reference/endpoint/getaddresstag"}]},{"group":"Usage","pages":[{"title":"Get API Usage","openapi":"openapi/api-reference/endpoint/getapilimit.json GET /v2/api","href":"/api-reference/endpoint/getapilimit"},{"title":"Chainlist","openapi":"openapi/api-reference/endpoint/chainlist.json GET /v2/chainlist","href":"/api-reference/endpoint/chainlist"}]}]},{"group":"Beta Endpoints","pages":[{"title":"Prediction Market APIs","href":"/beta/prediction-market"}]}]},{"tab":"Etherscan Metadata","pages":[{"title":"Etherscan Metadata","href":"/metadata/introduction"}]},{"tab":"Changelog","pages":[{"title":"Changelog","href":"/changelog"}]}]},"title":"Get Top Token Holders - Etherscan","buildId":"dpl_DFJrtvUi8HS5F9nkooKuDJsuD5BM","deploymentId":"dpl_DFJrtvUi8HS5F9nkooKuDJsuD5BM","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a74be98ba7","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-rfhihCWU.js","utils-BmH1XFxk.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-BcNsxPKB.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-BAES3tkd.js","snippetPresets-DCMQBKLP.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-D6l_bzE9.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-BOktbnNh.js","shallow-BCs8SgM7.js","getApiPlaygroundDisplay-DEmW5bJB.js","CodeSnippet-CpZOpB9C.js","CodeSnippets-BOBDqibl.js","Page-D5fEM6aW.js","getPastedJson-DH2JBvmr.js","icon-BBJH-kKh.js","MethodPill-D2Sd5NLC.js","DuplicateIcon-CGgfL2qN.js","createIcon-BKudBBzi.js","DynamicMarkdown-85clUA0i.js","SectionHeading-D0JiMgDx.js","axios-vUo_bRtp.js","zoom-image-lightbox-BZxD9MAj.js","lightbox-handle-r17bVUz3.js","Markdown-Cfiy0xZO.js","clsx-rL8ZCCw4.js","lib--scc4DXi.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-aeztFa9U.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-BywkCr5C.js"]}