Frequently Asked Questions
Everything you need to know about OpenSea
- What is OpenSea? +OpenSea is a decentralized marketplace for crypto assets, which include collectibles, gaming items, and other digital goods that are backed by a blockchain like Ethereum. On OpenSea, you can buy or sell any of these items through a smart contract, meaning that no central authority ever holds custody of your items. You can even check out the source code for this smart contract here.
- What can I do on OpenSea? +OpenSea lets you buy and sell crypto collectibles, gaming items, and other blockchain-based digital items. To start, you can go to your account page to view all of your items (OpenSea supports over 60 different item types, and growing!) If you want to sell one on the market, simply click into it and click "Sell".
Additionally, OpenSea is often useful for browsing the many types of digital collectibles. We offer a powerful searching and sorting mechanisms that lets you easily find the items you're looking for.
- What exactly are these items I see on OpenSea? +All of the items you see on OpenSea are blockchain-based digital items. Some people like to call them non-fungible tokens, or NFT's. Each item is uniquely owned by an Ethereum address and live on the blockchain. Excitingly, they can be viewed anywhere, exchanged openly, and truly owned in a way that was never before possible in the digital world. You can read a little more about the idea of true digital ownership in this blog post.
- What if I want to create my own item on the blockchain? +Glad you asked! If you're developing your own smart contract for a game, digital collectible, or some other project with unique digital items on the blockchain, you can easily get added to the OpenSea marketplace. Just follow the steps in the OpenSea developer documentation. More info on what OpenSea provides can be found on our developer page.
If you're a creator, influencer, or streamer and wish to list something on OpenSea, reach out to us at [email protected].
- What do I need to use OpenSea?+If you're on a desktop computer, you'll need to install a wallet extension for your browser, such as MetaMask or Dapper. You'll also need to fund your account with Ether in order to purchase an item on OpenSea.
On your mobile device, you'll need to use an Ethereum-compatible mobile browser like Trust, Coinbase Wallet, or Opera.
To learn a little more, check out our getting started page.
- Getting MetaMask+
- Why is my my MetaMask account locked?+If you see a lock screen on your account, you simply need to unlock MetaMask. You can do this by clicking the MetaMask fox in the upper right section of your browser and typing your password.
- I'm trying to buy my first item. Where do I find the address that I should send the ETH to?+You don't need to specify an address. When you click "Buy Now", OpenSea and your wallet will work together to send the ETH from your wallet to the seller. You just have to click "Buy Now" and then approve the transaction that your wallet pops up. OpenSea sends the appropriate info to your wallet, then when you approve the transaction, your wallet broadcasts a transaction to the Ethereum network that sends the ETH to First Edition and the item to you (atomically! either the whole deal happens or none of it does). When the transaction is mined (which happens after 30-70 seconds usually and requires no action from you), the item becomes yours and the ETH becomes the seller's.
You just need to click "Buy Now", then approve the transaction using your wallet's interface.
- I'm trying to create my first listing. What are these first two transactions about?+OpenSea never takes custody of your NFTs when you list them for sale. Plus, deals on OpenSea are executed atomically. That is, either the whole deal happens or none of it does. In order to make these features possible, each user must do a little bit of initial setup before making their first listing.
The first transaction creates your proxy, which is a tiny little smart contract that only you can use that allows you to interact with our underlying protocol, which is known as the Wyvern Protocol.
The second transaction authorizes your proxy to move a given type of NFT on your behalf (or in the case of older contracts like CryptoKitties, it authorizes your proxy to move just one NFT), so when the NFT sells, it can be transferred to the buyer instantly.
Both of these transactions are free, except for the gas that the Ethereum network requires. And after you complete these initial steps, creating an auction will only require signing a message with your wallet. Once you get these first steps behind you, you'll be able to sell items without paying gas.
- How do I list an item for sale?+In order to list an item, you'll need to go to the item on your account page. On the item detail page, click "Sell". This will walk you through the steps for selling an item. Note that the first time you auction an item, you will need to complete several transactions in order to give the exchange contracts access to your items. After you complete these initial steps, creating an auction will only require signing a message with your wallet. This means that you can auction items without paying gas.
- How does the auction work?+As an OpenSea user, you can either sell an item for a fixed price, a declining price, or an auction. When you list an item for auction, you specify a minimum bid amount (tip: make it low and bidding will be higher and faster!) and a duration. Then the duration is over, the highest bidder wins. If no one placed a valid bid, you keep the item and the listing expires automatically.
For declining-price listings, at any point, someone can buy your item at the current price. The current price starts at the start price and gradually decreases over the auction duration until reaching the end price. After the specified duration, the auction will expire and no longer be available for purchase.
- Is there a minimum bid requirement? What happens if someone outbids me at the last second?+Bids must be at least 5% higher than the previous bid. Only bids in the same payment token (e.g. wrapped ETH or DAI) as the auction will be counted towards the winning bid.
If someone bids in the last 5 minutes of an auction, and if their bid exceeds all others, the auction will automatically extend by 5 minutes. This can continue for up to a week of extensions.
- Can I make a listing that doesn't expire?+Currently, all declining-price listings expire when the expiration time is reached. However, if you create a fixed-price listing and don't specify an end price, it will not expire.
- What happens to my item when it's on auction?+For most types of items, the item remains in your wallet while it's on auction! This means it can still be used in the game while it's on auction on OpenSea. (Note that there are still a few item types that require escrow, however)
- In order to list an item for sale, what transactions are required?+OpenSea's auctioning system minimizes the number of on-chain Ethereum transactions required to list an item for sale. In fact, once you've completed the preliminary steps, auctioning an item will require no on-chain transaction at all. Here's how it works:
1. For your very first OpenSea auction, you will need to initialize your account with a free (plus gas) on-chain transaction. You only need to do this once!
2. When you auction a new "type" of item (for example, your first CryptoKitty or your first CryptoStriker), you will need to complete another free (plus gas) transaction in order to unlock access to that item type. In most cases, you only need to do this once per item type! So, for example, once you've approved access to CryptoStrikers, you can auction as many CryptoStrikers as you like without having to complete another transaction.
3. Once you've unlocked access to that item type, all auctions will simply require signing a message with your wallet. No gas required!
We've worked very hard to reduce the overall gas required to use OpenSea. While there are a few transactions up front, the overall result is a much cheaper, faster experience for the end user.
- Can I gift or transfer an item to another wallet?+Yes! You can transfer or "gift" an item by clicking the "Gift" button when viewing it.
Gifting an item requires a small amount of gas to pay the Ethereum network, but is not subject to any other fees.
- Can I sell multiple items at once?+Yes! You can sell a "bundle" of items by going to your "My Account" dropdown and selecting "Sell a Bundle". This will allow you to add multiple items in one single auction.
Selling a bundle of items does not require gas! As with other auctions, the first time you sell, you will need to initialize your account with an on-chain transaction. Also, when you auction a new "type" of item (for example, your first CryptoKitty or your first CryptoStriker), you will need to complete another free (plus gas) transaction in order to unlock access to that item type.
When someone buys your bundle, he or she will receive all of the items in the bundle, and you'll receive your payment!
- Can I send multiple items at once to another wallet?+Yes! You can transfer or "gift" a bundle of items by going to My Account and selecting "Gift an Item Bundle". This will allow you to add multiple items in one single transfer.
Gifting a bundle of items requires gas, but will only be one transaction if you've already approved the assets for transfer. Each bundle is limited to around 40 items due to Ethereum's gas limit.
Gifting items is not subject to any fees.
- How do I make an offer for an item I want to buy?+See an item you'd like to buy? Simply click the "Make an Offer", which will allow you to specify the price you're willing to buy the item. By bidding like this, you will automatically pay for this item if the owner accepts your offer, unless you cancel it. Read more about how this is useful on our blog.
If you're bidding for the first time, there will be a few preliminary steps before you can submit your offer. While these steps may be a little cumbersome, keep in mind these will only happen once! You will need to:
1. Wrap your ETH with W-ETH (wrapped Ether) using the W-ETH station on the right hand side in the bid flow.
2. Approve the exchange to access your W-ETH.
Both of these will require submitting transactions to the blockchain, but after that submitting an offer does not require gas! Each time you want to bid, you simply sign a message which specifies the price you'd like to purchase the item at.
- What's the difference between ETH and WETH?+WETH is wrapped Ether. It's worth exactly the same as ETH and you can convert between the two currencies any time using the WETH station on the right side of the account page's offers tab. WETH is necessary for some actions on OpenSea because, unlike ETH, it can be instantly transferred using ERC20's "transferFrom" function. This allows for bids to be accepted by a seller without escrow and without any action from the bidder.
- How many offers can I make at a time?+You can pretty much make as many offers as you want!
For example, say you have 1 ETH in your account. If you wrap that ETH (turning it into 1 WETH), you could bid 1 ETH on CryptoKitty #123, 1 ETH on CryptoFighter #345, 1 ETH on a Mythereum card. However, the moment that any of your bids gets fulfilled, the other bids for 1 ETH on the other items would no longer be valid (since you no longer have enough WETH to fulfill them).
- I see some offers on an item I own. How do I sell my item to the highest bidder?+First of all, congrats! You're well on your way to selling an item. Read more about how this is useful on our blog.
You can sell your item to the highest bidder by clicking "Accept Offer" on the highest offer, or by creating an English auction (see Selling below). If you're selling an item for the first time, there will be a few preliminary steps. While these steps may be a little cumbersome, keep in mind they will only happen once!
You will need to:
1. Allow access to offers. You'll need to initialize your account in order to sell items. This will be an on-chain transaction. Fortunately, this only needs to be done once!
2. Approve access to the item type. This will require another on-chain transaction, but only needs to be done once per item type (i.e, once for CryptoKitties, once for Etheremon, etc.)
After completing these two preliminary steps, you can then complete an on-chain transaction to sell your item! Once you complete the transaction, you will have W-ETH in your account. You can either leave your W-ETH as is (it's useful for bidding on other items), or you can turn it back into Ether on the Offers section of your account page.
- Someone offered me DAI or USDC for my item... what is this currency?+Congratulations! DAI and USDC are ERC-20 tokens with some remarkable qualities. First of all, they're stablecoins, which means that their value is protected against some of cryptocurrency's notorious price swings. This is not the case for all stablecoins, but each is pegged to the price of one US Dollar. They won't always have that exact value, but you can rest assured that they will stay within a few percentage points of that mark.
Dai (DAI) is a decentralized stablecoin with smart contracts backed by collateral. For more information, check out this video from Dai's creator Maker about how Dai maintains its price.
USD Coin (USDC) was crafted by the CENTRE consortium, founded by Circle and Coinbase. Users in the U.S. can easily convert their USD to USDC on Circle or Coinbase for free and transfer it to their wallet of choice to complete their purchase on OpenSea.
In short, stablecoins are tokens worth a dollar each. When you see DAI or USDC, think dollar.
So, if you're convinced of the value of stablecoins (we are!), you can sell your item to the highest bidder by clicking "Accept Offer" on the highest offer. If you're experienced at selling on OpenSea using ETH, it'll be a familiar process. If it's your first time selling an item, you'll need to go through a few preliminary steps:
1. Allow access to offers. You'll need to initialize your account to sell items. This requires an on-chain transaction, so you'll have to pay some gas. Fortunately, it only needs to be done once!
2. Approve access to the item type. This will require another on-chain transaction, but it only needs to be done once per item type (i.e, once for Axies, once for Etheremon, etc.)
3. Complete a final on-chain transaction to sell your item. Once you complete the transaction, you'll have DAI or USDC in your account. What you do from there is up to you!
- How do I get notified when someone bids on my items?+We'll email you whenever someone bids on an item you own. Just make sure you have an email set in your Account Settings.
Making and Accepting Offers
- What's a bounty?+Bounties incentivize matchmakers to pair up sellers with buyers. Say my friend Harry Hunter knows a lady named Sally Seller (who recently listed NFT X) and a guy named Bill Buyer who wants to buy NFT X. But Sally and Bill don't know each other. Harry can send an OpenSea link for NFT X to Bill with
?ref=HARRY'S_ADDRESS_HEREappended onto the end of it and when Sally buys the item, Harry earns between 1% and 2.5% of the total sale price.
If you're a seller and you want to learn how to leverage the OpenSea affiliate program, read 'How do I increase the bounty on my listing?'. If you're a dapp enthusiast interested in earning bounties, skip down to the 'How do I earn bounties?' section. If you're a developer, we've got solutions of all sorts for you in the last three sections.
To read more about Bounties and see screenshots for reference, check out our article on the subject.
- How do I increase the bounty on my listing?+Just click 'Edit' in the Bounties section of the asset listing flow, then drag the slider up.
It doesn't cost you anything to raise the bounty percentage--the funds for the bounty hunters come from the 2.5% that OpenSea would otherwise collect as a fee on successful sales. The higher the bounty, the greater the incentive for bounty hunters to find a buyer for your listing.
- How do I earn bounties?+First, go to your account page, then select the 'Referrals' tab. If you haven't signed up for an account yet, fill in the fields and click 'Save.' Sign the message to confirm the information, then click 'Join Now' to join the affiliate program.
Then, find a listing to refer. You can find listings with bounties by clicking the 'Show me open bounties' button on the 'Referrals' tab or you can browse the listings with the highest bounty percentages by selecting 'Highest Bounty %' from the dropdown in the top right corner on the main browsing page. Or just make your way to a listing that you have a buyer in mind for.
Once you've selected a listing that you believe you can find a buyer for, navigate to its page and click the bounty bar at the bottom of the listing's price detail section. Then, click 'Copy' to access your referral link. Pro tip: you can also turn any asset link into a referral link by manually appending
Now that you've got your referral link, you're ready to start sharing it on Discord, Twitter, and other social media outlets. Just be sure to maintain good etiquette; rules about referral links still apply to NFTs!
When a buyer enters OpenSea through your referral link, OpenSea will automatically pay out the appropriate percentage of the sale price of the next item the buyer purchases. Even if it's not the item you linked them to, you'll get a percentage of that sale price, determined by the seller's configuration. It'll be paid out in whatever token the item was listed in, unless it was listed in WETH, and then you'll receive ETH. Depending on traffic levels, payouts sometimes take 15 minutes or so to process. But don't lose hope! Your bounty will arrive shortly.
However, you can only earn one referral from each address. The second time you refer a given user, you won't earn a bounty. So, if you refer 0x1, 0x2, and 0x3, you'll get three payments. But if you refer 0x1, 0x2, and then 0x2 again, you'll only get two payments.
- Can I earn bounties by embedding a marketplace on my site?+Yes! If you run a website, OpenSea makes it easy to embed a storefront and refer buyers in bulk. Just select a category from the sidebar on the left, click the '••• More' button, and select 'Embed This Page' from the dropdown. When you sign up for the affiliate program and add the modal's code snippet to your site, you'll receive a bounty whenever you refer a sale.
- Can I earn bounties by processing sales through the SDK?+Yes! To learn how to create a custom marketplace using our SDK, check out our documentation and our example dapp, the Ship's Log. Once you've got a marketplace up and running, you can simply sign up for the affiliate program and feed your address as an additional parameter into
seaport.fulfillOrder. You'll receive a portion of each sale you process this way.
If you've got questions about building a marketplace or earning bounties through your existing marketplace, please chat with us in the #developers channel of our Discord server. We love talking about our SDK, and we're getting pretty good at answering questions from engineers of all skill levels.
- Can I earn bounties if I built a wallet and I send users to OpenSea?+Yes! If you're building a wallet and you're already directing users to OpenSea, sign up for the affiliate program and add
?ref=WALLET_DEVELOPER_ADDRESS_HEREonto OpenSea asset links. You'll start earning bounties as soon as users start making purchases on OpenSea.
- What is the preferred affiliate program? How can I get signed up?+If you're an NFT-related-content creator or if you run a site linking to your collections or items on OpenSea, you might be eligible for our preferred affiliate program, which allows you to earn repeat bounties from purchases made by the same user. Contact us in Discord for more info!
- How long does it take for a bounty payment to process?+It usually takes around 15 minutes, but it might take as much as an hour. If you referred a buyer to an item, but didn't receive a payment, it might be the case that you've referred that buyer before. Each referrer can only earn one bounty per buyer referred. The second time you refer a given user, you won't earn a bounty. So, if you refer 0x1, 0x2, and 0x3, you'll get three payments. But if you refer 0x1, 0x2, and then 0x2 again, you'll only get two payments.
If you're sure that you should have gotten a bounty, but you haven't received it, please contact us in Discord.
- Help! I was able to auction things before, but it's not working anymore!+Occasionally, Metamask will start having issues submitting transactions, causing the OpenSea flows to fail. We've found that the best solution for this is to kill the Metamask extension in Chrome. Before doing this, ensure that you have backed up your Metamask seed phrase. Once you've backed up your seed phrase, try the following:
1. In Chrome, go to the "window" menu, and click "Task Manager".
2. Find the Metamask processes (you can sort alphabetically) and hit "End Process".
2. When the white Chrome notification pops up that says "Click this ballooon to reload the extension", click it to reload Metamask. (If you're not able to click the white notification in time, simply go to chrome://extensions and click "Reload").
3. Then give the flow on OpenSea another try.
If you're still having issues reach out to us on Discord
- I bought something on OpenSea. It's in my OpenSea account but it's not showing up in the game where it's used.+In these cases, we recommend reaching out to the game's support team. If the item is showing up properly on your OpenSea account, the blockchain has properly recorded its transfer into your account. However, the game may not have properly updated to reflect the new ownership (hence we recommend contacting their support team).
- I can't see my Gods Unchained cards on OpenSea.+Gods Unchained employs a mixed system of on chain and off chain asset management. Cards remain off chain and invisible to OpenSea until they're activated. For more information on what activation means, check out the Gods Unchained Quick Guide on Activiation.
To activate your cards and make them viewable on OpenSea, go to the Gods Unchained Activate page and follow the prompts. After your activation transaction has been mined, your cards will appear on your OpenSea account page.
- I'm getting the error: "Unable to match offer with auction. Please restart your wallet/browser and try again!"+Occasionally, MetaMask's node will get out of sync with the blockchain, which will prevent you from completing auctions. If this error persists, we recommend switching your RPC provider to a different Ethereum node. To do this, go to MetaMask and click on "Main Ethereum Network". Then switch to "Custom RPC". You'll need to get a custom URL from our Discord channel.
- I'm trying to create a listing, but I'm getting the error: "You do not own this asset." I own it, though!+Typically, switching to the Rinkeby network and back to mainnet will resolve this issue.
- I'm using a hardware wallet and I can't make offers or create listings.+MetaMask and hadrware wallets just don't play nicely together when you're trying to make offers and create listings. If you're using a Trezor, we don't have a solutiuon for you. Sorry. We're working with the MetaMask to resolve the underlying issue.
But if you're using a Ledger and you see an error along the lines of, "Ledger: The signature doesnt match the right address," we recommend using SpaceSuit, a browser extension wallet like MetaMask. It's designed specifically to make dapps and hardware wallets function smoothly together. Using a Ledger device with SpaceSuit will be a lot using a Ledger device with MetaMask, except that when it's time to sign an offer or a listing, you shouldn't get an error.
And if your assets aren't in the first address generated by your seed phrase, check out SpaceSuit's documentation on accessing the other addresses.
Please visit the Developer FAQ's section of our developers portal for a comprehensive list of developer FAQ's.
- Why isn't my contract accessible in the sidebar or the search bar?+That’s the default state of all new contracts on OpenSea. We employ a concept that we call whitelisting. When a dapp gets whitelisted, it appears in the sidebar and becomes searchable in the main search bar.
Whitelisting is discretionary, but we use a few key metrics to inform the decision: the project’s community engagement on Discord and Telegram, historical volume of sales on OpenSea, the project’s reach on Twitter and other social media, the novelty of the tech, and the pace of development, among others. If you put together a brief report on your project, focusing on the metrics enumerated above, and send it to [email protected] we’d be happy to review it.
- Is OpenSea just aggregating auctions from other marketplaces?+While OpenSea does include data from specific game marketplaces (like CryptoKitties), most of the auctions you'll see on OpenSea are made through our own auctioning system. For many games, we act as the primary marketplace for buying and selling the game items.
- Do you charge transaction fees?+Yes, we take 2.5% from the price of a successful sale. If we have an official partnership with the original creator of the item (such as the developer of the game), the original creator can also opt to take a fee on the final transaction as well.
There's no fee to list items or buy items. But when you list an item, the sidebar on the right (or the section on the bottom on mobile) will tell you fee that will be deducted when the item sells. E.g. if OpenSea takes 2.5% and the creator takes 4%, the total fee will be 6.5% of the final sale price.
- Is OpenSea safe?+OpenSea has a strong track record as a safe marketplace for unique blockchain-based assets. We've had over 4,000 ETH of volume pass through our smart contract and many thousands of successful sales. We've acted as the primary marketplace for several large games, including Etheremon Adventure, My Crypto Heroes, CryptoVoxels, ChainBreakers, Ether Kingdoms, and CryptoBeasties -- as well as a secondary market for CryptoKitties, MLB Crypto, Axie, and a host of others.
For the more technically savvy: we leverage the Wyvern Protocol, an audited, battle-tested set of smart contracts. Wyvern is a decentralized exchange system that creates a personal proxy for each user. We don't control the proxies that get created, and you have to approve access to each ERC721 contract individually. Once the contract is approved, the logic of the exchange contract only allows it to transfer an asset from your proxy only if A) you have signed an order indicating you wish to sell that item, and B) it is properly matched by a buyer paying the appropriate funds. So not only does your asset not leave your wallet until it is sold, it is only allowed to be swapped if an order you create is properly matched.
- What exactly happens when I list something for auction?+When you list one of your collectibles for auction, you'll sign a message broadcasting that you're willing to sell the item for a specific price. Once your item has been placed for auction, a buyer can buy your item at the current auction price. At that time, the proper Ether amount will be transferred to you and the item will be transferred to the buyer. Excitingly, this happens atomically -- meaning there is no risk that you don't receive payment or that the buyer doesn't receive the item.
- What's the story with support for ERC-20s like MANA and DAI?+When we first built OpenSea, we decided to construct the experience around Ethereum, as a dapp platform and as a currency. It was the simplest option. Because most users already had some ETH, if only to pay gas, it provided an economic lingua franca. And it allowed us to streamline a new and unfamiliar buying experience. But all along, we've been excited about the entire token economy and we intend to grow with the maturing ecosystem and userbase.
Now, with support for ERC-20 tokens like MANA and DAI, we're doing exactly that. In addition to allowing users to spend the currencies they already have, it will allow developers to offer NFTs for sale denominated in the dapp's in game currency. You still get to use all the OpenSea features you've come to know, but now with more flexibility.
You'll find some items listed for sale in an ERC-20 token. You can buy them immediately by paying in the specified currency, like making a purchase with ETH. If you don't have any of the seller's specified currency (and have no desire to acquire any), you can make an offer in the currency of your choice by clicking the 'Make Offer' button and selecting your preferred currency from the dropdown next to the entry field. For more about how powerful bidding on OpenSea is, check out our Medium post.
To list an item for sale in the ERC-20 of your choice, click 'Sell' on the item's page, select a token from dropdown next to the price entry field, specify your desired price, then click 'Post Your Listing'.
- Do you issue refunds?+Since transactions on the blockchain are irreversible, we cannot provide refunds. We have no ability to cancel, revert, or modify any transactions on the Ethereum network.
- How can I set up a webhook?+You can receive notifications in Discord about the activity for any contract on OpenSea. To create a channel in your Discord server that shows the activity for Autoglyphs, make a new text channel in your Discord server and name it something like '#opensea-autoglyphs', then hover over it and click the gear icon. Select the webhooks option from the menu and click "Create webhook" to make a new webhook. Name it something like "OpenSea" and copy the link that Discord provides.
Then take that link to https://opensea.io/assets/autoglyphs, click the "...More" button in the top right corner and select the "Subscribe" option. Paste the link into the modal that pops up and click "Add webhook". You'll need to sign a message to complete the process.
To test that your Autoglyhs webhook is set up correctly, try making a bid on an Autoglyph and checking whether it shows up in your new '#opensea-autoglyphs' channel. If you have any questions or run into any issues, please contact us in Discord!
You can adapt this process for contracts other than Autoglyhs and platforms other than Discord. We use the Discord POST body format, but you could use the OpenSea webhook system in your own app if you'd like. For more info, please ping us in the #developers channel of our Discord server.