Contract Metadata

• Learn how to query contract-level metadata directly for any contract
• Learn about contract-level metadata for ERC20, ERC721 and ERC1155 tokens

PRO TIP: Sequence Indexer also returns token metadata

When using the Sequence Indexer, pass "includeMetadata": true to your request to query token metadata for any ERC20, ERC721 or ERC1155 contract. See below how to fetch contract-level metadata directly.

Fetch contract metadata of any ERC20, ERC721 or ERC1155 contract address

Sequence Metadata GetContractInfoBatch Method:

• Request: POST /rpc/Metadata/GetContractInfoBatch
• Content-Type: application/json
• Body (in JSON):
  • chainID (string) -- the chain id, as a name or number (ie. "1" or "mainnet", "137" or "polygon", etc.)
  • contractAddresses (string of strings) -- array of contract addresses

Example: GetContractInfoBatch of some contracts on Polygon

curl

curl -X POST -H "Content-Type: application/json" https://metadata.sequence.app/rpc/Metadata/GetContractInfoBatch -d '{ "chainID": "polygon", "contractAddresses": ["0x631998e91476DA5B870D741192fc5Cbc55F5a52E", "0x17b66009af459dc8ebf37acf8a8b355379be2fe5", "0x2791bca1f2de4661ed88a30c99a7a9449aa84174", "0x2953399124f0cbb46d2cbacd8a89cf0599974963", "0x7227e371540cf7b8e512544ba6871472031f3335", "0x7c0ebabfc394ec6d926e801fe0e69a1f15a7fe4d", "0x8f3cf7ad23cd3cadbd9735aff958023239c6a063", "0xa1c57f48f0deb89f569dfbe6e2b7f46d33606fd4"] }'

Javascript / Typescript

// Works in both a Webapp (browser) or Node.js:
import { SequenceMetadataClient } from '@0xsequence/metadata'

const metadataClient = new SequenceMetadataClient()

const contractMetadata = await metadataClient.getContractInfoBatch({
  chainID: 'polygon',
  contractAddresses: [
    '0x631998e91476DA5B870D741192fc5Cbc55F5a52E',
    '0x17b66009af459dc8ebf37acf8a8b355379be2fe5',
    '0x2791bca1f2de4661ed88a30c99a7a9449aa84174',
    '0x2953399124f0cbb46d2cbacd8a89cf0599974963',
    '0x7227e371540cf7b8e512544ba6871472031f3335',
    '0x7c0ebabfc394ec6d926e801fe0e69a1f15a7fe4d',
    '0x8f3cf7ad23cd3cadbd9735aff958023239c6a063',
    '0xa1c57f48f0deb89f569dfbe6e2b7f46d33606fd4'
  ]
})

console.log('Contract info for above addresses:', contractMetadata)

Other

Please contact our team for assistance with integrations to another target.

Contract-level Metadata Standards

Additionally, OpenSea added something called contractURI (https://docs.opensea.io/docs/contract-level-metadata).