getNFTsForCollection | Alchemy Docs

1 curl https://eth-mainnet.g.alchemy.com/nft/v2/

1 { 2 "nfts": [ 3 { 4 "id": { 5 "tokenId": "44", 6 "tokenMetadata": { 7 "tokenType": "ERC721" 8 } 9 }, 10 "tokenUri": { 11 "raw": "foo", 12 "gateway": "foo" 13 }, 14 "metadata": { 15 "image": "foo", 16 "external_url": "foo", 17 "background_color": "foo", 18 "name": "foo", 19 "description": "foo", 20 "attributes": [ 21 { 22 "value": "foo", 23 "trait_type": "foo" 24 } 25 ], 26 "media": [ 27 { 28 "raw": "foo", 29 "gateway": "foo", 30 "thumbnail": "foo", 31 "format": "foo", 32 "bytes": 42 33 } 34 ] 35 }, 36 "timeLastUpdated": "foo", 37 "contractMetadata": { 38 "name": "foo", 39 "symbol": "foo", 40 "totalSupply": "foo", 41 "tokenType": "ERC721", 42 "contractDeployer": "foo", 43 "deployedBlockNumber": 42, 44 "opensea": { 45 "floorPrice": 42, 46 "collectionName": "foo", 47 "safelistRequestStatus": "foo", 48 "imageUrl": "foo", 49 "description": "foo", 50 "externalUrl": "foo", 51 "twitterUsername": "foo", 52 "discordUrl": "foo", 53 "lastIngestedAt": "foo" 54 } 55 } 56 } 57 ], 58 "nextToken": "foo" 59 }

Gets all NFTs for a given NFT contract.

Path parameters

apiKeystringRequired

Query parameters

contractAddressstringOptionalDefaults to 0xe785E82358879F061BC3dcAC6f0444462D4b5330

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

collectionSlugstringOptionalDefaults to boredapeyachtclub

String - OpenSea slug for the NFT collection.

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

nftslist of objectsOptional

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

nextTokenstringOptional

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.