Skip to main content
GET
/
1
/
wallet
/
nfts
Get wallet nfts
curl --request GET \
  --url https://demo-api.mobula.io/api/1/wallet/nfts
{
  "data": [
    {
      "token_address": "<string>",
      "token_id": "<string>",
      "token_uri": "<string>",
      "amount": "<string>",
      "owner_of": "<string>",
      "name": "<string>",
      "symbol": "<string>",
      "blockchain": "<string>",
      "chain_id": "<string>"
    }
  ],
  "pagination": {
    "total": 123,
    "page": 123,
    "offset": 123,
    "limit": 123
  }
}

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.

​
Query Details

ParameterRequiredDescription
walletYesWallet address whose NFTs will be retrieved.
blockchainsCond.Comma-separated list of blockchains to query (e.g., ethereum,polygon). Defaults to all supported chains.
pageCond.Page number for paginated results.
offsetCond.Number of records to skip before returning results.
limitCond.Maximum number of NFTs per response.
paginationCond.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

​
Usage Examples

  • Query NFTs for a wallet on Ethereum
curl -X GET "https://api.mobula.io/api/1/wallet/nfts?wallet=0x3ded2644d8b82bc58f8c0be91bc10962cba90564&blockchains=ethereum"
  • Query NFTs with pagination enabled across all supported chains:
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
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"

Query Parameters

​
wallet
string
required

Wallet address

Minimum string length: 1
​
blockchains
string

Comma-separated blockchain IDs

​
page
string

Page number (default: 1)

​
offset
string

Offset for pagination

​
limit
string

Maximum number of results (default: 100)

Response

200 - application/json

Wallet NFTs response

​
data
object[]
required
​
pagination
object
required