Skip to main content
GET
Get one wallet's collection holdings

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
required
Pattern: ^0x[a-fA-F0-9]{40}$
Example:

"0x1111111111111111111111111111111111111111"

chainId
integer
default:8453

EVM chain ID. Defaults to Base mainnet.

Required range: x >= 1

Response

Collection holdings. The service payload is returned directly.

Collection-service payload. Fields may expand as holdings and reward views evolve.

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

"0x1111111111111111111111111111111111111111"

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

"0x1111111111111111111111111111111111111111"

chainId
integer
boxes
object[]