Skip to main content
The Get NFTs Holdings 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.

​
What this endpoint does

With this API, you can:
  • Retrieve all NFTs owned by a wallet across supported blockchains
  • 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 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. If you want wallet activity events (transfers/swaps), use wallet/activity.

​
Walkthrough to Get NFTs Holdings for a Wallet

​
1. Prepare your query

The wallet/nfts endpoint requires one parameter to work:
ParameterDescription
walletWallet 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 Wallet NFTs Demo UI Docs

​
Summary

The Get NFTs Holdings 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