> ## Documentation Index
> Fetch the complete documentation index at: https://catchbackcards.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# List a wallet's tokens

> The live tokens of your program that a wallet holds, newest first, each with what a sell-back would pay right now.

Scope: `nft:orders`

The live tokens of your program that a wallet holds, newest first, each with what a sell-back would pay right now.

* Ownership comes from our chain watcher, so a transfer shows up within a few minutes. A quote always re-reads the owner on chain.
* At most 200 tokens are returned; `truncated: true` means there are more.

**address** `string` *required*

A wallet address on your mint chain.

## Response

**holder** `string`

The address, normalized (EVM lowercase).

**tokens** `object[]`

**token**

**chain** `string`

**contract** `string`

EVM. On a Solana program, `collection` and `asset` instead.

**token\_id** `string`

Decimal. Keep it as a string or bigint.

**status** `string`

The mint status; a token that is not yet `confirmed` can't be quoted.

**card** `object`

`id`, `category` and `name` of the item.

**minted\_at** `string`

**sellback** `object`

Indicative; only a [quote](https://catchbackcards.mintlify.site/partner-api/v2/endpoints/create-sellback-quote.md) fixes the amount. `amount`, `rate`, `fresh` (true inside the fresh window) and `locked_until` (when the value lock ends). See [Sell-back](https://catchbackcards.mintlify.site/partner-api/v2/sell-back.md#what-a-sell-back-pays).

**truncated** `boolean`

True when the wallet holds more than the 200 tokens returned.

## Errors

| Status | Code | When |
| - | - | - |
| `400` | `BAD_ADDRESS` | `{address}` is not an address on your mint chain |

```bash cURL theme={null}
curl https://catchbackcards.com/api/partner/v2/wallets/0x8f3c...e21a/tokens \
  -H "Authorization: Bearer $CATCHBACK_KEY"
```

```json 200 theme={null}
{
  "holder": "0x8f3c...e21a",
  "tokens": [
    {
      "chain": "evm:196",
      "contract": "0x7b1e...c0de",
      "token_id": "81264573985362058461377125337283195667",
      "status": "confirmed",
      "card": { "id": "a1c4...", "category": "pokemon", "name": "Charizard ex 199/165 PSA 10" },
      "minted_at": "2026-11-16T18:04:45.110Z",
      "sellback": { "amount": 330, "rate": 0.8, "fresh": false, "locked_until": "2026-11-23T18:04:41.317Z" }
    }
  ],
  "truncated": false
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.