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.

addressstringOptional

String - Contract address for the queried NFT collection

namestringOptional

String - NFT contract name.

symbolstringOptional

String - NFT contract symbol abbreviation.

totalSupplystringOptional

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

tokenTypeenumOptional

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:
contractDeployerstringOptional

String - Address that deployed the smart contract

deployedBlockNumberdoubleOptional

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

openseaMetadataobjectOptional

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.