> ## 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. # List packs in a token range > Supply either `tokenIds` or both `startTokenId` and `endTokenId`. `forceRefreshState` schedules a background state refresh and should be reserved for recovery; repeated refreshes are internally throttled. ## OpenAPI ````yaml /api-reference/vibemarket_openapi.yml get /range 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: /range: get: tags: - Packs summary: List packs in a token range description: | Supply either `tokenIds` or both `startTokenId` and `endTokenId`. `forceRefreshState` schedules a background state refresh and should be reserved for recovery; repeated refreshes are internally throttled. operationId: listVibeMarketPackRange parameters: - $ref: '#/components/parameters/ContractAddressQuery' - in: query name: tokenIds description: >- Comma-separated token IDs. Mutually exclusive with the start/end range. schema: type: string example: 1,2,7,42 - in: query name: startTokenId schema: type: integer minimum: 0 - in: query name: endTokenId schema: type: integer minimum: 0 - $ref: '#/components/parameters/ChainId' - $ref: '#/components/parameters/PackStatus' - $ref: '#/components/parameters/RarityCode' - $ref: '#/components/parameters/Page' - $ref: '#/components/parameters/Limit' - in: query name: sortBy schema: type: string example: tokenId - $ref: '#/components/parameters/SortOrder' - $ref: '#/components/parameters/IncludeMetadata' - $ref: '#/components/parameters/IncludeContractDetails' - in: query name: forceRefreshState description: Queue an onchain state refresh before returning cached data. schema: type: boolean default: false - $ref: '#/components/parameters/BypassImageProxy' responses: '200': description: A page of packs content: application/json: schema: $ref: '#/components/schemas/PackPage' '400': $ref: '#/components/responses/InvalidInput' '429': $ref: '#/components/responses/ApiKeyOrRateLimit' '500': $ref: '#/components/responses/InternalError' components: parameters: ContractAddressQuery: in: query 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 PackStatus: in: query name: status schema: $ref: '#/components/schemas/PackStatus' RarityCode: in: query name: rarity schema: $ref: '#/components/schemas/RarityCode' Page: in: query name: page schema: type: integer minimum: 1 default: 1 Limit: in: query name: limit description: Page size. Endpoint-specific validation may impose a lower maximum. schema: type: integer minimum: 1 default: 20 SortOrder: in: query name: sortOrder schema: type: string enum: - asc - desc default: desc IncludeMetadata: in: query name: includeMetadata schema: type: boolean default: false IncludeContractDetails: in: query name: includeContractDetails schema: type: boolean default: false BypassImageProxy: in: header name: X-Bypass-Image-Proxy description: >- Set to `true` to keep original recognized CDN URLs instead of vibe.market proxy URLs. Cache this response variant separately. schema: type: boolean default: false schemas: PackPage: type: object required: - success - boxes - pagination properties: success: type: boolean enum: - true boxes: type: array items: $ref: '#/components/schemas/BoosterBox' pagination: $ref: '#/components/schemas/Pagination' EvmAddress: type: string pattern: ^0x[a-fA-F0-9]{40}$ example: '0x1111111111111111111111111111111111111111' PackStatus: type: string enum: - minted - opened - rarity_assigned - burned RarityCode: type: integer minimum: 0 maximum: 5 description: 0 not assigned, 1 Common, 2 Rare, 3 Epic, 4 Legendary, 5 Mythic. BoosterBox: type: object required: - tokenId - owner - contractAddress - chainId - status - rarity additionalProperties: true properties: tokenId: type: integer minimum: 0 owner: $ref: '#/components/schemas/EvmAddress' contractAddress: $ref: '#/components/schemas/EvmAddress' chainId: type: integer example: 8453 status: $ref: '#/components/schemas/PackStatus' batchId: type: string rarity: $ref: '#/components/schemas/RarityCode' rarityName: $ref: '#/components/schemas/RarityName' tokenSeed: type: string randomValue: type: string mintTxHash: $ref: '#/components/schemas/TransactionHash' burnTxHash: $ref: '#/components/schemas/TransactionHash' rarityAssignedTxHash: $ref: '#/components/schemas/TransactionHash' openedTxHash: $ref: '#/components/schemas/TransactionHash' mintBlockNumber: type: integer burnBlockNumber: type: integer rarityAssignedBlockNumber: type: integer openedBlockNumber: type: integer rewardAmount: $ref: '#/components/schemas/Wei' acquiredAtPackPrice: $ref: '#/components/schemas/Wei' mintTimestamp: type: string format: date-time burnTimestamp: type: string format: date-time rarityAssignedTimestamp: type: string format: date-time openedTimestamp: type: string format: date-time latestUpdateTimestamp: type: string format: date-time isVibefit: type: boolean isFirstEdition: type: boolean metadata: $ref: '#/components/schemas/MetadataItem' contract: $ref: '#/components/schemas/Game' userData: $ref: '#/components/schemas/UserSummary' Pagination: type: object required: - page - limit properties: page: type: integer minimum: 1 limit: type: integer minimum: 1 total: type: integer minimum: 0 totalPages: type: integer minimum: 0 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 RarityName: type: string enum: - NOT_ASSIGNED - COMMON - RARE - EPIC - LEGENDARY - MYTHIC - UNKNOWN TransactionHash: type: string pattern: ^0x[a-fA-F0-9]{64}$ example: '0xaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa' Wei: type: string pattern: ^[0-9]+$ description: Unsigned integer amount denominated in Wei. example: '1000000000000000' MetadataItem: allOf: - $ref: '#/components/schemas/MetadataItemInput' - type: object additionalProperties: true properties: id: type: string contractAddress: $ref: '#/components/schemas/EvmAddress' chainId: type: integer txHash: $ref: '#/components/schemas/TransactionHash' creator: $ref: '#/components/schemas/EvmAddress' metadataSource: type: string enum: - user - default isActive: type: boolean isDraft: type: boolean version: type: integer effectiveFrom: type: string format: date-time effectiveUntil: type: string format: date-time nullable: true bgColor: type: string slug: type: string featuredImageUrl: type: string format: uri disableFoil: type: boolean disableWear: type: boolean odds: type: number format: double oddsFormatted: type: string wear: $ref: '#/components/schemas/Wear' foil: $ref: '#/components/schemas/Foil' Game: type: object required: - gameId - tokenAddress - nftName - nftSymbol - ownerAddress - chainId additionalProperties: true properties: gameId: type: string tokenAddress: $ref: '#/components/schemas/EvmAddress' tokenName: type: string tokenSymbol: type: string nftName: type: string nftSymbol: type: string description: type: string imageUrl: type: string format: uri websiteUrl: type: string format: uri isGraduated: type: boolean marketCap: $ref: '#/components/schemas/Wei' marketCapUsd: description: Formatted USD value returned by the market service. oneOf: - type: string - type: number preorderProgress: type: number minimum: 0 maximum: 100 bgColor: type: string featuredImageUrl: type: string format: uri slug: type: string ownerAddress: $ref: '#/components/schemas/EvmAddress' pricePerPack: $ref: '#/components/schemas/Wei' pricePerPackUsd: oneOf: - type: string - type: number dropContractAddress: $ref: '#/components/schemas/EvmAddress' chainId: type: integer example: 8453 disableFoil: type: boolean disableWear: type: boolean packImage: type: string format: uri isActive: type: boolean links: $ref: '#/components/schemas/LinkSet' isNSFW: type: boolean isVerified: type: boolean isVerifiedArtist: type: boolean isFeatured: type: boolean isVibefit: type: boolean version: type: integer createdAt: type: string format: date-time updatedAt: type: string format: date-time potentialCards: type: array items: $ref: '#/components/schemas/MetadataItem' 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' MetadataItemInput: type: object required: - name - imageUrl - rarity properties: name: type: string minLength: 1 imageUrl: type: string format: uri unopenedImageUrl: type: string format: uri firstEditionImageUrl: type: string format: uri description: type: string rarity: $ref: '#/components/schemas/CardRarity' externalLink: type: string format: uri privateExternalLink: type: string format: uri metadataDescription: type: string traits: type: array maxItems: 20 items: $ref: '#/components/schemas/Trait' startId: type: integer minimum: 0 endId: type: integer minimum: 0 Wear: type: string enum: - Pristine - Mint - Lightly Played - Moderately Played - Heavily Played Foil: type: string enum: - None - Standard - Prize - Any Foil LinkSet: type: object properties: twitter: type: string format: uri website: type: string format: uri CardRarity: type: string enum: - Common - Rare - Epic - Legendary - Mythic Trait: type: object required: - key - value properties: key: type: string maxLength: 100 value: type: string maxLength: 100 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. ````