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

# How to Track Wallet NFT Holdings Across Ethereum, Solana, Base & More

> Easily retrieve all NFTs owned by a wallet across supported blockchains using the Mobula API.

The [**Get NFTs Holdings**](https://docs.mobula.io/rest-api-reference/endpoint/wallet-nfts) endpoint returns a wallet’s NFT inventory, including token metadata, ownership details, and optional pagination. It is ideal for developers building **NFT portfolio dashboards**, **wallet explorers**, **NFT gating tools**, and **on-chain identity or collector analytics**.

***

<div style={{ position: 'relative', paddingBottom: '56.25%', height: 0, overflow: 'hidden' }}>
  <iframe src="https://www.youtube.com/embed/NGog--b3EDY" title="YouTube video player" style={{ position: 'absolute', top: 0, left: 0, width: '100%', height: '100%', border: 0 }} allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" allowFullScreen />
</div>

***

## What this endpoint does

With this API, you can:

* Retrieve all NFTs owned by a wallet across supported blockchains like [Solana](https://docs.mobula.io/blockchains/solana), [Ethereum](https://docs.mobula.io/blockchains/ethereum) and more
* Filter results by specific chains using `blockchains`
* Paginate through large NFT inventories using `page` or `offset`
* Control response size using `limit`
* Optionally include pagination metadata using `pagination=true`

Unlike collection-specific tools, this endpoint focuses on **wallet-level NFT ownership**.

***

## What you’ll need

* Basic knowledge of REST APIs
* A wallet address
* A Mobula API key

Note: All Mobula endpoints require an API key.\
Get a free API key: [Here](https://admin.mobula.io/)

Optional:

* NFTScan (to find wallets that hold NFTs)

***

## When to use Get NFTs Holdings

Use this endpoint when you want to:

* Display a wallet’s NFT holdings in an NFT portfolio page
* Build NFT ownership lookups for wallet-based user profiles
* Add NFT-based features to dashboards (collector insights, inventory, gating)
* Paginate large NFT collections in a wallet efficiently
* Filter by chain to speed up queries and reduce noise

If you want historical wallet net worth, use [**wallet/history**](https://docs.mobula.io/rest-api-reference/endpoint/wallet-history).

If you want wallet activity events (transfers/swaps), use [**wallet/activity**](https://docs.mobula.io/rest-api-reference/endpoint/wallet-activity).

***

## Walkthrough to Get NFTs Holdings for a Wallet

### 1. Prepare your query

The `wallet`/`nfts` endpoint requires one parameter to work:

| Parameter | Description               |
| --------- | ------------------------- |
| `wallet`  | Wallet address to analyze |

Optional parameters you can use to control output:

* `blockchains`: comma-separated list of chains (defaults to all supported chains)
* `limit`: maximum number of NFTs returned per response
* `page`: page number for pagination
* `offset`: number of records to skip (alternative to page)
* `pagination`: set to `true` to include pagination metadata (default is false)

Note: either `page` or `offset` can be used for pagination.

### 2. Find a wallet address to test

To retrieve real wallet data:

* Open NFTScan
* Search for any NFT collection you want
* Open the holders list for that collection
* Select an active holder wallet
* Copy the wallet address

This address is used as the `wallet` parameter.

### 3. Configure pagination (optional)

If the wallet holds many NFTs:

* Use `limit` to control how many NFTs are returned per request
* Use `page` or `offset` to move through the full NFT inventory
* Set `pagination=true` to include pagination metadata in the response

### 4. Fill the API form

Once the wallet address is filled (and optional filters are set), click **Send** to retrieve the wallet’s NFT holdings.

***

## Reviewing the wallet NFTs response

The response returns:

* `data[]`: the list of NFTs owned by the wallet
* `pagination`: pagination metadata (only when enabled)
* `NFT metadata`

What you can build with this data:

* A wallet NFT inventory list (collection name, token IDs, contract address)
* Wallet-level NFT ownership views for dashboards
* Paginated NFT galleries for wallets with large holdings

***

## Try It Live with Mobula Wallet NFTs Demo (UI)

You can also test this endpoint using our demo UI:

[Demo UI Homepage](https://mobula-demo-endpoint-production.up.railway.app/)

[Wallet NFTs Demo UI](https://mobula-demo-endpoint-production.up.railway.app/wallet-nfts)

[Docs](https://docs.mobula.io/rest-api-reference/endpoint/wallet-nfts)

***

## Summary

The [**Get NFTs Holdings**](https://docs.mobula.io/rest-api-reference/endpoint/wallet-nfts) endpoint makes it easy to fetch wallet NFT ownership across chains, with support for:

* Multi-chain NFT holdings via `blockchains`
* Pagination with `limit`, `page`, and `offset`
* Optional pagination metadata using `pagination=true`
* A clean response format suitable for NFT dashboards and wallet explorers

If you’re building NFT portfolio tools or wallet-based NFT experiences, this endpoint is the right choice.

***

## Try Mobula for Free

Try our free API today and start building in minutes.\
Get your free API key: [Here](https://admin.mobula.io/)