Skip to main content
GET
Get collection statistics

Authorizations

API-KEY
string
header
required

Caller-specific VibeChain API key used for quota and abuse control.

Path Parameters

contractAddress
string
required
Pattern: ^0x[a-fA-F0-9]{40}$
Example:

"0x1111111111111111111111111111111111111111"

Query Parameters

chainId
integer
default:8453

EVM chain ID. Defaults to Base mainnet.

Required range: x >= 1
includeTopHolders
boolean
default:false
topHoldersSortBy
enum<string>
default:total
Available options:
sealed,
unopened,
opened,
sold,
mythic,
legendary,
epic,
rare,
common,
total
topHoldersLimit
integer
default:10
Required range: 1 <= x <= 100
includeTopTokenHolder
boolean
default:false
tokenAddress
string

ERC-20 address used when token-holder statistics are requested.

Pattern: ^0x[a-fA-F0-9]{40}$
Example:

"0x1111111111111111111111111111111111111111"

Response

Collection statistics

success
enum<boolean>
required
Available options:
true
stats
object
required

Aggregate pack, owner, rarity, and value statistics for the collection.

tokenMarket
object
topHolders
object
topTokenHolders
object[]
topTokenHoldersMeta
object