Skip to main content
GET
Get BoosterBoxes by range or token IDs

Headers

API-KEY
string
default:DEMO_REPLACE_WITH_FREE_API_KEY
required

Free API key needed to authorize requests. Get one at: https://docs.vibechain.com/api-reference/vibemarket-intro

Query Parameters

contractAddress
string
required

The contract address

tokenIds
string

Comma-separated list of token IDs

startTokenId
integer

Start of token ID range

endTokenId
integer

End of token ID range

chainId
integer

The chain ID

status
enum<string>

Filter by status

Available options:
minted,
rarity_assigned,
burned
rarity
integer

Filter by rarity

Required range: 0 <= x <= 4
page
integer
default:1

Page number

limit
integer
default:50

Results per page

sortBy
string
default:latestUpdateTimestamp

Sort field

sortOrder
enum<string>
default:desc

Sort order

Available options:
asc,
desc
includeMetadata
boolean
default:false

Whether to include metadata

includeContractDetails
boolean
default:false

Whether to include contract details from VibeMarketGame

Response

200 - application/json

Successful response

success
boolean
boosterBoxes
object[]
pagination
object