Skip to main content

Contract Metadata

INTRODUCING THE SEQUENCE BUILDER - https://sequence.build

Our Metadata service is now managed through Sequence Builder. Sign up to grab your API access key.

Get started with the Sequence Builder Free Plan today!

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 using an c3bgcU3LkFR9Bp9jFssLenPAAAAAAAAAA

This code requires an API Access Key from Sequence Builder.
curl -X POST -H "Content-Type: application/json" -H "X-Access-Key: c3bgcU3LkFR9Bp9jFssLenPAAAAAAAAAA" https://metadata.sequence.app/rpc/Metadata/GetContractInfoBatch -d '{ "chainID": "polygon", "contractAddresses": ["0x631998e91476DA5B870D741192fc5Cbc55F5a52E", "0x17b66009af459dc8ebf37acf8a8b355379be2fe5", "0x2791bca1f2de4661ed88a30c99a7a9449aa84174", "0x2953399124f0cbb46d2cbacd8a89cf0599974963", "0x7227e371540cf7b8e512544ba6871472031f3335", "0x7c0ebabfc394ec6d926e801fe0e69a1f15a7fe4d", "0x8f3cf7ad23cd3cadbd9735aff958023239c6a063", "0xa1c57f48f0deb89f569dfbe6e2b7f46d33606fd4"] }'

Contract-level Metadata Standards

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