> ## 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.

# Get NFTs Holdings

> Retrieve all NFTs owned by a specified wallet across supported blockchains, including contract details, token metadata, ownership, and optional pagination.

## Query Details

| Parameter     | Required | Description                                                                                                |
| ------------- | -------- | ---------------------------------------------------------------------------------------------------------- |
| `wallet`      | Yes      | Wallet address whose NFTs will be retrieved.                                                               |
| `blockchains` | Cond.    | Comma-separated list of blockchains to query (e.g., `ethereum,polygon`). Defaults to all supported chains. |
| `page`        | Cond.    | Page number for paginated results.                                                                         |
| `offset`      | Cond.    | Number of records to skip before returning results.                                                        |
| `limit`       | Cond.    | Maximum number of NFTs per response.                                                                       |
| `pagination`  | Cond.    | Set to `"true"` to include pagination metadata in the response.                                            |

**Notes:**

* Either `page` or `offset` can be used for pagination.
* If `blockchains` is not provided, results include all supported chains.
* `pagination` param by default set it to \`false'.

### Step-by-Step Tutorial and Video Walkthrough

* Check out the guide: [Here](https://docs.mobula.io/guides/how-to-track-wallet-nft-holdings-using-mobula-api)

***

## Usage Examples

* Query NFTs for a wallet on **Ethereum**

```bash theme={null}
curl -X GET "https://api.mobula.io/api/1/wallet/nfts?wallet=0x3ded2644d8b82bc58f8c0be91bc10962cba90564&blockchains=ethereum"
```

* Query NFTs with **pagination enabled** across **all supported chains**:

```bash theme={null}
curl -X GET "https://demo-api.mobula.io/api/1/wallet/nfts?page=1&offset=0&limit=1&pagination=true&wallet=0x3ded2644d8b82bc58f8c0be91bc10962cba90564"
```

* Query NFTs for a wallet on **Base** and **Ethereum**

```bash theme={null}
curl -X GET "https://demo-api.mobula.io/api/1/wallet/nfts?page=1&offset=0&limit=100&pagination=false&wallet=0x3ded2644d8b82bc58f8c0be91bc10962cba90564&blockchains=evm:8453,evm:1"
```


## OpenAPI

````yaml get /1/wallet/nfts
openapi: 3.0.0
info:
  version: 1.0.0
  title: Mobula API
  description: >-
    Documentation of the Mobula API


    **Demo API**: The default server (demo-api.mobula.io) is a demo API with
    rate limits.

    For production use, please use api.mobula.io with an API key from
    https://admin.mobula.io
servers:
  - url: https://demo-api.mobula.io/api/
    description: Demo API (rate limited, for testing only)
  - url: https://api.mobula.io/api/
    description: Production API (requires API key)
security: []
tags:
  - name: V2 - Token
    description: Token details, price, security, ATH, and holder data
  - name: V2 - Market Data
    description: Market details, OHLCV history, and lighthouse metrics
  - name: V2 - Trades
    description: Token trades, enriched trades, and trade filters
  - name: V2 - Wallet
    description: Wallet positions, activity, trades, analysis, and labels
  - name: V2 - Assets
    description: Cross-chain asset details and price history
  - name: V2 - Swap
    description: Swap quoting and execution
  - name: V2 - Perps
    description: Perpetual futures quoting, execution, and positions
  - name: V2 - Bridge
    description: Cross-chain bridge quoting and intent status (Alpha Preview)
  - name: V2 - DeFi
    description: Bonding pools and pulse data
  - name: V2 - Search
    description: Universal fast search
  - name: V2 - Blockchains
    description: System metadata and chain listings
  - name: V1 - Market Data
    description: Market prices, history, sparklines, pairs, and multi-data
  - name: V1 - Wallet
    description: Wallet portfolio, transactions, history, and NFTs
  - name: V1 - Token
    description: First buyers
  - name: V1 - Trades
    description: Market trades by pair
  - name: V1 - Metadata
    description: Token metadata, categories, trendings, and news
  - name: V1 - Assets
    description: List all assets
  - name: V1 - Search
    description: Search for assets, tokens, and pairs
  - name: V1 - DeFi
    description: Bonding pool pulse data
  - name: V1 - Blockchains
    description: Blockchain listings, pairs, and stats
  - name: V1 - Webhooks
    description: Webhook management
  - name: V1 - Feed
    description: Custom feed creation
paths:
  /1/wallet/nfts:
    get:
      tags:
        - V1 - Wallet
      summary: Get wallet nfts
      parameters:
        - schema:
            type: string
            minLength: 1
            description: Wallet address
          required: true
          description: Wallet address
          name: wallet
          in: query
        - schema:
            type: string
            description: Comma-separated blockchain IDs
          required: false
          description: Comma-separated blockchain IDs
          name: blockchains
          in: query
        - schema:
            type: string
            description: 'Page number (default: 1)'
          required: false
          description: 'Page number (default: 1)'
          name: page
          in: query
        - schema:
            type: string
            description: Offset for pagination
          required: false
          description: Offset for pagination
          name: offset
          in: query
        - schema:
            type: string
            description: 'Maximum number of results (default: 100)'
          required: false
          description: 'Maximum number of results (default: 100)'
          name: limit
          in: query
      responses:
        '200':
          description: Wallet NFTs response
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: array
                    items:
                      type: object
                      properties:
                        token_address:
                          type: string
                        token_id:
                          type: string
                        token_uri:
                          type: string
                        amount:
                          type: string
                        owner_of:
                          type: string
                        name:
                          type: string
                        symbol:
                          type: string
                        blockchain:
                          type: string
                        chain_id:
                          type: string
                      required:
                        - token_address
                        - token_id
                        - token_uri
                        - amount
                        - owner_of
                        - name
                        - symbol
                        - blockchain
                        - chain_id
                  pagination:
                    type: object
                    nullable: true
                    properties:
                      total:
                        type: number
                      page:
                        type: number
                      offset:
                        type: number
                      limit:
                        type: number
                    required:
                      - total
                      - page
                      - offset
                      - limit
                required:
                  - data
                  - pagination

````