NFT APINft Metadata Endpoints

Contract Metadata By Address

getContractMetadata - Retrieves high-level collection or contract-level information for an NFT. 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).

Response

Returns the contract metadata for the specified address.
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.