NFTs By Contract

1 curl -G https://eth-mainnet.g.alchemy.com/nft/v3/ \ 2 -d contractAddress=0xe785E82358879F061BC3dcAC6f0444462D4b5330

1 { 2 "nfts": [ 3 { 4 "contract": { 5 "address": "foo", 6 "name": "foo", 7 "symbol": "foo", 8 "totalSupply": "foo", 9 "tokenType": "ERC721", 10 "contractDeployer": "foo", 11 "deployedBlockNumber": 42, 12 "openseaMetadata": { 13 "floorPrice": 42, 14 "collectionName": "foo", 15 "safelistRequestStatus": "foo", 16 "imageUrl": "foo", 17 "description": "foo", 18 "externalUrl": "foo", 19 "twitterUsername": "foo", 20 "discordUrl": "foo", 21 "lastIngestedAt": "foo" 22 }, 23 "isSpam": "foo", 24 "spamClassifications": [ 25 "foo" 26 ] 27 }, 28 "tokenId": "44", 29 "tokenType": "foo", 30 "name": "foo", 31 "description": "foo", 32 "image": { 33 "cachedUrl": "foo", 34 "thumbnailUrl": "foo", 35 "pngUrl": "foo", 36 "contentType": "foo", 37 "size": 42, 38 "originalUrl": "foo" 39 }, 40 "raw": { 41 "tokenUri": "foo", 42 "metadata": { 43 "image": "foo", 44 "name": "foo", 45 "description": "foo", 46 "attributes": [ 47 { 48 "value": "foo", 49 "trait_type": "foo" 50 } 51 ] 52 }, 53 "error": "foo" 54 }, 55 "collection": { 56 "name": "foo", 57 "slug": "foo", 58 "externalUrl": "foo", 59 "bannerImageUrl": "foo" 60 }, 61 "tokenUri": "foo", 62 "timeLastUpdated": "foo", 63 "acquiredAt": { 64 "blockTimestamp": "foo", 65 "blockNumber": "foo" 66 } 67 } 68 ], 69 "pageKey": "foo" 70 }

getNFTsForContract - Retrieves all NFTs associated with a specific NFT contract. This endpoint is supported on Ethereum and many L2s, including Polygon, Arbitrum, Optimism, Base, World Chain and more. See the full list of supported networks here.

Path parameters

apiKeystringRequired

Query parameters

contractAddressstringRequired

String - Contract address for the NFT contract (ERC721 and ERC1155 supported).

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.

startTokenstringOptional

String - A tokenID offset used for pagination. Can be a hex string, or a decimal. Users can specify the offset themselves to start from a custom offset, or to fetch multiple token ranges in parallel.

limitintegerOptional

Integer - Sets the total number of NFTs returned in the response. Defaults to 100.

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.

Response

Returns a list of NFTs associated with the specified contract address.

nftslist of objectsOptional

List of objects that represent NFTs stored under the queried contract address.

pageKeystringOptional

String - An offset used for pagination. Can be passed back as the “startToken” of a subsequent request to get the next page of results. Absent if there are no more results.