Contract Metadata By Address [Batch]

1 import requests 2 3 url = "https://eth-mainnet.g.alchemy.com/nft/v3/docs-demo/getContractMetadataBatch" 4 5 payload = {} 6 headers = {"Content-Type": "application/json"} 7 8 response = requests.post(url, json=payload, headers=headers) 9 10 print(response.json())

1 [ 2 { 3 "address": "foo", 4 "name": "foo", 5 "symbol": "foo", 6 "totalSupply": "foo", 7 "tokenType": "ERC721", 8 "contractDeployer": "foo", 9 "deployedBlockNumber": 42, 10 "openseaMetadata": { 11 "floorPrice": 42, 12 "collectionName": "foo", 13 "safelistRequestStatus": "foo", 14 "imageUrl": "foo", 15 "description": "foo", 16 "externalUrl": "foo", 17 "twitterUsername": "foo", 18 "discordUrl": "foo", 19 "lastIngestedAt": "foo" 20 } 21 } 22 ]

getContractMetadataBatch - Retrieves metadata for a list of specified contract addresses in a single request.

Path parameters

apiKeystringRequired

Request

This endpoint expects an object.

contractAddresseslist of stringsOptional

List of contract addresses to batch metadata requests for.

Response

Returns an array of contract metadata corresponding to the batch query.

addressstring or null

String - Contract address for the queried NFT collection

namestring or null

String - NFT contract name.

symbolstring or null

String - NFT contract symbol abbreviation.

totalSupplystring or null

String - Total number of NFTs in a given NFT collection.

tokenTypeenum or null

String - For valid NFTs, ‘ERC721’ or ‘ERC1155.’ For invalid NFTs, a descriptive reason such as ‘NO_SUPPORTED_NFT_STANDARD’ if the input contract address doesn’t support a known NFT standard, or ‘NOT_A_CONTRACT’ if there is no contract deployed at the input address.

Allowed values:

contractDeployerstring or null

String - Address that deployed the smart contract

deployedBlockNumberdouble or null

Number - The Block Number when the deployment transaction is successfully mined

openseaMetadataobject or null

Note that the OpenSea metadata object is currently only available on ETH and Polygon Mainnet. Please reach out to us at [email protected] if you would like to access this data on other networks.