> ## Documentation Index > Fetch the complete documentation index at: https://docs.vibechain.com/llms.txt > Use this file to discover all available pages before exploring further. # Get collection statistics > Returns pack, holder, and optional token-market statistics. Responses are cached for about 60 seconds. ## OpenAPI ````yaml /api-reference/vibemarket_openapi.yml get /collection/{contractAddress}/stats openapi: 3.0.3 info: title: vibe.market API version: 1.0.0 description: | Production API for vibe.market packs, games, collections, creator drafts, allowlists, market activity, social features, recovery tools, and analytics. Most operations require a caller-specific VibeChain API key in the `API-KEY` header. Account-bound writes additionally require a vibe.market session token in `Authorization: Bearer `. Public or Bearer-only exceptions are marked on the individual operation. contact: name: VibeChain developer support email: gm@vibechain.com url: https://docs.vibechain.com/api-reference/vibemarket-intro servers: - url: https://build.vibechain.com/vibe/boosterbox description: Production security: - ApiKeyAuth: [] tags: - name: Packs description: Read pack ownership, state, rarity, and metadata. - name: Collections description: Read collection holdings, statistics, and activity. - name: Games description: Discover games and read launch configuration. - name: Metadata description: Read published metadata and update launched collections. - name: Creator drafts description: Create, autosave, inspect, confirm, and delete launch drafts. - name: Allowlists description: Configure draft allowlists and generate Merkle proofs. - name: Activity description: Read recent packs and recover indexed transaction events. - name: Social description: Read chat, react to messages, and report collections. - name: Analytics description: Read price history, leaderboards, and platform totals. - name: Utility description: Resolve slugs, regions, prices, and processing readiness. paths: /collection/{contractAddress}/stats: get: tags: - Collections summary: Get collection statistics description: >- Returns pack, holder, and optional token-market statistics. Responses are cached for about 60 seconds. operationId: getVibeMarketCollectionStats parameters: - $ref: '#/components/parameters/ContractAddressPath' - $ref: '#/components/parameters/ChainId' - in: query name: includeTopHolders schema: type: boolean default: false - in: query name: topHoldersSortBy schema: type: string enum: - sealed - unopened - opened - sold - mythic - legendary - epic - rare - common - total default: total - in: query name: topHoldersLimit schema: type: integer minimum: 1 maximum: 100 default: 10 - in: query name: includeTopTokenHolder schema: type: boolean default: false - in: query name: tokenAddress description: ERC-20 address used when token-holder statistics are requested. schema: $ref: '#/components/schemas/EvmAddress' responses: '200': description: Collection statistics content: application/json: schema: $ref: '#/components/schemas/CollectionStatsResponse' '400': $ref: '#/components/responses/InvalidInput' '429': $ref: '#/components/responses/ApiKeyOrRateLimit' '500': $ref: '#/components/responses/InternalError' components: parameters: ContractAddressPath: in: path name: contractAddress required: true schema: $ref: '#/components/schemas/EvmAddress' ChainId: in: query name: chainId description: EVM chain ID. Defaults to Base mainnet. schema: type: integer minimum: 1 default: 8453 schemas: EvmAddress: type: string pattern: ^0x[a-fA-F0-9]{40}$ example: '0x1111111111111111111111111111111111111111' CollectionStatsResponse: type: object required: - success - stats properties: success: type: boolean enum: - true stats: type: object additionalProperties: true description: >- Aggregate pack, owner, rarity, and value statistics for the collection. tokenMarket: type: object additionalProperties: true topHolders: type: object required: - sortedBy - limit - holders properties: sortedBy: type: string limit: type: integer holders: type: array items: $ref: '#/components/schemas/HolderStats' topTokenHolders: type: array items: type: object additionalProperties: true topTokenHoldersMeta: type: object additionalProperties: true HolderStats: type: object additionalProperties: true properties: ownerAddress: $ref: '#/components/schemas/EvmAddress' total: type: integer sealed: type: integer unopened: type: integer opened: type: integer sold: type: integer common: type: integer rare: type: integer epic: type: integer legendary: type: integer mythic: type: integer user: $ref: '#/components/schemas/UserSummary' Error: type: object required: - success - message properties: success: type: boolean enum: - false message: type: string error: description: >- Optional diagnostic detail. Do not depend on this field being present in production. oneOf: - type: string - type: object additionalProperties: true UserSummary: type: object additionalProperties: true properties: id: type: string username: type: string displayName: type: string profileImage: type: string format: uri address: $ref: '#/components/schemas/EvmAddress' responses: InvalidInput: description: Invalid or incomplete request input content: application/json: schema: $ref: '#/components/schemas/Error' example: success: false message: Invalid contract address ApiKeyOrRateLimit: description: API key missing/invalid or the caller's rate allowance is exhausted content: application/json: schema: $ref: '#/components/schemas/Error' example: success: false message: >- Too many requests or invalid API key! See docs.vibechain.com for more info. InternalError: description: The server could not complete the operation content: application/json: schema: $ref: '#/components/schemas/Error' example: success: false message: Failed to complete request securitySchemes: ApiKeyAuth: type: apiKey in: header name: API-KEY description: Caller-specific VibeChain API key used for quota and abuse control. ````