Skip to main content
GET
Get BoosterBoxes by owner

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

Path Parameters

address
string
required

The owner's Ethereum address

Query Parameters

contractAddress
string

Filter by contract address

chainId
integer

Filter by chain ID

status
enum<string>

Filter by status

Available options:
minted,
rarity_assigned,
burned
rarity
integer

Filter by rarity

Required range: 0 <= x <= 4
gameId
string

Filter by game ID

page
integer
default:1

Page number

limit
integer
default:50

Results per page

sortBy
string

Sort field

sortOrder
enum<string>

Sort order

Available options:
asc,
desc
groupBy
enum<string>

Group results

Available options:
contract
includeMetadata
boolean
default:false

Whether to include metadata

includeContractDetails
boolean
default:false

Whether to include contract details from VibeMarketGame

groupCommonRarity
boolean
default:false

Whether to group rarity=0 items by contract (max 100 tokens per group)

Response

200 - application/json

Successful response

success
boolean
boosterBoxes
object[]
pagination
object