/api/v1/wallets/:address/holdings packs:read The read behind a "you hold this prize: redeem it, or keep it" screen. Unlike GET /mystery/collection, which walks YOUR purchases, this walks the WALLET — so a prize you sent, which has no purchase behind it, appears here. Each row carries the one fact the holder needs next: whether it can be redeemed now, whether a redemption is already running, and whether it can be sold back.
GET /api/v1/wallets/0x0000000000000000000000000000000000000000/holdings?limit=10 These inputs are shared across all docs pages, so an id entered here carries over.
{
"success": false,
"message": "Mystery partner API key required",
"error": "This endpoint requires an API key linked to a mystery partner account"
}curl -X GET 'https://service.rip.fun/api/v1/wallets/0x0000000000000000000000000000000000000000/holdings?limit=10' \ -H 'X-API-Key: rip_…'
| Field | Type | Required | Description |
|---|---|---|---|
item_type | query | — | CARD | GRADED_CARD | SEALED_PRODUCT — omit for everything |
limit / offset | query | — | 1-100 (default 50) and 0-10000 |
data)| Field | Description |
|---|---|
holdings[].item_type / token_id / unique_id / contract_address | What it is and where it lives on chain |
holdings[].redeem_status | REDEEMABLE (on-chain, unburned, redeemable now) · REDEEMING (a redemption of yours is live) · REDEEMED (burned — the physical item shipped) · NOT_REDEEMABLE (listed, mid-open, or not on chain) |
holdings[].redemption | The live redemption's id and status, or null. Partner-scoped — another partner's in-flight redemption is not disclosed to you |
holdings[].buyback | { eligible, expires_at } for cards and slabs, from the indexed sell-back window. eligible:false with a window present means the window names somebody else. null for a sealed product, which has no window |
holdings[].name / image_url / value_usd / grade / grading_company | Catalog hydration for display |
| Status | Code | When |
|---|---|---|
| 400 | invalid_wallet_address | the :address segment is not a 0x-prefixed wallet address |
| 400 | invalid_item_type | item_type is not one of the three |
See Errors for the response envelope and the full code list.