Skip to main content
GET
List packs owned by a wallet

Authorizations

API-KEY
string
header
required

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

Headers

X-Bypass-Image-Proxy
boolean
default:false

Set to true to keep original recognized CDN URLs instead of vibe.market proxy URLs. Cache this response variant separately.

Path Parameters

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

"0x1111111111111111111111111111111111111111"

Query Parameters

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

"0x1111111111111111111111111111111111111111"

chainId
integer
default:8453

EVM chain ID. Defaults to Base mainnet.

Required range: x >= 1
status
enum<string>
Available options:
minted,
opened,
rarity_assigned,
burned
rarity
integer

0 not assigned, 1 Common, 2 Rare, 3 Epic, 4 Legendary, 5 Mythic.

Required range: 0 <= x <= 5
gameId
string
wear
enum<string>
Available options:
Pristine,
Mint,
Lightly Played,
Moderately Played,
Heavily Played
foil
enum<string>
Available options:
None,
Standard,
Prize,
Any Foil
page
integer
default:1
Required range: x >= 1
limit
integer
default:20

Page size. Endpoint-specific validation may impose a lower maximum.

Required range: x >= 1
sortBy
enum<string>
default:mintBlockNumber
Available options:
mintBlockNumber,
latestUpdateTimestamp,
marketCap
sortOrder
enum<string>
default:desc
Available options:
asc,
desc
includeMetadata
boolean
default:false
includeContractDetails
boolean
default:false
groupCommonRarity
boolean
default:false
groupBy
enum<string>
Available options:
contract
isVibefit
boolean

Response

Flat or grouped owner inventory

success
enum<boolean>
required
Available options:
true
grouped
boolean
required
boxes
object
required
pagination
object
required
groupBy
enum<string> | null
Available options:
contract,
commonRarity