Skip to main content
GET
List the collectibles a wallet has
Pull details. pull is present only for this wallet’s current draw through your integration. Other owned cards return pull: null. A card leaves the collection when sold, bought back, transferred away or redeemed. If a contract wallet permanently fails to accept delivery, the card leaves the list and totals without a refund or a delivery-failure activity.Pagination. tokenIds filters the list before sorting, paging and calculating pagination.total. The wallet summary always uses the full collection. Query the signer and its Safe separately. Renaiss custody wallets return an empty list.

Request

Builder key required

Response

Error codes

Match the HTTP status and response text to a row below. For guidance on codes shared across endpoints, see Error meanings and recovery.

Authorizations

x-builder-api-key
string
header
required

Your approved builder API key. Keep it on your backend. Gacha and marketplace writes also require wallet action signatures. Redeem also needs a wallet access token, a Bearer token the API issues after the wallet signs a sign-in message.

Path Parameters

walletAddress
string
required

The wallet to read. Exactly this address.

Query Parameters

sortBy
enum<string>
default:pulledAt

pulledAt: when the wallet pulled the collectible with your builder key. rixPriceInUsd: its RIX price (estimated fair market value, or FMV). buybackExpiresAt: when its current buyback tier ends, the expiresAt of the first tier in state.buybackTiers that has not passed; a later tier can remain available. A collectible without the value sorts last in both directions.

Available options:
pulledAt,
rixPriceInUsd,
buybackExpiresAt
sortOrder
enum<string>
default:desc
Available options:
asc,
desc
limit
integer
default:20
Required range: 1 <= x <= 100
offset
integer | null
default:0
Required range: 0 <= x <= 10000
tokenIds
string[]

Up to 20 collectible token ids as decimal strings. Comma-separate (?tokenIds=1,2) or repeat for several. Values are trimmed, blanks removed and duplicate strings collapsed before the limit is checked. Omitted or empty means no filter. Filters before sorting and paging: pagination.total counts the filtered list. A token id the list does not hold returns nothing for it.

Pattern: ^\d+$

Response

Success

collectibles
object[]
required
pagination
object
required