v1
latestOpenAPI 3.1.02026-07-13570316.1 KBGet Owners
Retrieves a paginated list of owners for a given token contract on a specific chain. Supports ERC-20 tokens, ERC-721 NFTs, and ERC-1155 tokens:
- ERC-20: No tokenId provided - returns token holders with balances
- NFT Collection: No tokenId provided - returns all owners of any token in the collection
- Specific NFT: tokenId provided - returns owner(s) of that specific token ID
The token standard is automatically detected using ERC165 interface detection when needed.
Authentication: Pass x-client-id header for frontend usage from allowlisted origins or x-secret-key for backend usage.
Path parameters
The blockchain network identifier. Common values include: 1 (Ethereum), 8453 (Base), 137 (Polygon), 56 (BSC), 43114 (Avalanche), 42161 (Arbitrum), 10 (Optimism).
The blockchain network identifier. Common values include: 1 (Ethereum), 8453 (Base), 137 (Polygon), 56 (BSC), 43114 (Avalanche), 42161 (Arbitrum), 10 (Optimism).
A valid Ethereum address (0x-prefixed hex string) or ENS name (e.g., vitalik.eth).
A valid Ethereum address (0x-prefixed hex string) or ENS name (e.g., vitalik.eth).
Query parameters
Optional token ID for NFT owners. If provided, returns owners of the specific NFT token.
Optional token ID for NFT owners. If provided, returns owners of the specific NFT token.
Number of owners to return per page (1-100).
Number of owners to return per page (1-100).
Page number for pagination, starting from 1.
Page number for pagination, starting from 1.
Response
Token owners retrieved successfully. Returns owners with pagination information. For ERC-20 tokens, amount represents token balance. For NFTs, amount represents quantity owned (usually '1' for ERC-721, can be >1 for ERC-1155).