getNFTs | Alchemy Docs

Gets all NFTs currently owned by a given address.

Path parameters

apiKeystringRequiredDefaults to docs-demo

Query parameters

ownerstringRequiredDefaults to 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045

String - Address for NFT owner (can be in ENS format for Eth Mainnet).

contractAddresses[]list of stringsOptional

Array of contract addresses to filter the responses with. Max limit 45 contracts.

withMetadatabooleanOptionalDefaults to true

Boolean - if set to true, returns NFT metadata. Setting this to false will reduce payload size and may result in a faster API call. Defaults to true.

orderByenumOptional

Enum - ordering scheme to use for ordering NFTs in the response. If unspecified, NFTs will be ordered by contract address and token ID.

transferTime: NFTs will be ordered by the time they were transferred into the wallet, with newest NFTs first. NOTE: this ordering is only supported on Ethereum Mainnet and Polygon Mainnet.

Enum - ordering scheme to use for ordering NFTs in the response. If unspecified, NFTs will be ordered by contract address and token ID. - transferTime: NFTs will be ordered by the time they were transferred into the wallet, with newest NFTs first. NOTE: this ordering is only supported on Ethereum Mainnet and Polygon Mainnet.

Allowed values:

excludeFilters[]list of enumsOptional

SPAM: NFTs that have been classified as spam. Spam classification has a wide range of criteria that includes but is not limited to emitting fake events and copying other well-known NFTs. Please note that this filter is currently supported on Mainnet for Base, Arbitrum, Optimism, Ethereum, Polygon, Worldchain, Avax, Gnosis, Zksync, and Blast, and is available exclusively on paid tiers.
AIRDROPS: NFTs that have were airdropped to the user. Airdrops are defined as NFTs that were minted to a user address in a transaction sent by a different address. NOTE: this filter is currently supported on Ethereum Mainnet, Ethereum Goerli, and Matic Mainnet only.
To learn more about spam, you can refer to this: Spam NFTs and how to fix them

Array of filters (as ENUMS) that will be applied to the query. NFTs that match one or more of these filters will be excluded from the response. May not be used in conjunction with includeFilters[]. Filter Options: - SPAM: NFTs that have been classified as spam. Spam classification has a wide range of criteria that includes but is not limited to emitting fake events and copying other well-known NFTs. Please note that this filter is currently supported on Mainnet for Base, Arbitrum, Optimism, Ethereum, Polygon, Worldchain, Avax, Gnosis, Zksync, and Blast, and is **available exclusively on paid tiers**. - AIRDROPS: NFTs that have were airdropped to the user. Airdrops are defined as NFTs that were minted to a user address in a transaction sent by a different address. NOTE: this filter is currently supported on Ethereum Mainnet, Ethereum Goerli, and Matic Mainnet only. - To learn more about spam, you can refer to this: <span class="custom-style"><a href="https://www.alchemy.com/overviews/spam-nfts" target="_blank">Spam NFTs and how to fix them</a></span>

Allowed values:

includeFilters[]list of enumsOptional

SPAM: NFTs that have been classified as spam. Spam classification has a wide range of criteria that includes but is not limited to emitting fake events and copying other well-known NFTs. Please note that this filter is currently supported on Mainnet for Base, Arbitrum, Optimism, Ethereum, Polygon, Worldchain, Avax, Gnosis, Zksync, and Blast, and is available exclusively on paid tiers.
AIRDROPS: NFTs that have were airdropped to the user. Airdrops are defined as NFTs that were minted to a user address in a transaction sent by a different address. NOTE: this filter is currently supported on Ethereum Mainnet, Ethereum Goerli, and Matic Mainnet only.
To learn more about spam, you can refer to this: Spam NFTs and how to fix them

Array of filters (as ENUMS) that will be applied to the query. Only NFTs that match one or more of these filters will be included in the response. May not be used in conjunction with excludeFilters[]. Filter Options: - SPAM: NFTs that have been classified as spam. Spam classification has a wide range of criteria that includes but is not limited to emitting fake events and copying other well-known NFTs. Please note that this filter is currently supported on Mainnet for Base, Arbitrum, Optimism, Ethereum, Polygon, Worldchain, Avax, Gnosis, Zksync, and Blast, and is **available exclusively on paid tiers**. - AIRDROPS: NFTs that have were airdropped to the user. Airdrops are defined as NFTs that were minted to a user address in a transaction sent by a different address. NOTE: this filter is currently supported on Ethereum Mainnet, Ethereum Goerli, and Matic Mainnet only. - To learn more about spam, you can refer to this: <span class="custom-style"><a href="https://www.alchemy.com/overviews/spam-nfts" target="_blank">Spam NFTs and how to fix them</a></span>

Allowed values:

spamConfidenceLevelenumOptional

Enum - the confidence level at which to filter spam at.

Confidence Levels:

VERY_HIGH
HIGH
MEDIUM
LOW

The confidence level set means that any spam that is at that confidence level or higher will be filtered out. For example, if the confidence level is HIGH, contracts that we have HIGH or VERY_HIGH confidence in being spam will be filtered out from the response. Defaults to VERY_HIGH for Ethereum Mainnet and MEDIUM for Matic Mainnet.

Please note that this filter is only available on paid tiers. Upgrade your account here.

Enum - the confidence level at which to filter spam at. Confidence Levels: - VERY_HIGH - HIGH - MEDIUM - LOW The confidence level set means that any spam that is at that confidence level or higher will be filtered out. For example, if the confidence level is HIGH, contracts that we have HIGH or VERY_HIGH confidence in being spam will be filtered out from the response. Defaults to VERY_HIGH for Ethereum Mainnet and MEDIUM for Matic Mainnet. **Please note that this filter is only available on paid tiers. Upgrade your account [here](https://dashboard.alchemyapi.io/settings/billing/).**

Allowed values:

tokenUriTimeoutInMsintegerOptional

No set timeout by default - When metadata is requested, this parameter is the timeout (in milliseconds) for the website hosting the metadata to respond. If you want to only access the cache and not live fetch any metadata for cache misses then set this value to 0.

pageKeystringOptional

String - key for pagination. If more results are available, a pageKey will be returned in the response. Pass back the pageKey as a param to fetch the next page of results.

pageSizeintegerOptionalDefaults to 100

Number of NFTs to be returned per page. Defaults to 100. Max is 100.

Response

Returns the list of all NFTs owned by the given address and satisfying the given input parameters.

ownedNftslist of objects or null

pageKeystring or null

totalCountinteger or null

Integer - Total number of NFTs (distinct tokenIds) owned by the given address.

blockHashstring or null

String - The canonical head block hash of when your request was received i.e. the block corresponding to latest

SPAM: NFTs that have been classified as spam. Spam classification has a wide range of criteria that includes but is not limited to emitting fake events and copying other well-known NFTs. Please note that this filter is currently supported on Mainnet for Base, Arbitrum, Optimism, Ethereum, Polygon, Worldchain, Avax, Gnosis, Zksync, and Blast, and is available exclusively on paid tiers.
AIRDROPS: NFTs that have were airdropped to the user. Airdrops are defined as NFTs that were minted to a user address in a transaction sent by a different address. NOTE: this filter is currently supported on Ethereum Mainnet, Ethereum Goerli, and Matic Mainnet only.
To learn more about spam, you can refer to this: Spam NFTs and how to fix them

1	{
2	"ownedNfts": [
3	{
4	"contract": {
5	"address": "0x0beed7099af7514ccedf642cfea435731176fb02"
6	},
7	"id": {
8	"tokenId": "28",
9	"tokenMetadata": {
10	"tokenType": "ERC721"
11	}
12	},
13	"title": "DuskBreaker #28",
14	"description": "Breakers have the honor of serving humanity through their work on The Dusk. They are part of a select squad of 10,000 recruits who spend their days exploring a mysterious alien spaceship filled with friends, foes, and otherworldly technology.",
15	"tokenUri": {
16	"raw": "https://duskbreakers.gg/api/breakers/28",
17	"gateway": "https://duskbreakers.gg/api/breakers/28"
18	},
19	"media": {
20	"0": {
21	"raw": "https://duskbreakers.gg/breaker_images/28.png",
22	"gateway": "https://duskbreakers.gg/breaker_images/28.png"
23	}
24	},
25	"metadata": {
26	"image": "https://duskbreakers.gg/breaker_images/28.png",
27	"external_url": "https://duskbreakers.gg",
28	"name": "DuskBreaker #28",
29	"description": "Breakers have the honor of serving humanity through their work on The Dusk. They are part of a select squad of 10,000 recruits who spend their days exploring a mysterious alien spaceship filled with friends, foes, and otherworldly technology.",
30	"attributes": [
31	{
32	"value": "Locust Rider Armor (Red)",
33	"trait_type": "Clothes"
34	},
35	{
36	"value": "Big Smile (Purple)",
37	"trait_type": "Mouth"
38	},
39	{
40	"value": "Yellow",
41	"trait_type": "Background"
42	}
43	]
44	},
45	"timeLastUpdated": "2022-02-16T22:52:54.719Z",
46	"contractMetadata": {
47	"name": "DuskBreakers",
48	"symbol": "DUSK",
49	"totalSupply": "10000",
50	"tokenType": "ERC721"
51	}
52	},
53	{
54	"contract": {
55	"address": "0x97597002980134bea46250aa0510c9b90d87a587"
56	},
57	"id": {
58	"tokenId": "5527",
59	"tokenMetadata": {
60	"tokenType": "ERC721"
61	}
62	},
63	"title": "Runner #5527",
64	"description": "Chain Runners are Mega City renegades 100% generated on chain.",
65	"tokenUri": {
66	"raw": "https://api.chainrunners.xyz/tokens/metadata/5527?dna=73247164192459371523281785218958151913554625578441142916970699984935810987041",
67	"gateway": "https://api.chainrunners.xyz/tokens/metadata/5527?dna=73247164192459371523281785218958151913554625578441142916970699984935810987041"
68	},
69	"media": {
70	"0": {
71	"raw": "https://img.chainrunners.xyz/api/v1/tokens/png/5527",
72	"gateway": "https://img.chainrunners.xyz/api/v1/tokens/png/5527"
73	}
74	},
75	"metadata": {
76	"image": "https://img.chainrunners.xyz/api/v1/tokens/png/5527",
77	"name": "Runner #5527",
78	"description": "Chain Runners are Mega City renegades 100% generated on chain.",
79	"attributes": [
80	{
81	"value": "Purple Green Diag",
82	"trait_type": "Background"
83	},
84	{
85	"value": "Human",
86	"trait_type": "Race"
87	},
88	{
89	"value": "Cig",
90	"trait_type": "Mouth Accessory"
91	}
92	]
93	},
94	"timeLastUpdated": "2022-02-18T00:42:04.401Z",
95	"contractMetadata": {
96	"name": "Chain Runners",
97	"symbol": "RUN",
98	"totalSupply": "10000",
99	"tokenType": "ERC721"
100	}
101	}
102	],
103	"totalCount": 6,
104	"blockHash": "0xeb2d26af5b6175344a14091777535a2cb21c681665a734a8285f889981987630"
105	}

1	curl -G https://eth-mainnet.g.alchemy.com/nft/v2/docs-demo/getNFTs \
2	-d owner=0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045