Skip to main content
Version: 2.2

Get NFTs by wallet

Don't have an API key yet?

Start using this API for your project today.

Get your free API key
GEThttps://deep-index.moralis.io/api/v2.2/:address/nft

Get NFTs owned by a given address.

  • The response will include status [SYNCED/SYNCING] based on the contracts being indexed.
  • Use the token_address param to get results for a specific contract only
  • Note that results will include all indexed NFTs
  • Any request that includes the token_address param will start the indexing process for that NFT collection the very first time it is requested.
PATH PARAMS
addressstringrequired
The address of the wallet
QUERY PARAMS
chainstring
The chain to query
formatstring
The format of the token ID
limitnumber
The desired page size of the result.
exclude_spamboolean
Should spam NFTs be excluded from the result?
token_addressesarray
The non-fungible token (NFT) addresses to get balances for
No items in the array
cursorstring
The cursor returned in the previous response (used for getting the next page).
normalizeMetadataboolean
The option to enable metadata normalization. Learn more about metadata normalization here.
media_itemsboolean
Should preview media data be returned? Learn more about media items here.
Responses
API KEY
import Moralis from 'moralis';

try {
await Moralis.start({
apiKey: "YOUR_API_KEY"
});

const response = await Moralis.EvmApi.nft.getWalletNFTs({
"chain": "0x1",
"format": "decimal",
"mediaItems": false,
"address": "0xff3879b8a363aed92a6eaba8f61f1a96a9ec3c1e"
});

console.log(response.raw);
} catch (e) {
console.error(e);
}
Response Example
{
"status": "SYNCING",
"total": "2000",
"page": "2",
"page_size": "100",
"cursor": "",
"result": {
"token_address": "0xb47e3cd837dDF8e4c57F05d70Ab865de6e193BBB",
"token_id": "15",
"contract_type": "ERC721",
"owner_of": "0x057Ec652A4F150f7FF94f089A38008f49a0DF88e",
"block_number": "88256",
"block_number_minted": "88256",
"token_uri": "",
"metadata": "",
"normalized_metadata": "",
"media": "",
"amount": "1",
"name": "CryptoKitties",
"symbol": "RARI",
"token_hash": "502cee781b0fb40ea02508b21d319ced",
"last_token_uri_sync": "2021-02-24T00:47:26.647Z",
"last_metadata_sync": "2021-02-24T00:47:26.647Z",
"possible_spam": "false",
"verified_collection": "false"
}
}