Skip to main content

Contract Metadata


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" -d '{ "chainID": "polygon", "contractAddresses": ["0x631998e91476DA5B870D741192fc5Cbc55F5a52E", "0x17b66009af459dc8ebf37acf8a8b355379be2fe5", "0x2791bca1f2de4661ed88a30c99a7a9449aa84174", "0x2953399124f0cbb46d2cbacd8a89cf0599974963", "0x7227e371540cf7b8e512544ba6871472031f3335", "0x7c0ebabfc394ec6d926e801fe0e69a1f15a7fe4d", "0x8f3cf7ad23cd3cadbd9735aff958023239c6a063", "0xa1c57f48f0deb89f569dfbe6e2b7f46d33606fd4"] }'

Contract-level Metadata Standards

Additionally, OpenSea added something called contractURI (