Skip to main content
GET
cURL
20 credits per request

  • Holder addresses with token counts
  • Total holder count
  • collectionAddress: Path parameter. NFT collection contract address.
  • blockchain: Chain the collection lives on. Defaults to ethereum.
  • page & limit: Control pagination; limit is capped at 100.

Authorizations

X-API-KEY
string
header
required

API key required to access the endpoints. Generate one from your dashboard at https://openapi.coinstats.app and pass it in the X-API-KEY request header. Never expose your key in client-side code.

Path Parameters

collectionAddress
string
required

The address of the NFT collection

Example:

"0xbc4ca0eda7647a8ab7c2061c2e118a18a936f13d"

Query Parameters

page
number

Page number to retrieve (1-based indexing)

Example:

1

limit
number

Number of NFT items to return per page

Example:

20

blockchain
enum<string>
default:ethereum

The blockchain network identifier from /wallet/blockchains call response (its chain field). NFT data is available on: ethereum, polygon-pos, base, arbitrum-one, optimistic-ethereum, zksync, blast, linea, scroll, zora, abstract, apechain, avalanche, binance_smart, unichain, soneium, berachain, world-chain, celo, xdai, monad. Defaults to ethereum.

Available options:
ethereum,
polygon-pos,
base,
arbitrum-one,
optimistic-ethereum,
zksync,
blast,
linea,
scroll,
zora,
abstract,
apechain,
avalanche,
binance_smart,
unichain,
soneium,
berachain,
world-chain,
celo,
xdai,
monad
Example:

"ethereum"

Response

data
object[]
required
meta
object
required
ownersCount
number | null
required

Total holders, when the collection has 50,000 or fewer

Example:

5616

truncated
boolean
required

The collection has more than 50,000 holders; only the first 50,000 were ranked

Example:

false