Send an API key, or a session token a key minted, as Authorization: Bearer <credential>. A browser opening /v1/stream offers its session token in Sec-WebSocket-Protocol instead.
Span the trading figures cover; lifetime when absent.
The span a holder row's trading figures cover: lifetime, every round trip, or cycle, the open one. lifetime when absent.
Available options:
cycle,
lifetime
Response
Current holders, largest balance first; an unknown token answers an empty list.
GET /v1/tokens/{chain}/{address}/holders response: current holders, largest balance first.
The token's own holder total, whatever the limit and any flags filter. It counts
trading wallets only, so it can run below a full listing that includes pool vaults.
Balance-weighted entry and exit prices across the first 10 holders; the filtered cohort
under flags.
Show child attributes
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Metastreams API","description":"Real-time and historical spot market data: tokens, OHLCV candles, trades, discovery boards and live streams.","colors":{"primary":"#2563EB","light":"#60A5FA","dark":"#1D4ED8"},"favicon":"https://mintcdn.com/metastreams-prod/JdlWV-spcCy8pt8j/favicon.svg?fit=max\u0026auto=format\u0026n=JdlWV-spcCy8pt8j\u0026q=85\u0026s=c7cd89b16d24d9370f0522e9a010f5af","contextual":{"options":["copy","view","chatgpt","claude","mcp","cursor","vscode"],"display":"header"},"styling":{"latex":true},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"metastreams-prod","hasAudioNarration":false,"actualSubdomain":"metastreams-prod","customDomains":["docs.metastreams.io"],"gitSource":{"type":"github","owner":"tradeonapex","repo":"metastreams-docs","deployBranch":"production","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"chroma":{"latestBuiltDeploymentHistoryId":"6ac3f33ac249ebd4bbff8158","collectionId":"b571c6d0-031d-41d2-a605-981f75eca985","liveDeploymentHistoryId":"6ac3f33ac249ebd4bbff8158","schemaVersion":"v3"},"entitlements":{},"buildId":"6ade50f9b128bc39b5e6911b","clientVersion":"0.0.3966","searchFilterCounts":[{"language":"default","tag":"Docs","count":16},{"language":"default","tag":"API reference","count":13},{"language":"default","tag":"REST","count":10},{"language":"default","tag":"Get started","count":4},{"language":"default","tag":"Streams","count":4},{"language":"default","tag":"Core concepts","count":3},{"language":"default","tag":"Recipes","count":3},{"language":"default","tag":"Resources","count":3},{"language":"default","tag":"Migration guides","count":2},{"language":"default","tag":"trades","count":2}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"hasChatPermissions":false,"hasWebMcpPermissions":false,"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":"billing-updated-9-15","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}],"isAtlas":false,"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"api-reference/tokens/a-tokens-current-holders-largest-balance-first-optionally-narrowed-to-wallet-classifications","slug":"/api-reference/tokens/a-tokens-current-holders-largest-balance-first-optionally-narrowed-to-wallet-classifications","pageMetadata":{"title":"A token's current holders, largest balance first, optionally narrowed to wallet classifications.","description":"Pools and lockers rank here and carry their flag. `holderCount` stays the token's total under\n`flags`.","deprecated":null,"version":null,"openapi":"/specs/openapi.json get /v1/tokens/{chain}/{address}/holders","href":"/api-reference/tokens/a-tokens-current-holders-largest-balance-first-optionally-narrowed-to-wallet-classifications","autogeneratedByOpenApi":true},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx, jsxs: _jsxs} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n code: \"code\",\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsxs(_components.p, {\n children: [\"Pools and lockers rank here and carry their flag. \", _jsx(_components.code, {\n children: \"holderCount\"\n }), \" stays the token’s total under\\n\", _jsx(_components.code, {\n children: \"flags\"\n }), \".\"]\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}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){return _jsx(_Fragment,{})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"A token's current holders, largest balance first, optionally narrowed to wallet classifications.","description":"Pools and lockers rank here and carry their flag. `holderCount` stays the token's total under\n`flags`.","deprecated":null,"version":null,"openapi":"/specs/openapi.json get /v1/tokens/{chain}/{address}/holders","href":"/api-reference/tokens/a-tokens-current-holders-largest-balance-first-optionally-narrowed-to-wallet-classifications","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"tags":["tokens"],"summary":"A token's current holders, largest balance first, optionally narrowed to wallet classifications.","description":"Pools and lockers rank here and carry their flag. `holderCount` stays the token's total under\n`flags`.","operationId":"token_holders","parameters":["2ab288cc-d832-4fcf-be5d-3517dcdbf75e","196d1f82-47b7-4669-b5f6-eaf832c90d5d","e5781df4-1ed8-408b-b8e8-229765c98eb8","143e66ea-bb16-4419-b298-85a1fb81f7fc","dfb2338e-3c76-4da4-944a-2618afd1969e","e14cf328-37cb-48a0-90ac-65be12d6a796"],"responses":{"200":"ef5566cc-4f19-4af2-baf5-dfb69c22cd3a","400":"d9c43b30-9f38-4217-8c86-8d089a2c7f02","401":"084081ee-2662-49b5-8a4b-e8aeec31dcec","402":"5c46f153-9f07-4dcc-b1e0-2dc1aad1ce17","403":"5143c47b-1fb6-4a74-a991-3b3ae0d23754","429":"66c2ac9c-b082-4d87-98ef-6d2cbc611470","500":"c23c4d99-5b46-483e-840c-6394dbaf3689","503":"cbe0cca1-48cf-4cd6-a88b-ac207b471d17"},"method":"get","type":"path","servers":["583dafd9-2e40-4bab-8b7e-b807c8f219de"],"security":["744ac6ae-8a74-4d87-a0bd-0a1d1cf62a38"],"path":"/v1/tokens/{chain}/{address}/holders","baseUrlOptions":["https://{host}"],"title":"A token's current holders, largest balance first, optionally narrowed to wallet classifications.","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"2ab288cc-d832-4fcf-be5d-3517dcdbf75e":{"name":"chain","in":"path","description":"Chain the resource lives on.","required":true,"schema":{"type":"string","description":"Chain the resource lives on.\nChain slug. One spelling per chain, in paths and bodies alike. Only a chain with spot data is published.","enum":["solana","base","bsc","robinhood","arc"],"isRequired":true,"uniqueKey":"","typeLabel":"enum\u003cstring>"}},"196d1f82-47b7-4669-b5f6-eaf832c90d5d":{"name":"address","in":"path","description":"Token mint or contract address.","required":true,"schema":{"type":"string","isRequired":true,"description":"Token mint or contract address.","uniqueKey":"","typeLabel":"string"},"example":"So11111111111111111111111111111111111111112"},"e5781df4-1ed8-408b-b8e8-229765c98eb8":{"name":"limit","in":"query","description":"Rows to return, clamped to 1-150; 30 when absent.","required":false,"schema":{"type":"integer","format":"int32","maximum":150,"minimum":1,"isRequired":false,"description":"Rows to return, clamped to 1-150; 30 when absent.","uniqueKey":"","typeLabel":"integer\u003cint32>"}},"143e66ea-bb16-4419-b298-85a1fb81f7fc":{"name":"trader","in":"query","description":"Restrict to one holder wallet.","required":false,"schema":{"type":"string","isRequired":false,"description":"Restrict to one holder wallet.","uniqueKey":"","typeLabel":"string"}},"dfb2338e-3c76-4da4-944a-2618afd1969e":{"name":"flags","in":"query","description":"Wallet classifications to keep, comma-separated. Absent or empty keeps every holder.","required":false,"schema":{"type":"string","isRequired":false,"description":"Wallet classifications to keep, comma-separated. Absent or empty keeps every holder.","uniqueKey":"","typeLabel":"string"},"example":"bundler,insider"},"e14cf328-37cb-48a0-90ac-65be12d6a796":{"name":"period","in":"query","description":"Span the trading figures cover; `lifetime` when absent.","required":false,"schema":{"type":"string","description":"Span the trading figures cover; `lifetime` when absent.\nThe span a holder row's trading figures cover: `lifetime`, every round trip, or `cycle`, the open one. `lifetime` when absent.","enum":["cycle","lifetime"],"isRequired":false,"uniqueKey":"","typeLabel":"enum\u003cstring>"}}},"responses":{"ef5566cc-4f19-4af2-baf5-dfb69c22cd3a":{"description":"Current holders, largest balance first; an unknown token answers an empty list.","headers":{"X-Credits-Cost":{"schema":{"type":"integer"},"description":"Credits charged for this request. Zero on any non-2xx. Sent on a metered tier only."},"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credit balance after this request. Sent on a metered tier only."},"X-RateLimit-Remaining":{"schema":{"type":"integer"},"description":"Requests left in the bucket this request spent from. Not sent with a 401."},"X-Request-ID":{"schema":{"type":"string"},"description":"This request's trace ID. Echoed from the request, or generated when it sent none."}},"content":{"application/json":{"schema":{"type":"object","description":"`GET /v1/tokens/{chain}/{address}/holders` response: current holders, largest balance first.","required":["holders","holderCount","top10"],"properties":{"holderCount":{"type":"integer","format":"int64","description":"The token's own holder total, whatever the `limit` and any `flags` filter. It counts\ntrading wallets only, so it can run below a full listing that includes pool vaults.","minimum":0,"isRequired":true,"uniqueKey":"holderCount","typeLabel":"integer\u003cint64>"},"holders":{"type":"array","items":{"type":"object","description":"One wallet's holding and trading figures on one token.\n\nVolumes, token totals, trade counts, entry and exit prices and realized PnL cover the read's\n`period`.","required":["address","balance","supplyPct","buyVolume","tokensBought","buyCount","sellVolume","tokensSold","sellCount","realizedPnl","remainingPct","funding"],"properties":{"address":{"type":"string","description":"Wallet address.","isRequired":true,"uniqueKey":"holders.items.[INDEX].address","typeLabel":"string"},"balance":{"type":"string","format":"decimal","description":"Token units the wallet holds now.","example":"123.456789","isRequired":true,"uniqueKey":"holders.items.[INDEX].balance","typeLabel":"string\u003cdecimal>"},"buyCount":{"type":"integer","format":"int32","description":"Buy trades over the period.","minimum":0,"isRequired":true,"uniqueKey":"holders.items.[INDEX].buyCount","typeLabel":"integer\u003cint32>"},"buyVolume":{"type":"object","description":"Spent buying this token over the period.","required":["native"],"properties":{"native":{"type":"string","format":"decimal","description":"Value in the owning chain's gas asset.","example":"123.456789","isRequired":true,"uniqueKey":"holders.items.[INDEX].buyVolume.native","typeLabel":"string\u003cdecimal>"},"usd":{"oneOf":[{"type":"null","description":"Value in USD; `null` when the native asset is unpriced.","uniqueKey":"holders.items.[INDEX].buyVolume.usd.oneOf.0","typeLabel":"null"},{"type":"string","description":"Value in USD; `null` when the native asset is unpriced.","format":"decimal","example":"123.456789","uniqueKey":"holders.items.[INDEX].buyVolume.usd.oneOf.1","typeLabel":"string\u003cdecimal>"}],"uniqueKey":"holders.items.[INDEX].buyVolume.usd","typeLabel":"null | string\u003cdecimal>"}},"isRequired":true,"uniqueKey":"holders.items.[INDEX].buyVolume","typeLabel":"object"},"funding":{"type":"object","description":"The wallet's first inbound funding. Always present; its status says whether the lookup\nhas settled.","required":["status"],"properties":{"status":{"type":"string","description":"Whether the lookup has settled.","enum":["unresolved","resolved"],"isRequired":true,"uniqueKey":"holders.items.[INDEX].funding.status","typeLabel":"enum\u003cstring>"},"address":{"oneOf":[{"type":"string","description":"Funder wallet or exchange address.","uniqueKey":"holders.items.[INDEX].funding.address.oneOf.0","typeLabel":"string"},{"type":"null","description":"Funder wallet or exchange address.","uniqueKey":"holders.items.[INDEX].funding.address.oneOf.1","typeLabel":"null"}],"uniqueKey":"holders.items.[INDEX].funding.address","typeLabel":"string | null"},"amount":{"oneOf":[{"type":"null","description":"Amount received, denominated in `asset`.","uniqueKey":"holders.items.[INDEX].funding.amount.oneOf.0","typeLabel":"null"},{"type":"string","description":"Amount received, denominated in `asset`.","format":"decimal","example":"123.456789","uniqueKey":"holders.items.[INDEX].funding.amount.oneOf.1","typeLabel":"string\u003cdecimal>"}],"uniqueKey":"holders.items.[INDEX].funding.amount","typeLabel":"null | string\u003cdecimal>"},"asset":{"oneOf":[{"type":"string","description":"Asset the funding moved; `null` for the chain's native asset.","uniqueKey":"holders.items.[INDEX].funding.asset.oneOf.0","typeLabel":"string"},{"type":"null","description":"Asset the funding moved; `null` for the chain's native asset.","uniqueKey":"holders.items.[INDEX].funding.asset.oneOf.1","typeLabel":"null"}],"uniqueKey":"holders.items.[INDEX].funding.asset","typeLabel":"string | null"},"sourceKind":{"oneOf":[{"type":"null","description":"What the funder is (exchange, bridge, wallet, …).","uniqueKey":"holders.items.[INDEX].funding.sourceKind.oneOf.0","typeLabel":"null"},{"type":"string","description":"What the funder is (exchange, bridge, wallet, …).","enum":["cex","wallet"],"uniqueKey":"holders.items.[INDEX].funding.sourceKind.oneOf.1","typeLabel":"enum\u003cstring>"}],"uniqueKey":"holders.items.[INDEX].funding.sourceKind","typeLabel":"null | enum\u003cstring>"},"sourceLabel":{"oneOf":[{"type":"string","description":"Display label for the funder, e.g. an exchange name.","uniqueKey":"holders.items.[INDEX].funding.sourceLabel.oneOf.0","typeLabel":"string"},{"type":"null","description":"Display label for the funder, e.g. an exchange name.","uniqueKey":"holders.items.[INDEX].funding.sourceLabel.oneOf.1","typeLabel":"null"}],"uniqueKey":"holders.items.[INDEX].funding.sourceLabel","typeLabel":"string | null"},"symbol":{"oneOf":[{"type":"string","description":"Display ticker of `asset`.","uniqueKey":"holders.items.[INDEX].funding.symbol.oneOf.0","typeLabel":"string"},{"type":"null","description":"Display ticker of `asset`.","uniqueKey":"holders.items.[INDEX].funding.symbol.oneOf.1","typeLabel":"null"}],"uniqueKey":"holders.items.[INDEX].funding.symbol","typeLabel":"string | null"},"timestamp":{"oneOf":[{"type":"null","description":"When the funding transfer occurred.","uniqueKey":"holders.items.[INDEX].funding.timestamp.oneOf.0","typeLabel":"null"},{"type":"integer","description":"When the funding transfer occurred.","format":"int64","uniqueKey":"holders.items.[INDEX].funding.timestamp.oneOf.1","typeLabel":"integer\u003cint64>"}],"uniqueKey":"holders.items.[INDEX].funding.timestamp","typeLabel":"null | integer\u003cint64>"},"tx":{"oneOf":[{"type":"string","description":"The funding transaction's signature or hash.","uniqueKey":"holders.items.[INDEX].funding.tx.oneOf.0","typeLabel":"string"},{"type":"null","description":"The funding transaction's signature or hash.","uniqueKey":"holders.items.[INDEX].funding.tx.oneOf.1","typeLabel":"null"}],"uniqueKey":"holders.items.[INDEX].funding.tx","typeLabel":"string | null"}},"isRequired":true,"uniqueKey":"holders.items.[INDEX].funding","typeLabel":"object"},"realizedPnl":{"type":"object","description":"Profit or loss the wallet locked in by selling over the period.","required":["native"],"properties":{"native":{"type":"string","format":"decimal","description":"Value in the owning chain's gas asset.","example":"123.456789","isRequired":true,"uniqueKey":"holders.items.[INDEX].realizedPnl.native","typeLabel":"string\u003cdecimal>"},"usd":{"oneOf":[{"type":"null","description":"Value in USD; `null` when the native asset is unpriced.","uniqueKey":"holders.items.[INDEX].realizedPnl.usd.oneOf.0","typeLabel":"null"},{"type":"string","description":"Value in USD; `null` when the native asset is unpriced.","format":"decimal","example":"123.456789","uniqueKey":"holders.items.[INDEX].realizedPnl.usd.oneOf.1","typeLabel":"string\u003cdecimal>"}],"uniqueKey":"holders.items.[INDEX].realizedPnl.usd","typeLabel":"null | string\u003cdecimal>"}},"isRequired":true,"uniqueKey":"holders.items.[INDEX].realizedPnl","typeLabel":"object"},"remainingPct":{"type":"string","format":"decimal","description":"Share of its peak holdings the wallet still holds, 0-100.","example":"123.456789","isRequired":true,"uniqueKey":"holders.items.[INDEX].remainingPct","typeLabel":"string\u003cdecimal>"},"sellCount":{"type":"integer","format":"int32","description":"Sell trades over the period.","minimum":0,"isRequired":true,"uniqueKey":"holders.items.[INDEX].sellCount","typeLabel":"integer\u003cint32>"},"sellVolume":{"type":"object","description":"Received from selling this token over the period.","required":["native"],"properties":{"native":{"type":"string","format":"decimal","description":"Value in the owning chain's gas asset.","example":"123.456789","isRequired":true,"uniqueKey":"holders.items.[INDEX].sellVolume.native","typeLabel":"string\u003cdecimal>"},"usd":{"oneOf":[{"type":"null","description":"Value in USD; `null` when the native asset is unpriced.","uniqueKey":"holders.items.[INDEX].sellVolume.usd.oneOf.0","typeLabel":"null"},{"type":"string","description":"Value in USD; `null` when the native asset is unpriced.","format":"decimal","example":"123.456789","uniqueKey":"holders.items.[INDEX].sellVolume.usd.oneOf.1","typeLabel":"string\u003cdecimal>"}],"uniqueKey":"holders.items.[INDEX].sellVolume.usd","typeLabel":"null | string\u003cdecimal>"}},"isRequired":true,"uniqueKey":"holders.items.[INDEX].sellVolume","typeLabel":"object"},"supplyPct":{"type":"string","format":"decimal","description":"Share of total supply the wallet holds, 0-100.","example":"123.456789","isRequired":true,"uniqueKey":"holders.items.[INDEX].supplyPct","typeLabel":"string\u003cdecimal>"},"tokensBought":{"type":"string","format":"decimal","description":"Token units bought over the period, including any sold since.","example":"123.456789","isRequired":true,"uniqueKey":"holders.items.[INDEX].tokensBought","typeLabel":"string\u003cdecimal>"},"tokensSold":{"type":"string","format":"decimal","description":"Token units sold over the period.","example":"123.456789","isRequired":true,"uniqueKey":"holders.items.[INDEX].tokensSold","typeLabel":"string\u003cdecimal>"},"avgEntryMarketCap":{"oneOf":[{"type":"null","description":"Size-weighted market cap across the wallet's buys; `null` when none was recorded.","uniqueKey":"holders.items.[INDEX].avgEntryMarketCap.oneOf.0","typeLabel":"null"},{"type":"object","description":"Size-weighted market cap across the wallet's buys; `null` when none was recorded.","required":["native"],"properties":{"native":{"type":"string","format":"decimal","description":"Value in the owning chain's gas asset.","example":"123.456789","isRequired":true,"uniqueKey":"holders.items.[INDEX].avgEntryMarketCap.oneOf.1.native","typeLabel":"string\u003cdecimal>"},"usd":{"oneOf":[{"type":"null","description":"Value in USD; `null` when the native asset is unpriced.","uniqueKey":"holders.items.[INDEX].avgEntryMarketCap.oneOf.1.usd.oneOf.0","typeLabel":"null"},{"type":"string","description":"Value in USD; `null` when the native asset is unpriced.","format":"decimal","example":"123.456789","uniqueKey":"holders.items.[INDEX].avgEntryMarketCap.oneOf.1.usd.oneOf.1","typeLabel":"string\u003cdecimal>"}],"uniqueKey":"holders.items.[INDEX].avgEntryMarketCap.oneOf.1.usd","typeLabel":"null | string\u003cdecimal>"}},"uniqueKey":"holders.items.[INDEX].avgEntryMarketCap.oneOf.1","typeLabel":"object"}],"uniqueKey":"holders.items.[INDEX].avgEntryMarketCap","typeLabel":"null | object"},"avgEntryPrice":{"oneOf":[{"type":"null","description":"Entry price per token over the period; `null` before the period's first buy. `cycle`\nreads the open position's cost basis, and `lifetime` averages every buy.","uniqueKey":"holders.items.[INDEX].avgEntryPrice.oneOf.0","typeLabel":"null"},{"type":"object","description":"Entry price per token over the period; `null` before the period's first buy. `cycle`\nreads the open position's cost basis, and `lifetime` averages every buy.","required":["native"],"properties":{"native":{"type":"string","format":"decimal","description":"Value in the owning chain's gas asset.","example":"123.456789","isRequired":true,"uniqueKey":"holders.items.[INDEX].avgEntryPrice.oneOf.1.native","typeLabel":"string\u003cdecimal>"},"usd":{"oneOf":[{"type":"null","description":"Value in USD; `null` when the native asset is unpriced.","uniqueKey":"holders.items.[INDEX].avgEntryPrice.oneOf.1.usd.oneOf.0","typeLabel":"null"},{"type":"string","description":"Value in USD; `null` when the native asset is unpriced.","format":"decimal","example":"123.456789","uniqueKey":"holders.items.[INDEX].avgEntryPrice.oneOf.1.usd.oneOf.1","typeLabel":"string\u003cdecimal>"}],"uniqueKey":"holders.items.[INDEX].avgEntryPrice.oneOf.1.usd","typeLabel":"null | string\u003cdecimal>"}},"uniqueKey":"holders.items.[INDEX].avgEntryPrice.oneOf.1","typeLabel":"object"}],"uniqueKey":"holders.items.[INDEX].avgEntryPrice","typeLabel":"null | object"},"avgExitMarketCap":{"oneOf":[{"type":"null","description":"Size-weighted market cap across the wallet's sells; `null` when none was recorded.","uniqueKey":"holders.items.[INDEX].avgExitMarketCap.oneOf.0","typeLabel":"null"},{"type":"object","description":"Size-weighted market cap across the wallet's sells; `null` when none was recorded.","required":["native"],"properties":{"native":{"type":"string","format":"decimal","description":"Value in the owning chain's gas asset.","example":"123.456789","isRequired":true,"uniqueKey":"holders.items.[INDEX].avgExitMarketCap.oneOf.1.native","typeLabel":"string\u003cdecimal>"},"usd":{"oneOf":[{"type":"null","description":"Value in USD; `null` when the native asset is unpriced.","uniqueKey":"holders.items.[INDEX].avgExitMarketCap.oneOf.1.usd.oneOf.0","typeLabel":"null"},{"type":"string","description":"Value in USD; `null` when the native asset is unpriced.","format":"decimal","example":"123.456789","uniqueKey":"holders.items.[INDEX].avgExitMarketCap.oneOf.1.usd.oneOf.1","typeLabel":"string\u003cdecimal>"}],"uniqueKey":"holders.items.[INDEX].avgExitMarketCap.oneOf.1.usd","typeLabel":"null | string\u003cdecimal>"}},"uniqueKey":"holders.items.[INDEX].avgExitMarketCap.oneOf.1","typeLabel":"object"}],"uniqueKey":"holders.items.[INDEX].avgExitMarketCap","typeLabel":"null | object"},"avgExitPrice":{"oneOf":[{"type":"null","description":"Volume-weighted exit price over the period; `null` until the wallet sells in it.","uniqueKey":"holders.items.[INDEX].avgExitPrice.oneOf.0","typeLabel":"null"},{"type":"object","description":"Volume-weighted exit price over the period; `null` until the wallet sells in it.","required":["native"],"properties":{"native":{"type":"string","format":"decimal","description":"Value in the owning chain's gas asset.","example":"123.456789","isRequired":true,"uniqueKey":"holders.items.[INDEX].avgExitPrice.oneOf.1.native","typeLabel":"string\u003cdecimal>"},"usd":{"oneOf":[{"type":"null","description":"Value in USD; `null` when the native asset is unpriced.","uniqueKey":"holders.items.[INDEX].avgExitPrice.oneOf.1.usd.oneOf.0","typeLabel":"null"},{"type":"string","description":"Value in USD; `null` when the native asset is unpriced.","format":"decimal","example":"123.456789","uniqueKey":"holders.items.[INDEX].avgExitPrice.oneOf.1.usd.oneOf.1","typeLabel":"string\u003cdecimal>"}],"uniqueKey":"holders.items.[INDEX].avgExitPrice.oneOf.1.usd","typeLabel":"null | string\u003cdecimal>"}},"uniqueKey":"holders.items.[INDEX].avgExitPrice.oneOf.1","typeLabel":"object"}],"uniqueKey":"holders.items.[INDEX].avgExitPrice","typeLabel":"null | object"},"firstPurchaseAt":{"oneOf":[{"type":"null","description":"The wallet's first buy of this token; `null` for a wallet that only received transfers.","uniqueKey":"holders.items.[INDEX].firstPurchaseAt.oneOf.0","typeLabel":"null"},{"type":"integer","description":"The wallet's first buy of this token; `null` for a wallet that only received transfers.","format":"int64","uniqueKey":"holders.items.[INDEX].firstPurchaseAt.oneOf.1","typeLabel":"integer\u003cint64>"}],"uniqueKey":"holders.items.[INDEX].firstPurchaseAt","typeLabel":"null | integer\u003cint64>"},"flags":{"type":"array","items":{"type":"string","description":"A flag the classifier put on the wallet. This is an open enumeration: the classifier learns new flags, so keep a value you do not recognize.","examples":["bundler","sniper","insider","dev","fresh","whale","kol","liquidity_pool","locker","pro_trader","system","fomo","phishing"],"uniqueKey":"holders.items.[INDEX].flags.items.[INDEX]","typeLabel":"string"},"description":"Classifications the wallet carries.","uniqueKey":"holders.items.[INDEX].flags","typeLabel":"string[]"},"identities":{"type":"array","items":{"type":"object","description":"One source's resolved profile for a trade's trader.","required":["source"],"properties":{"source":{"type":"string","description":"Who resolved this identity.","enum":["codex","fomo","pump","gmgn","axiom","unknown"],"isRequired":true,"uniqueKey":"holders.items.[INDEX].identities.items.[INDEX].source","typeLabel":"enum\u003cstring>"},"avatar":{"oneOf":[{"type":"string","description":"CDN URL of the avatar to render; `null` until the picture is mirrored.","uniqueKey":"holders.items.[INDEX].identities.items.[INDEX].avatar.oneOf.0","typeLabel":"string"},{"type":"null","description":"CDN URL of the avatar to render; `null` until the picture is mirrored.","uniqueKey":"holders.items.[INDEX].identities.items.[INDEX].avatar.oneOf.1","typeLabel":"null"}],"uniqueKey":"holders.items.[INDEX].identities.items.[INDEX].avatar","typeLabel":"string | null"},"displayName":{"oneOf":[{"type":"string","description":"Human-readable name to render.","uniqueKey":"holders.items.[INDEX].identities.items.[INDEX].displayName.oneOf.0","typeLabel":"string"},{"type":"null","description":"Human-readable name to render.","uniqueKey":"holders.items.[INDEX].identities.items.[INDEX].displayName.oneOf.1","typeLabel":"null"}],"uniqueKey":"holders.items.[INDEX].identities.items.[INDEX].displayName","typeLabel":"string | null"},"farcaster":{"oneOf":[{"type":"string","description":"The wallet's Farcaster handle, where the source links one.","uniqueKey":"holders.items.[INDEX].identities.items.[INDEX].farcaster.oneOf.0","typeLabel":"string"},{"type":"null","description":"The wallet's Farcaster handle, where the source links one.","uniqueKey":"holders.items.[INDEX].identities.items.[INDEX].farcaster.oneOf.1","typeLabel":"null"}],"uniqueKey":"holders.items.[INDEX].identities.items.[INDEX].farcaster","typeLabel":"string | null"},"handle":{"oneOf":[{"type":"string","description":"The wallet's handle on the source.","uniqueKey":"holders.items.[INDEX].identities.items.[INDEX].handle.oneOf.0","typeLabel":"string"},{"type":"null","description":"The wallet's handle on the source.","uniqueKey":"holders.items.[INDEX].identities.items.[INDEX].handle.oneOf.1","typeLabel":"null"}],"uniqueKey":"holders.items.[INDEX].identities.items.[INDEX].handle","typeLabel":"string | null"},"telegram":{"oneOf":[{"type":"string","description":"The wallet's Telegram handle, where the source links one.","uniqueKey":"holders.items.[INDEX].identities.items.[INDEX].telegram.oneOf.0","typeLabel":"string"},{"type":"null","description":"The wallet's Telegram handle, where the source links one.","uniqueKey":"holders.items.[INDEX].identities.items.[INDEX].telegram.oneOf.1","typeLabel":"null"}],"uniqueKey":"holders.items.[INDEX].identities.items.[INDEX].telegram","typeLabel":"string | null"},"twitter":{"oneOf":[{"type":"string","description":"The wallet's bare X handle, where the source links one.","uniqueKey":"holders.items.[INDEX].identities.items.[INDEX].twitter.oneOf.0","typeLabel":"string"},{"type":"null","description":"The wallet's bare X handle, where the source links one.","uniqueKey":"holders.items.[INDEX].identities.items.[INDEX].twitter.oneOf.1","typeLabel":"null"}],"uniqueKey":"holders.items.[INDEX].identities.items.[INDEX].twitter","typeLabel":"string | null"}},"uniqueKey":"holders.items.[INDEX].identities.items.[INDEX]","typeLabel":"object"},"description":"The wallet's resolved identities, one element per source.","uniqueKey":"holders.items.[INDEX].identities","typeLabel":"object[]"},"nativeBalance":{"oneOf":[{"type":"null","description":"The wallet's balance of the chain's native asset; `null` until the chain reports one.","uniqueKey":"holders.items.[INDEX].nativeBalance.oneOf.0","typeLabel":"null"},{"type":"string","description":"The wallet's balance of the chain's native asset; `null` until the chain reports one.","format":"decimal","example":"123.456789","uniqueKey":"holders.items.[INDEX].nativeBalance.oneOf.1","typeLabel":"string\u003cdecimal>"}],"uniqueKey":"holders.items.[INDEX].nativeBalance","typeLabel":"null | string\u003cdecimal>"},"platforms":{"type":"array","items":{"oneOf":[{"type":"object","description":"A platform attached to a token, a wallet, or a trade.\n\nThe fieldless variants are trading terminals, each described by its display name.","required":["platform"],"properties":{"platform":{"type":"string","description":"Which platform this is.","enum":["fomo"],"isRequired":true,"uniqueKey":"holders.items.[INDEX].platforms.items.[INDEX].oneOf.0.platform","typeLabel":"enum\u003cstring>"}},"uniqueKey":"holders.items.[INDEX].platforms.items.[INDEX].oneOf.0","typeLabel":"object"},{"type":"object","description":"A platform attached to a token, a wallet, or a trade.\n\nThe fieldless variants are trading terminals, each described by its display name.","required":["isPaid","platform"],"properties":{"isPaid":{"type":"boolean","description":"Whether the token's DexScreener profile is paid.","isRequired":true,"uniqueKey":"holders.items.[INDEX].platforms.items.[INDEX].oneOf.1.isPaid","typeLabel":"boolean"},"platform":{"type":"string","description":"Which platform this is.","enum":["dexScreener"],"isRequired":true,"uniqueKey":"holders.items.[INDEX].platforms.items.[INDEX].oneOf.1.platform","typeLabel":"enum\u003cstring>"},"paidAt":{"oneOf":[{"type":"null","description":"Earliest profile payment time.","uniqueKey":"holders.items.[INDEX].platforms.items.[INDEX].oneOf.1.paidAt.oneOf.0","typeLabel":"null"},{"type":"integer","description":"Earliest profile payment time.","format":"int64","uniqueKey":"holders.items.[INDEX].platforms.items.[INDEX].oneOf.1.paidAt.oneOf.1","typeLabel":"integer\u003cint64>"}],"uniqueKey":"holders.items.[INDEX].platforms.items.[INDEX].oneOf.1.paidAt","typeLabel":"null | integer\u003cint64>"}},"uniqueKey":"holders.items.[INDEX].platforms.items.[INDEX].oneOf.1","typeLabel":"object"},{"type":"object","description":"A platform attached to a token, a wallet, or a trade.\n\nThe fieldless variants are trading terminals, each described by its display name.","required":["platform"],"properties":{"platform":{"type":"string","description":"Which platform this is.","enum":["axiom"],"isRequired":true,"uniqueKey":"holders.items.[INDEX].platforms.items.[INDEX].oneOf.2.platform","typeLabel":"enum\u003cstring>"}},"uniqueKey":"holders.items.[INDEX].platforms.items.[INDEX].oneOf.2","typeLabel":"object"},{"type":"object","description":"A platform attached to a token, a wallet, or a trade.\n\nThe fieldless variants are trading terminals, each described by its display name.","required":["platform"],"properties":{"platform":{"type":"string","description":"Which platform this is.","enum":["bananaGun"],"isRequired":true,"uniqueKey":"holders.items.[INDEX].platforms.items.[INDEX].oneOf.3.platform","typeLabel":"enum\u003cstring>"}},"uniqueKey":"holders.items.[INDEX].platforms.items.[INDEX].oneOf.3","typeLabel":"object"},{"type":"object","description":"A platform attached to a token, a wallet, or a trade.\n\nThe fieldless variants are trading terminals, each described by its display name.","required":["platform"],"properties":{"platform":{"type":"string","description":"Which platform this is.","enum":["bloom"],"isRequired":true,"uniqueKey":"holders.items.[INDEX].platforms.items.[INDEX].oneOf.4.platform","typeLabel":"enum\u003cstring>"}},"uniqueKey":"holders.items.[INDEX].platforms.items.[INDEX].oneOf.4","typeLabel":"object"},{"type":"object","description":"A platform attached to a token, a wallet, or a trade.\n\nThe fieldless variants are trading terminals, each described by its display name.","required":["platform"],"properties":{"platform":{"type":"string","description":"Which platform this is.","enum":["bonkbot"],"isRequired":true,"uniqueKey":"holders.items.[INDEX].platforms.items.[INDEX].oneOf.5.platform","typeLabel":"enum\u003cstring>"}},"uniqueKey":"holders.items.[INDEX].platforms.items.[INDEX].oneOf.5","typeLabel":"object"},{"type":"object","description":"A platform attached to a token, a wallet, or a trade.\n\nThe fieldless variants are trading terminals, each described by its display name.","required":["platform"],"properties":{"platform":{"type":"string","description":"Which platform this is.","enum":["btcTurk"],"isRequired":true,"uniqueKey":"holders.items.[INDEX].platforms.items.[INDEX].oneOf.6.platform","typeLabel":"enum\u003cstring>"}},"uniqueKey":"holders.items.[INDEX].platforms.items.[INDEX].oneOf.6","typeLabel":"object"},{"type":"object","description":"A platform attached to a token, a wallet, or a trade.\n\nThe fieldless variants are trading terminals, each described by its display name.","required":["platform"],"properties":{"platform":{"type":"string","description":"Which platform this is.","enum":["bullX"],"isRequired":true,"uniqueKey":"holders.items.[INDEX].platforms.items.[INDEX].oneOf.7.platform","typeLabel":"enum\u003cstring>"}},"uniqueKey":"holders.items.[INDEX].platforms.items.[INDEX].oneOf.7","typeLabel":"object"},{"type":"object","description":"A platform attached to a token, a wallet, or a trade.\n\nThe fieldless variants are trading terminals, each described by its display name.","required":["platform"],"properties":{"platform":{"type":"string","description":"Which platform this is.","enum":["click"],"isRequired":true,"uniqueKey":"holders.items.[INDEX].platforms.items.[INDEX].oneOf.8.platform","typeLabel":"enum\u003cstring>"}},"uniqueKey":"holders.items.[INDEX].platforms.items.[INDEX].oneOf.8","typeLabel":"object"},{"type":"object","description":"A platform attached to a token, a wallet, or a trade.\n\nThe fieldless variants are trading terminals, each described by its display name.","required":["platform"],"properties":{"platform":{"type":"string","description":"Which platform this is.","enum":["gmgn"],"isRequired":true,"uniqueKey":"holders.items.[INDEX].platforms.items.[INDEX].oneOf.9.platform","typeLabel":"enum\u003cstring>"}},"uniqueKey":"holders.items.[INDEX].platforms.items.[INDEX].oneOf.9","typeLabel":"object"},{"type":"object","description":"A platform attached to a token, a wallet, or a trade.\n\nThe fieldless variants are trading terminals, each described by its display name.","required":["platform"],"properties":{"platform":{"type":"string","description":"Which platform this is.","enum":["luckyBlock"],"isRequired":true,"uniqueKey":"holders.items.[INDEX].platforms.items.[INDEX].oneOf.10.platform","typeLabel":"enum\u003cstring>"}},"uniqueKey":"holders.items.[INDEX].platforms.items.[INDEX].oneOf.10","typeLabel":"object"},{"type":"object","description":"A platform attached to a token, a wallet, or a trade.\n\nThe fieldless variants are trading terminals, each described by its display name.","required":["platform"],"properties":{"platform":{"type":"string","description":"Which platform this is.","enum":["maestro"],"isRequired":true,"uniqueKey":"holders.items.[INDEX].platforms.items.[INDEX].oneOf.11.platform","typeLabel":"enum\u003cstring>"}},"uniqueKey":"holders.items.[INDEX].platforms.items.[INDEX].oneOf.11","typeLabel":"object"},{"type":"object","description":"A platform attached to a token, a wallet, or a trade.\n\nThe fieldless variants are trading terminals, each described by its display name.","required":["platform"],"properties":{"platform":{"type":"string","description":"Which platform this is.","enum":["manifoldTrading"],"isRequired":true,"uniqueKey":"holders.items.[INDEX].platforms.items.[INDEX].oneOf.12.platform","typeLabel":"enum\u003cstring>"}},"uniqueKey":"holders.items.[INDEX].platforms.items.[INDEX].oneOf.12","typeLabel":"object"},{"type":"object","description":"A platform attached to a token, a wallet, or a trade.\n\nThe fieldless variants are trading terminals, each described by its display name.","required":["platform"],"properties":{"platform":{"type":"string","description":"Which platform this is.","enum":["mevx"],"isRequired":true,"uniqueKey":"holders.items.[INDEX].platforms.items.[INDEX].oneOf.13.platform","typeLabel":"enum\u003cstring>"}},"uniqueKey":"holders.items.[INDEX].platforms.items.[INDEX].oneOf.13","typeLabel":"object"},{"type":"object","description":"A platform attached to a token, a wallet, or a trade.\n\nThe fieldless variants are trading terminals, each described by its display name.","required":["platform"],"properties":{"platform":{"type":"string","description":"Which platform this is.","enum":["mintech"],"isRequired":true,"uniqueKey":"holders.items.[INDEX].platforms.items.[INDEX].oneOf.14.platform","typeLabel":"enum\u003cstring>"}},"uniqueKey":"holders.items.[INDEX].platforms.items.[INDEX].oneOf.14","typeLabel":"object"},{"type":"object","description":"A platform attached to a token, a wallet, or a trade.\n\nThe fieldless variants are trading terminals, each described by its display name.","required":["platform"],"properties":{"platform":{"type":"string","description":"Which platform this is.","enum":["nighthawk"],"isRequired":true,"uniqueKey":"holders.items.[INDEX].platforms.items.[INDEX].oneOf.15.platform","typeLabel":"enum\u003cstring>"}},"uniqueKey":"holders.items.[INDEX].platforms.items.[INDEX].oneOf.15","typeLabel":"object"},{"type":"object","description":"A platform attached to a token, a wallet, or a trade.\n\nThe fieldless variants are trading terminals, each described by its display name.","required":["platform"],"properties":{"platform":{"type":"string","description":"Which platform this is.","enum":["nova"],"isRequired":true,"uniqueKey":"holders.items.[INDEX].platforms.items.[INDEX].oneOf.16.platform","typeLabel":"enum\u003cstring>"}},"uniqueKey":"holders.items.[INDEX].platforms.items.[INDEX].oneOf.16","typeLabel":"object"},{"type":"object","description":"A platform attached to a token, a wallet, or a trade.\n\nThe fieldless variants are trading terminals, each described by its display name.","required":["platform"],"properties":{"platform":{"type":"string","description":"Which platform this is.","enum":["oxFun"],"isRequired":true,"uniqueKey":"holders.items.[INDEX].platforms.items.[INDEX].oneOf.17.platform","typeLabel":"enum\u003cstring>"}},"uniqueKey":"holders.items.[INDEX].platforms.items.[INDEX].oneOf.17","typeLabel":"object"},{"type":"object","description":"A platform attached to a token, a wallet, or a trade.\n\nThe fieldless variants are trading terminals, each described by its display name.","required":["platform"],"properties":{"platform":{"type":"string","description":"Which platform this is.","enum":["padre"],"isRequired":true,"uniqueKey":"holders.items.[INDEX].platforms.items.[INDEX].oneOf.18.platform","typeLabel":"enum\u003cstring>"}},"uniqueKey":"holders.items.[INDEX].platforms.items.[INDEX].oneOf.18","typeLabel":"object"},{"type":"object","description":"A platform attached to a token, a wallet, or a trade.\n\nThe fieldless variants are trading terminals, each described by its display name.","required":["platform"],"properties":{"platform":{"type":"string","description":"Which platform this is.","enum":["pepeBoost"],"isRequired":true,"uniqueKey":"holders.items.[INDEX].platforms.items.[INDEX].oneOf.19.platform","typeLabel":"enum\u003cstring>"}},"uniqueKey":"holders.items.[INDEX].platforms.items.[INDEX].oneOf.19","typeLabel":"object"},{"type":"object","description":"A platform attached to a token, a wallet, or a trade.\n\nThe fieldless variants are trading terminals, each described by its display name.","required":["platform"],"properties":{"platform":{"type":"string","description":"Which platform this is.","enum":["phantom"],"isRequired":true,"uniqueKey":"holders.items.[INDEX].platforms.items.[INDEX].oneOf.20.platform","typeLabel":"enum\u003cstring>"}},"uniqueKey":"holders.items.[INDEX].platforms.items.[INDEX].oneOf.20","typeLabel":"object"},{"type":"object","description":"A platform attached to a token, a wallet, or a trade.\n\nThe fieldless variants are trading terminals, each described by its display name.","required":["platform"],"properties":{"platform":{"type":"string","description":"Which platform this is.","enum":["photon"],"isRequired":true,"uniqueKey":"holders.items.[INDEX].platforms.items.[INDEX].oneOf.21.platform","typeLabel":"enum\u003cstring>"}},"uniqueKey":"holders.items.[INDEX].platforms.items.[INDEX].oneOf.21","typeLabel":"object"},{"type":"object","description":"A platform attached to a token, a wallet, or a trade.\n\nThe fieldless variants are trading terminals, each described by its display name.","required":["platform"],"properties":{"platform":{"type":"string","description":"Which platform this is.","enum":["sexBotSolana"],"isRequired":true,"uniqueKey":"holders.items.[INDEX].platforms.items.[INDEX].oneOf.22.platform","typeLabel":"enum\u003cstring>"}},"uniqueKey":"holders.items.[INDEX].platforms.items.[INDEX].oneOf.22","typeLabel":"object"},{"type":"object","description":"A platform attached to a token, a wallet, or a trade.\n\nThe fieldless variants are trading terminals, each described by its display name.","required":["platform"],"properties":{"platform":{"type":"string","description":"Which platform this is.","enum":["shuriken"],"isRequired":true,"uniqueKey":"holders.items.[INDEX].platforms.items.[INDEX].oneOf.23.platform","typeLabel":"enum\u003cstring>"}},"uniqueKey":"holders.items.[INDEX].platforms.items.[INDEX].oneOf.23","typeLabel":"object"},{"type":"object","description":"A platform attached to a token, a wallet, or a trade.\n\nThe fieldless variants are trading terminals, each described by its display name.","required":["platform"],"properties":{"platform":{"type":"string","description":"Which platform this is.","enum":["solSniperBot"],"isRequired":true,"uniqueKey":"holders.items.[INDEX].platforms.items.[INDEX].oneOf.24.platform","typeLabel":"enum\u003cstring>"}},"uniqueKey":"holders.items.[INDEX].platforms.items.[INDEX].oneOf.24","typeLabel":"object"},{"type":"object","description":"A platform attached to a token, a wallet, or a trade.\n\nThe fieldless variants are trading terminals, each described by its display name.","required":["platform"],"properties":{"platform":{"type":"string","description":"Which platform this is.","enum":["solTradingBot"],"isRequired":true,"uniqueKey":"holders.items.[INDEX].platforms.items.[INDEX].oneOf.25.platform","typeLabel":"enum\u003cstring>"}},"uniqueKey":"holders.items.[INDEX].platforms.items.[INDEX].oneOf.25","typeLabel":"object"},{"type":"object","description":"A platform attached to a token, a wallet, or a trade.\n\nThe fieldless variants are trading terminals, each described by its display name.","required":["platform"],"properties":{"platform":{"type":"string","description":"Which platform this is.","enum":["trojan"],"isRequired":true,"uniqueKey":"holders.items.[INDEX].platforms.items.[INDEX].oneOf.26.platform","typeLabel":"enum\u003cstring>"}},"uniqueKey":"holders.items.[INDEX].platforms.items.[INDEX].oneOf.26","typeLabel":"object"}],"uniqueKey":"holders.items.[INDEX].platforms.items.[INDEX]","typeLabel":"object"},"description":"The wallet's trading-platform identities.","uniqueKey":"holders.items.[INDEX].platforms","typeLabel":"object[]"},"rank":{"oneOf":[{"type":"integer","format":"int64","description":"1-based rank in the requested ordering; a `flags` filter ranks within the filtered\ncohort. Absent on live `spot.holders` updates.","minimum":0,"uniqueKey":"holders.items.[INDEX].rank.oneOf.0","typeLabel":"integer\u003cint64>"},{"type":"null","format":"int64","description":"1-based rank in the requested ordering; a `flags` filter ranks within the filtered\ncohort. Absent on live `spot.holders` updates.","minimum":0,"uniqueKey":"holders.items.[INDEX].rank.oneOf.1","typeLabel":"null"}],"uniqueKey":"holders.items.[INDEX].rank","typeLabel":"integer\u003cint64> | null"}},"uniqueKey":"holders.items.[INDEX]","typeLabel":"object"},"description":"Holders the read returned, largest balance first.","isRequired":true,"uniqueKey":"holders","typeLabel":"object[]"},"top10":{"type":"object","description":"Balance-weighted entry and exit prices across the first 10 holders; the filtered cohort\nunder `flags`.","properties":{"avgEntryPrice":{"oneOf":[{"type":"null","description":"Balance-weighted entry price across the cohort; `null` when no holder has one.","uniqueKey":"top10.avgEntryPrice.oneOf.0","typeLabel":"null"},{"type":"object","description":"Balance-weighted entry price across the cohort; `null` when no holder has one.","required":["native"],"properties":{"native":{"type":"string","format":"decimal","description":"Value in the owning chain's gas asset.","example":"123.456789","isRequired":true,"uniqueKey":"top10.avgEntryPrice.oneOf.1.native","typeLabel":"string\u003cdecimal>"},"usd":{"oneOf":[{"type":"null","description":"Value in USD; `null` when the native asset is unpriced.","uniqueKey":"top10.avgEntryPrice.oneOf.1.usd.oneOf.0","typeLabel":"null"},{"type":"string","description":"Value in USD; `null` when the native asset is unpriced.","format":"decimal","example":"123.456789","uniqueKey":"top10.avgEntryPrice.oneOf.1.usd.oneOf.1","typeLabel":"string\u003cdecimal>"}],"uniqueKey":"top10.avgEntryPrice.oneOf.1.usd","typeLabel":"null | string\u003cdecimal>"}},"uniqueKey":"top10.avgEntryPrice.oneOf.1","typeLabel":"object"}],"uniqueKey":"top10.avgEntryPrice","typeLabel":"null | object"},"avgExitPrice":{"oneOf":[{"type":"null","description":"Balance-weighted exit price across the cohort; `null` when no holder has one.","uniqueKey":"top10.avgExitPrice.oneOf.0","typeLabel":"null"},{"type":"object","description":"Balance-weighted exit price across the cohort; `null` when no holder has one.","required":["native"],"properties":{"native":{"type":"string","format":"decimal","description":"Value in the owning chain's gas asset.","example":"123.456789","isRequired":true,"uniqueKey":"top10.avgExitPrice.oneOf.1.native","typeLabel":"string\u003cdecimal>"},"usd":{"oneOf":[{"type":"null","description":"Value in USD; `null` when the native asset is unpriced.","uniqueKey":"top10.avgExitPrice.oneOf.1.usd.oneOf.0","typeLabel":"null"},{"type":"string","description":"Value in USD; `null` when the native asset is unpriced.","format":"decimal","example":"123.456789","uniqueKey":"top10.avgExitPrice.oneOf.1.usd.oneOf.1","typeLabel":"string\u003cdecimal>"}],"uniqueKey":"top10.avgExitPrice.oneOf.1.usd","typeLabel":"null | string\u003cdecimal>"}},"uniqueKey":"top10.avgExitPrice.oneOf.1","typeLabel":"object"}],"uniqueKey":"top10.avgExitPrice","typeLabel":"null | object"}},"isRequired":true,"uniqueKey":"top10","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"holderCount":1,"holders":[{"address":"\u003cstring>","balance":"123.456789","buyCount":1,"buyVolume":{"native":"123.456789","usd":"123.456789"},"funding":{"status":"unresolved","address":"\u003cstring>","amount":"123.456789","asset":"\u003cstring>","sourceKind":"cex","sourceLabel":"\u003cstring>","symbol":"\u003cstring>","timestamp":123,"tx":"\u003cstring>"},"realizedPnl":{"native":"123.456789","usd":"123.456789"},"remainingPct":"123.456789","sellCount":1,"sellVolume":{"native":"123.456789","usd":"123.456789"},"supplyPct":"123.456789","tokensBought":"123.456789","tokensSold":"123.456789","avgEntryMarketCap":{"native":"123.456789","usd":"123.456789"},"avgEntryPrice":{"native":"123.456789","usd":"123.456789"},"avgExitMarketCap":{"native":"123.456789","usd":"123.456789"},"avgExitPrice":{"native":"123.456789","usd":"123.456789"},"firstPurchaseAt":123,"flags":["bundler"],"identities":[{"source":"codex","avatar":"\u003cstring>","displayName":"\u003cstring>","farcaster":"\u003cstring>","handle":"\u003cstring>","telegram":"\u003cstring>","twitter":"\u003cstring>"}],"nativeBalance":"123.456789","platforms":[{"platform":"fomo"}],"rank":1}],"top10":{"avgEntryPrice":{"native":"123.456789","usd":"123.456789"},"avgExitPrice":{"native":"123.456789","usd":"123.456789"}}}}},"exampleType":"generated"}},"exampleType":"generated"},"d9c43b30-9f38-4217-8c86-8d089a2c7f02":{"description":"Unsupported chain, a malformed address or trader, an unknown flag or period, or a malformed parameter.","headers":{"X-Credits-Cost":{"schema":{"type":"integer"},"description":"Credits charged for this request. Zero on any non-2xx. Sent on a metered tier only."},"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credit balance after this request. Sent on a metered tier only."},"X-RateLimit-Remaining":{"schema":{"type":"integer"},"description":"Requests left in the bucket this request spent from. Not sent with a 401."},"X-Request-ID":{"schema":{"type":"string"},"description":"This request's trace ID. Echoed from the request, or generated when it sent none."}},"content":{"application/json":{"schema":{"type":"object","description":"The complete error response body — every error is exactly this.","required":["error"],"properties":{"error":{"type":"object","description":"The error.","required":["code","message"],"properties":{"code":{"type":"string","description":"Stable, machine-readable. Clients switch on this, never on `message`.","enum":["UNAUTHORIZED","FORBIDDEN","VALIDATION_ERROR","UNSUPPORTED_CHAIN","NOT_FOUND","RATE_LIMITED","CREDITS_EXHAUSTED","INTERNAL_ERROR","SERVICE_UNAVAILABLE","RANGE_TOO_LARGE","INVALID_CREDENTIALS","ORIGIN_NOT_ALLOWED","NOT_ORG_MEMBER","MEMBERSHIP_INACTIVE","EMAIL_NOT_VERIFIED","EMAIL_TAKEN","ALREADY_MEMBER","INVITATION_ALREADY_SENT","INVITATION_ALREADY_ACCEPTED","LAST_ADMIN","CANNOT_REMOVE_SELF","KEY_LIMIT_REACHED","TOKEN_EXPIRED","PAYLOAD_TOO_LARGE","UNSUPPORTED_MEDIA_TYPE","IMAGE_TOO_LARGE"],"isRequired":true,"uniqueKey":"error.code","typeLabel":"enum\u003cstring>"},"message":{"type":"string","description":"Human-readable, written for the integrating developer:\n`[What happened]. [What to do next — if actionable].`","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"details":{"description":"Optional; shape is fixed per code.","uniqueKey":"error.details","typeLabel":"any"}},"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":"UNAUTHORIZED","message":"\u003cstring>","details":"\u003cunknown>"}}}},"exampleType":"generated"}},"exampleType":"generated"},"084081ee-2662-49b5-8a4b-e8aeec31dcec":{"description":"Missing or invalid credential: an API key, or a session token a key minted.","headers":{"X-Credits-Cost":{"schema":{"type":"integer"},"description":"Credits charged for this request. Zero on any non-2xx. Sent on a metered tier only."},"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credit balance after this request. Sent on a metered tier only."},"X-RateLimit-Remaining":{"schema":{"type":"integer"},"description":"Requests left in the bucket this request spent from. Not sent with a 401."},"X-Request-ID":{"schema":{"type":"string"},"description":"This request's trace ID. Echoed from the request, or generated when it sent none."}},"content":{"application/json":{"schema":{"type":"object","description":"The complete error response body — every error is exactly this.","required":["error"],"properties":{"error":{"type":"object","description":"The error.","required":["code","message"],"properties":{"code":{"type":"string","description":"Stable, machine-readable. Clients switch on this, never on `message`.","enum":["UNAUTHORIZED","FORBIDDEN","VALIDATION_ERROR","UNSUPPORTED_CHAIN","NOT_FOUND","RATE_LIMITED","CREDITS_EXHAUSTED","INTERNAL_ERROR","SERVICE_UNAVAILABLE","RANGE_TOO_LARGE","INVALID_CREDENTIALS","ORIGIN_NOT_ALLOWED","NOT_ORG_MEMBER","MEMBERSHIP_INACTIVE","EMAIL_NOT_VERIFIED","EMAIL_TAKEN","ALREADY_MEMBER","INVITATION_ALREADY_SENT","INVITATION_ALREADY_ACCEPTED","LAST_ADMIN","CANNOT_REMOVE_SELF","KEY_LIMIT_REACHED","TOKEN_EXPIRED","PAYLOAD_TOO_LARGE","UNSUPPORTED_MEDIA_TYPE","IMAGE_TOO_LARGE"],"isRequired":true,"uniqueKey":"error.code","typeLabel":"enum\u003cstring>"},"message":{"type":"string","description":"Human-readable, written for the integrating developer:\n`[What happened]. [What to do next — if actionable].`","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"details":{"description":"Optional; shape is fixed per code.","uniqueKey":"error.details","typeLabel":"any"}},"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":"UNAUTHORIZED","message":"\u003cstring>","details":"\u003cunknown>"}}}},"exampleType":"generated"}},"exampleType":"generated"},"5c46f153-9f07-4dcc-b1e0-2dc1aad1ce17":{"description":"The organization's credits this billing period reach its plan's limit.","headers":{"X-Credits-Cost":{"schema":{"type":"integer"},"description":"Credits charged for this request. Zero on any non-2xx. Sent on a metered tier only."},"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credit balance after this request. Sent on a metered tier only."},"X-RateLimit-Remaining":{"schema":{"type":"integer"},"description":"Requests left in the bucket this request spent from. Not sent with a 401."},"X-Request-ID":{"schema":{"type":"string"},"description":"This request's trace ID. Echoed from the request, or generated when it sent none."}},"content":{"application/json":{"schema":{"type":"object","description":"The complete error response body — every error is exactly this.","required":["error"],"properties":{"error":{"type":"object","description":"The error.","required":["code","message"],"properties":{"code":{"type":"string","description":"Stable, machine-readable. Clients switch on this, never on `message`.","enum":["UNAUTHORIZED","FORBIDDEN","VALIDATION_ERROR","UNSUPPORTED_CHAIN","NOT_FOUND","RATE_LIMITED","CREDITS_EXHAUSTED","INTERNAL_ERROR","SERVICE_UNAVAILABLE","RANGE_TOO_LARGE","INVALID_CREDENTIALS","ORIGIN_NOT_ALLOWED","NOT_ORG_MEMBER","MEMBERSHIP_INACTIVE","EMAIL_NOT_VERIFIED","EMAIL_TAKEN","ALREADY_MEMBER","INVITATION_ALREADY_SENT","INVITATION_ALREADY_ACCEPTED","LAST_ADMIN","CANNOT_REMOVE_SELF","KEY_LIMIT_REACHED","TOKEN_EXPIRED","PAYLOAD_TOO_LARGE","UNSUPPORTED_MEDIA_TYPE","IMAGE_TOO_LARGE"],"isRequired":true,"uniqueKey":"error.code","typeLabel":"enum\u003cstring>"},"message":{"type":"string","description":"Human-readable, written for the integrating developer:\n`[What happened]. [What to do next — if actionable].`","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"details":{"description":"Optional; shape is fixed per code.","uniqueKey":"error.details","typeLabel":"any"}},"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":"UNAUTHORIZED","message":"\u003cstring>","details":"\u003cunknown>"}}}},"exampleType":"generated"}},"exampleType":"generated"},"5143c47b-1fb6-4a74-a991-3b3ae0d23754":{"description":"A key whose plan excludes this endpoint gets `FORBIDDEN`. A session token from an\norigin it does not name gets `ORIGIN_NOT_ALLOWED`.","headers":{"X-Credits-Cost":{"schema":{"type":"integer"},"description":"Credits charged for this request. Zero on any non-2xx. Sent on a metered tier only."},"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credit balance after this request. Sent on a metered tier only."},"X-RateLimit-Remaining":{"schema":{"type":"integer"},"description":"Requests left in the bucket this request spent from. Not sent with a 401."},"X-Request-ID":{"schema":{"type":"string"},"description":"This request's trace ID. Echoed from the request, or generated when it sent none."}},"content":{"application/json":{"schema":{"type":"object","description":"The complete error response body — every error is exactly this.","required":["error"],"properties":{"error":{"type":"object","description":"The error.","required":["code","message"],"properties":{"code":{"type":"string","description":"Stable, machine-readable. Clients switch on this, never on `message`.","enum":["UNAUTHORIZED","FORBIDDEN","VALIDATION_ERROR","UNSUPPORTED_CHAIN","NOT_FOUND","RATE_LIMITED","CREDITS_EXHAUSTED","INTERNAL_ERROR","SERVICE_UNAVAILABLE","RANGE_TOO_LARGE","INVALID_CREDENTIALS","ORIGIN_NOT_ALLOWED","NOT_ORG_MEMBER","MEMBERSHIP_INACTIVE","EMAIL_NOT_VERIFIED","EMAIL_TAKEN","ALREADY_MEMBER","INVITATION_ALREADY_SENT","INVITATION_ALREADY_ACCEPTED","LAST_ADMIN","CANNOT_REMOVE_SELF","KEY_LIMIT_REACHED","TOKEN_EXPIRED","PAYLOAD_TOO_LARGE","UNSUPPORTED_MEDIA_TYPE","IMAGE_TOO_LARGE"],"isRequired":true,"uniqueKey":"error.code","typeLabel":"enum\u003cstring>"},"message":{"type":"string","description":"Human-readable, written for the integrating developer:\n`[What happened]. [What to do next — if actionable].`","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"details":{"description":"Optional; shape is fixed per code.","uniqueKey":"error.details","typeLabel":"any"}},"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":"UNAUTHORIZED","message":"\u003cstring>","details":"\u003cunknown>"}}}},"exampleType":"generated"}},"exampleType":"generated"},"66c2ac9c-b082-4d87-98ef-6d2cbc611470":{"description":"Rate limit exceeded.","headers":{"Retry-After":{"schema":{"type":"integer"},"description":"Seconds to wait before retrying."},"X-Credits-Cost":{"schema":{"type":"integer"},"description":"Credits charged for this request. Zero on any non-2xx. Sent on a metered tier only."},"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credit balance after this request. Sent on a metered tier only."},"X-RateLimit-Remaining":{"schema":{"type":"integer"},"description":"Requests left in the bucket this request spent from. Not sent with a 401."},"X-Request-ID":{"schema":{"type":"string"},"description":"This request's trace ID. Echoed from the request, or generated when it sent none."}},"content":{"application/json":{"schema":{"type":"object","description":"The complete error response body — every error is exactly this.","required":["error"],"properties":{"error":{"type":"object","description":"The error.","required":["code","message"],"properties":{"code":{"type":"string","description":"Stable, machine-readable. Clients switch on this, never on `message`.","enum":["UNAUTHORIZED","FORBIDDEN","VALIDATION_ERROR","UNSUPPORTED_CHAIN","NOT_FOUND","RATE_LIMITED","CREDITS_EXHAUSTED","INTERNAL_ERROR","SERVICE_UNAVAILABLE","RANGE_TOO_LARGE","INVALID_CREDENTIALS","ORIGIN_NOT_ALLOWED","NOT_ORG_MEMBER","MEMBERSHIP_INACTIVE","EMAIL_NOT_VERIFIED","EMAIL_TAKEN","ALREADY_MEMBER","INVITATION_ALREADY_SENT","INVITATION_ALREADY_ACCEPTED","LAST_ADMIN","CANNOT_REMOVE_SELF","KEY_LIMIT_REACHED","TOKEN_EXPIRED","PAYLOAD_TOO_LARGE","UNSUPPORTED_MEDIA_TYPE","IMAGE_TOO_LARGE"],"isRequired":true,"uniqueKey":"error.code","typeLabel":"enum\u003cstring>"},"message":{"type":"string","description":"Human-readable, written for the integrating developer:\n`[What happened]. [What to do next — if actionable].`","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"details":{"description":"Optional; shape is fixed per code.","uniqueKey":"error.details","typeLabel":"any"}},"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":"UNAUTHORIZED","message":"\u003cstring>","details":"\u003cunknown>"}}}},"exampleType":"generated"}},"exampleType":"generated"},"c23c4d99-5b46-483e-840c-6394dbaf3689":{"description":"Unexpected server failure.","headers":{"X-Credits-Cost":{"schema":{"type":"integer"},"description":"Credits charged for this request. Zero on any non-2xx. Sent on a metered tier only."},"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credit balance after this request. Sent on a metered tier only."},"X-RateLimit-Remaining":{"schema":{"type":"integer"},"description":"Requests left in the bucket this request spent from. Not sent with a 401."},"X-Request-ID":{"schema":{"type":"string"},"description":"This request's trace ID. Echoed from the request, or generated when it sent none."}},"content":{"application/json":{"schema":{"type":"object","description":"The complete error response body — every error is exactly this.","required":["error"],"properties":{"error":{"type":"object","description":"The error.","required":["code","message"],"properties":{"code":{"type":"string","description":"Stable, machine-readable. Clients switch on this, never on `message`.","enum":["UNAUTHORIZED","FORBIDDEN","VALIDATION_ERROR","UNSUPPORTED_CHAIN","NOT_FOUND","RATE_LIMITED","CREDITS_EXHAUSTED","INTERNAL_ERROR","SERVICE_UNAVAILABLE","RANGE_TOO_LARGE","INVALID_CREDENTIALS","ORIGIN_NOT_ALLOWED","NOT_ORG_MEMBER","MEMBERSHIP_INACTIVE","EMAIL_NOT_VERIFIED","EMAIL_TAKEN","ALREADY_MEMBER","INVITATION_ALREADY_SENT","INVITATION_ALREADY_ACCEPTED","LAST_ADMIN","CANNOT_REMOVE_SELF","KEY_LIMIT_REACHED","TOKEN_EXPIRED","PAYLOAD_TOO_LARGE","UNSUPPORTED_MEDIA_TYPE","IMAGE_TOO_LARGE"],"isRequired":true,"uniqueKey":"error.code","typeLabel":"enum\u003cstring>"},"message":{"type":"string","description":"Human-readable, written for the integrating developer:\n`[What happened]. [What to do next — if actionable].`","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"details":{"description":"Optional; shape is fixed per code.","uniqueKey":"error.details","typeLabel":"any"}},"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":"UNAUTHORIZED","message":"\u003cstring>","details":"\u003cunknown>"}}}},"exampleType":"generated"}},"exampleType":"generated"},"cbe0cca1-48cf-4cd6-a88b-ac207b471d17":{"description":"Dependency down or maintenance.","headers":{"X-Credits-Cost":{"schema":{"type":"integer"},"description":"Credits charged for this request. Zero on any non-2xx. Sent on a metered tier only."},"X-Credits-Remaining":{"schema":{"type":"integer"},"description":"Credit balance after this request. Sent on a metered tier only."},"X-RateLimit-Remaining":{"schema":{"type":"integer"},"description":"Requests left in the bucket this request spent from. Not sent with a 401."},"X-Request-ID":{"schema":{"type":"string"},"description":"This request's trace ID. Echoed from the request, or generated when it sent none."}},"content":{"application/json":{"schema":{"type":"object","description":"The complete error response body — every error is exactly this.","required":["error"],"properties":{"error":{"type":"object","description":"The error.","required":["code","message"],"properties":{"code":{"type":"string","description":"Stable, machine-readable. Clients switch on this, never on `message`.","enum":["UNAUTHORIZED","FORBIDDEN","VALIDATION_ERROR","UNSUPPORTED_CHAIN","NOT_FOUND","RATE_LIMITED","CREDITS_EXHAUSTED","INTERNAL_ERROR","SERVICE_UNAVAILABLE","RANGE_TOO_LARGE","INVALID_CREDENTIALS","ORIGIN_NOT_ALLOWED","NOT_ORG_MEMBER","MEMBERSHIP_INACTIVE","EMAIL_NOT_VERIFIED","EMAIL_TAKEN","ALREADY_MEMBER","INVITATION_ALREADY_SENT","INVITATION_ALREADY_ACCEPTED","LAST_ADMIN","CANNOT_REMOVE_SELF","KEY_LIMIT_REACHED","TOKEN_EXPIRED","PAYLOAD_TOO_LARGE","UNSUPPORTED_MEDIA_TYPE","IMAGE_TOO_LARGE"],"isRequired":true,"uniqueKey":"error.code","typeLabel":"enum\u003cstring>"},"message":{"type":"string","description":"Human-readable, written for the integrating developer:\n`[What happened]. [What to do next — if actionable].`","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"details":{"description":"Optional; shape is fixed per code.","uniqueKey":"error.details","typeLabel":"any"}},"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":"UNAUTHORIZED","message":"\u003cstring>","details":"\u003cunknown>"}}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"744ac6ae-8a74-4d87-a0bd-0a1d1cf62a38":{"bearerKey":{"type":"http","scheme":"bearer","description":"Send an API key, or a session token a key minted, as `Authorization: Bearer \u003ccredential>`. A browser opening `/v1/stream` offers its session token in `Sec-WebSocket-Protocol` instead.","scopes":[],"schemeName":"bearerKey"}}},"servers":{"583dafd9-2e40-4bab-8b7e-b807c8f219de":{"url":"https://{host}","variables":{"host":{"default":"api.metastreams.io","description":"API host."}}}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","scheme":"bearer","description":"Send an API key, or a session token a key minted, as `Authorization: Bearer \u003ccredential>`. A browser opening `/v1/stream` offers its session token in `Sec-WebSocket-Protocol` instead.","scopes":[],"schemeName":"bearerKey"},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"Send an API key, or a session token a key minted, as `Authorization: Bearer \u003ccredential>`. A browser opening `/v1/stream` offers its session token in `Sec-WebSocket-Protocol` instead.","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"bearerKey","name":"Authorization"}],"title":"bearerKey"}]},"originalFileLocation":"specs/openapi.json"},"subdomain":"metastreams-prod","siteName":"Metastreams API","title":"A token's current holders, largest balance first, optionally narrowed to wallet classifications. - Metastreams API","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-10-25T18:57:03.704Z","originalFileLocation":"api-reference/tokens/a-tokens-current-holders-largest-balance-first-optionally-narrowed-to-wallet-classifications.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=\"Pools and lockers rank here and carry their flag. holderCount stays the token\u0026#x27;s total under flags.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Metastreams API\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/metastreams-prod/ontrOlgyWPlFJWQ-/_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/metastreams-prod/ontrOlgyWPlFJWQ-/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/metastreams-prod/ontrOlgyWPlFJWQ-/_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/metastreams-prod/ontrOlgyWPlFJWQ-/_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/metastreams-prod/ontrOlgyWPlFJWQ-/_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/metastreams-prod/ontrOlgyWPlFJWQ-/_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/metastreams-prod/ontrOlgyWPlFJWQ-/_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/metastreams-prod/ontrOlgyWPlFJWQ-/_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/metastreams-prod/ontrOlgyWPlFJWQ-/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"A token\u0026#x27;s current holders, largest balance first, optionally narrowed to wallet classifications. - Metastreams API\">\u003cmeta data-mint-head property=\"og:description\" content=\"Pools and lockers rank here and carry their flag. holderCount stays the token\u0026#x27;s total under flags.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Metastreams API\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.metastreams.io/api-reference/tokens/a-tokens-current-holders-largest-balance-first-optionally-narrowed-to-wallet-classifications\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://metastreams-prod.mintlify.app/_mintlify/api/og/v2?division=tokens\u0026amp;title=A+token%27s+current+holders%2C+largest+balance+first%2C+optionally+narrowed+to+wallet+classifications.\u0026amp;description=Pools+and+lockers+rank+here+and+carry+their+flag.+%60holderCount%60+stays+the+token%27s+total+under%0A%60flags%60.\u0026amp;theme=f93f9f41876bb5c60e936f10\u0026amp;signature=10fd6da5f6038f704c179348dc0c8316e0a17765fb5dc74367f0133d1359fe6f\">\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=\"A token\u0026#x27;s current holders, largest balance first, optionally narrowed to wallet classifications. - Metastreams API\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Pools and lockers rank here and carry their flag. holderCount stays the token\u0026#x27;s total under flags.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://metastreams-prod.mintlify.app/_mintlify/api/og/v2?division=tokens\u0026amp;title=A+token%27s+current+holders%2C+largest+balance+first%2C+optionally+narrowed+to+wallet+classifications.\u0026amp;description=Pools+and+lockers+rank+here+and+carry+their+flag.+%60holderCount%60+stays+the+token%27s+total+under%0A%60flags%60.\u0026amp;theme=f93f9f41876bb5c60e936f10\u0026amp;signature=10fd6da5f6038f704c179348dc0c8316e0a17765fb5dc74367f0133d1359fe6f\">\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/metastreams-prod/ontrOlgyWPlFJWQ-/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Metastreams API\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#2563EB\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.metastreams.io/api-reference/tokens/a-tokens-current-holders-largest-balance-first-optionally-narrowed-to-wallet-classifications\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/tokens/a-tokens-current-holders-largest-balance-first-optionally-narrowed-to-wallet-classifications.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.metastreams.io/#organization\",\"name\":\"Metastreams API\",\"url\":\"https://docs.metastreams.io\"},{\"@type\":\"WebSite\",\"@id\":\"https://docs.metastreams.io#website\",\"name\":\"Metastreams API\",\"url\":\"https://docs.metastreams.io\",\"publisher\":{\"@id\":\"https://docs.metastreams.io/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.metastreams.io/api-reference/tokens/a-tokens-current-holders-largest-balance-first-optionally-narrowed-to-wallet-classifications#webpage\",\"url\":\"https://docs.metastreams.io/api-reference/tokens/a-tokens-current-holders-largest-balance-first-optionally-narrowed-to-wallet-classifications\",\"name\":\"A token's current holders, largest balance first, optionally narrowed to wallet classifications.\",\"description\":\"Pools and lockers rank here and carry their flag. holderCount stays the token's total under flags.\",\"dateModified\":\"2026-10-25T18:57:03.704Z\",\"isPartOf\":{\"@id\":\"https://docs.metastreams.io#website\"},\"breadcrumb\":{\"@id\":\"https://docs.metastreams.io/api-reference/tokens/a-tokens-current-holders-largest-balance-first-optionally-narrowed-to-wallet-classifications#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.metastreams.io/api-reference/tokens/a-tokens-current-holders-largest-balance-first-optionally-narrowed-to-wallet-classifications#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"REST\",\"item\":\"https://docs.metastreams.io/reference/rest/token-details\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"tokens\",\"item\":\"https://docs.metastreams.io/api-reference/tokens/token-details\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"A token's current holders, largest balance first, optionally narrowed to wallet classifications.\",\"item\":\"https://docs.metastreams.io/api-reference/tokens/a-tokens-current-holders-largest-balance-first-optionally-narrowed-to-wallet-classifications\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.metastreams.io/api-reference/tokens/a-tokens-current-holders-largest-balance-first-optionally-narrowed-to-wallet-classifications#apireference\",\"headline\":\"A token's current holders, largest balance first, optionally narrowed to wallet classifications.\",\"name\":\"A token's current holders, largest balance first, optionally narrowed to wallet classifications.\",\"description\":\"Pools and lockers rank here and carry their flag. holderCount stays the token's total under flags.\",\"url\":\"https://docs.metastreams.io/api-reference/tokens/a-tokens-current-holders-largest-balance-first-optionally-narrowed-to-wallet-classifications\",\"mainEntityOfPage\":{\"@id\":\"https://docs.metastreams.io/api-reference/tokens/a-tokens-current-holders-largest-balance-first-optionally-narrowed-to-wallet-classifications#webpage\"},\"dateModified\":\"2026-10-25T18:57:03.704Z\",\"publisher\":{\"@id\":\"https://docs.metastreams.io/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.metastreams.io#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Metastreams API\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Metastreams API","nav":{"global":null,"tabs":[{"tab":"Docs","pages":[{"title":"Docs","href":""}]},{"tab":"API reference","groups":[{"group":"REST","pages":[{"title":"Token details","openapi":"specs/openapi.json GET /v1/tokens/{chain}/{address}","href":"/reference/rest/token-details"},{"title":"OHLCV candles","openapi":"specs/openapi.json GET /v1/tokens/{chain}/{address}/ohlcv","href":"/reference/rest/token-ohlcv"},{"title":"Token trades","openapi":"specs/openapi.json GET /v1/tokens/{chain}/{address}/trades","href":"/reference/rest/token-trades"},{"title":"Token holders","openapi":"specs/openapi.json GET /v1/tokens/{chain}/{address}/holders","href":"/reference/rest/token-holders"},{"title":"Identity trades","openapi":"specs/openapi.json GET /v1/trades","href":"/reference/rest/identity-trades"},{"title":"Discovery boards","openapi":"specs/openapi.json POST /v1/discovery","href":"/reference/rest/discovery"},{"title":"Wallet balances","openapi":"specs/openapi.json GET /v1/wallets/balances","href":"/reference/rest/wallet-balances"},{"title":"Positions","openapi":"specs/openapi.json GET /v1/positions","href":"/reference/rest/positions"},{"title":"Native prices","openapi":"specs/openapi.json GET /v1/native-prices","href":"/reference/rest/native-prices"},{"title":"Trending","openapi":"specs/openapi.json POST /v1/trending","href":"/reference/rest/trending"},{"title":"Session tokens","openapi":"specs/openapi.json POST /v1/session-tokens","href":"/reference/rest/session-tokens"},{"group":"discovery","pages":[{"title":"The discovery boards.","deprecated":null,"version":null,"openapi":"/specs/openapi.json post /v1/discovery","href":"/api-reference/discovery/the-discovery-boards"}]},{"group":"prices","pages":[{"title":"The newest USD price of each chain's gas asset: SOL, ETH or BNB.","deprecated":null,"version":null,"openapi":"/specs/openapi.json get /v1/native-prices","href":"/api-reference/prices/the-newest-usd-price-of-each-chains-gas-asset:-sol-eth-or-bnb"}]},{"group":"wallets","pages":[{"title":"One page of the named wallets' spot positions.","deprecated":null,"version":null,"openapi":"/specs/openapi.json get /v1/positions","href":"/api-reference/wallets/one-page-of-the-named-wallets-spot-positions"},{"title":"The latest balance of each named wallet, per chain and asset.","deprecated":null,"version":null,"openapi":"/specs/openapi.json get /v1/wallets/balances","href":"/api-reference/wallets/the-latest-balance-of-each-named-wallet-per-chain-and-asset"}]},{"group":"sessionTokens","pages":[{"title":"Mint a session token for a browser or app user.","deprecated":null,"version":null,"openapi":"/specs/openapi.json post /v1/session-tokens","href":"/api-reference/sessiontokens/mint-a-session-token-for-a-browser-or-app-user"}]},{"group":"tokens","pages":[{"title":"Token details.","description":"One object holds the token's identity, launch, price, market cap and liquidity. It also\ncarries the top pools, the trailing-window stats, and the holder, security, fee and\nmetadata readings. An unknown token answers `404`.","deprecated":null,"version":null,"openapi":"/specs/openapi.json get /v1/tokens/{chain}/{address}","href":"/api-reference/tokens/token-details"},{"title":"A token's current holders, largest balance first, optionally narrowed to wallet classifications.","deprecated":null,"version":null,"openapi":"/specs/openapi.json get /v1/tokens/{chain}/{address}/holders","href":"/api-reference/tokens/a-tokens-current-holders-largest-balance-first-optionally-narrowed-to-wallet-classifications"}]},{"group":"ohlcv","pages":[{"title":"OHLCV candles at one timeframe, oldest first.","description":"The series follows the `TradingView` contract: `countBack` asks for a bar\ncount and supersedes `from`; `to` and `timeframe` still bind. A window with\nmore candles than the cap keeps the newest. To read older candles, repeat\nthe request with `to` set to the earliest `time` received.","deprecated":null,"version":null,"openapi":"/specs/openapi.json get /v1/tokens/{chain}/{address}/ohlcv","href":"/api-reference/ohlcv/ohlcv-candles-at-one-timeframe-oldest-first"}]},{"group":"trades","pages":[{"title":"Recent trades on the token, newest first, optionally narrowed to wallet classifications.","deprecated":null,"version":null,"openapi":"/specs/openapi.json get /v1/tokens/{chain}/{address}/trades","href":"/api-reference/trades/recent-trades-on-the-token-newest-first-optionally-narrowed-to-wallet-classifications"},{"title":"Recent trades by a notable identity, across every chain and token.","deprecated":null,"version":null,"openapi":"/specs/openapi.json get /v1/trades","href":"/api-reference/trades/recent-trades-by-a-notable-identity-across-every-chain-and-token"}]},{"group":"trending","pages":[{"title":"Tokens ranked by trending score.","deprecated":null,"version":null,"openapi":"/specs/openapi.json post /v1/trending","href":"/api-reference/trending/tokens-ranked-by-trending-score"}]}]},{"group":"Streams","pages":[{"title":"spot.trades","href":"/reference/streams/spot-trades"},{"title":"spot.transfers","href":"/reference/streams/spot-transfers"},{"title":"spot.candles","href":"/reference/streams/spot-candles"},{"title":"spot.tokens","href":"/reference/streams/spot-tokens"},{"title":"wallet.balances","href":"/reference/streams/wallet-balances"},{"title":"spot.positions","href":"/reference/streams/spot-positions"},{"title":"spot.holders","href":"/reference/streams/spot-holders"},{"title":"chain.nativePrices","href":"/reference/streams/native-prices"},{"title":"spot.trending","href":"/reference/streams/spot-trending"}]}]}]},"title":"A token's current holders, largest balance first, optionally narrowed to wallet classifications. - Metastreams API","buildId":"dpl_cadrRc5H9XQiJQbDFN5mcYRs2PAj","deploymentId":"dpl_cadrRc5H9XQiJQbDFN5mcYRs2PAj","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-DKJwRUt2.js","utils-CWD_VS3u.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-oFjciODD.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-C76WsxC3.js","snippetPresets-DvPMxpX_.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-CuNQfndH.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-BVFpVUoF.js","shallow-t59Jg5Kr.js","getApiPlaygroundDisplay-C_JZ4amX.js","CodeSnippet-CLRDnx_h.js","CodeSnippets-C2myU4kc.js","Page-7TwLLapg.js","getPastedJson-B-JaVXw7.js","icon-BA-iDhH3.js","MethodPill-D4qZABFp.js","DuplicateIcon-THIDKO1O.js","createIcon-CYYJwgFd.js","DynamicMarkdown-UGQuxDKp.js","SectionHeading-jYELb23h.js","axios-vUo_bRtp.js","Markdown-DKsLa3wy.js","clsx-CefdjKz2.js","lib--scc4DXi.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-BaREnp3o.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-sgx_0XzF.js"]}