Existing Contract Integration with OpenSea (Mainnet)

Integrate an existing mainnet ERC721 project into OpenSea

This page is designed for developers who have already written their ERC721 contract and wish to integrate it with OpenSea. However, if you're starting fresh, we recommend following the official OpenSea Developer Tutorial.

Viewing your existing items on OpenSea

Good news! If you've deployed your ERC721 contract on the Ethereum mainnet, your items are already tradeable on OpenSea. Just go to our listing flow to view your storefront.

Metadata API

If you haven't complied to the ERC721 metadata standards, your items may not show up on OpenSea as intended: they may be missing images, names, or descriptions. To fix this, you can provide OpenSea with a metadata API that provides this info. You can see all of the details on the exact format for this API here. An example API response would look like this:

  "description": "Friendly OpenSea Creature that enjoys long swims in the ocean.", 
  "external_url": "https://openseacreatures.io/3", 
  "image": "https://storage.googleapis.com/opensea-prod.appspot.com/puffs/3.png", 
  "name": "Dave Starbelly",
  "attributes": [ ... ], 

Typically, OpenSea use the tokenURI method in ERC721 to find the metadata API for items (you can learn about exactly how this works here). However, if you've already deployed your contract and didn't implement this method, reach out to our Help Center with an API URL you have set up that returns metadata and has the format:


While your API can have any URL, it is important that it takes in a token ID and returns data in the format described here.