Skip to main content

How do I use the Vaullt white label?

By August 17, 2021No Comments

What is the OpenSea partners program?

OpenSea provides a robust suite of tools for developers building NFT projects. From a simple embed of your OpenSea collection to a customized build, we’ve got you covered. This article takes a detailed look at all the options and runs through some frequently asked questions.


  • The OpenSea White Label is free to use – we just take 2.5% on all transactions. There is currently no option to purchase the White Label upfront and remove our 2.5% fee.
  • There are THREE ways to partner with OpenSea (see below).


#1 OpenSea Storefront Embed Option – The Easiest Option

  • Embed the collection manager onto your website. Roll your own smart contract, create a collection in our GUI, or create it in someone else’s GUI.
  • More than 95% of creators, even skilled developers use some form of page embedding. This option offers the most reliable and clean experience.
  • Very simple implementation requiring basic HTML knowledge only.
  • If you’d like to embed a marketplace with a referral address attached, you can simply add?embed=true&ref=YOURWALLETADDRESS to the end of the OpenSea collection URL, and put it in an iFrame.
  • Example here ( and instructions here (
<iframe src="" />
  • Setup Time needed: 5-15 min

#2 OpenSea White Label (Repo), Intermediate Option

  • This offers a custom domain, with partial control over styling eg. Light/Dark mode customization.
  • Full step up in dev skills required eg. Yarn/NPM/React + familiarity operating at the command line.
  • API key is not needed.
  • Time needed: 1-3 hours for most developers.

#3 OpenSea SDK, Advanced Option

  • In this option, OpenSea only provides tools to give buy/sell functionality. You must provide the entire front-end yourself.
  • Familiarity with Web3 development strongly recommended + familiarity with React/Vue or another modern Javascript framework.
  • Requires an API Key if you expect to make more than two queries per second (Request form here).
  • Time needed: 1-2 days for most developers.

White Label & Affiliate Marketing FAQ

Here are some commonly asked questions from users regarding OpenSea’s White Label and Affiliate Marketing programs.

I would like to deploy my own smart contract.

  • Our white-label functionality does not include deploying smart contracts or minting. Projects have to create their own smart contract or make a collection using the OpenSea Collection Manager.
  • We have no API for content creation or lazy minting through the OpenSea Collection Manager. We have example code if developers want to roll their own contract, but there’s currently no way to mint through the OpenSea API, SDK, or by other programmatic means.

I would like to batch mint. How many items can be in a collection?

  • A collection can have a potentially unlimited number of items, but there is no batch way of minting them at once. Have to do it one by one.
  • You can create semifungible items (with many copies) by setting the number next to Supply to be greater than one. That will be the maximum number of copies you will be able to mint for the token, a.k.a. the “supply cap”.
  • The field is disabled by default but can be enabled by adding ?enable_supply=true to the end of the URL on the item minting page. Just remember to make listings with Quantity set to one so that buyers can choose to buy only one copy if they choose. A single listing of twenty copies can only be purchased if the buyer buys all twenty. This limitation will be eliminated soon.

Who is the white-label hosted by? Myself or by OpenSea?

  • When you embed the OpenSea marketplace on a site managed by you or by a third party (like Wix, Blogger etc), the White Label marketplace is hosted by OpenSea and presented in the context of a page hosted by someone other than OpenSea.
  • If you build a custom marketplace using the SDK, it will be entirely hosted by you. You are just using the OpenSea SDK library to interact with OpenSea’s backend, order books, and underlying infrastructure. Therefore, nothing is hosted by us. Even the SDK itself will be a package running in your frontend.

What about payment escrow?

  • OpenSea does not offer payment escrow through the main website or otherwise.

Will the white-label support Polygon/Matic and other integrations?

  • Only Polygon/Matic will be supported in the embed option.
  • There will be no sidechain or layer 2 support in the SDK.

If you embed the storefront directly to the website can more creators add NFTs for sale to the storefront? And how does that work? How will the NFTs be added?

  • Whether it’s embedded or not doesn’t matter.
  • Yes, you can add more users via the collection editor.
  • Creator A, creates a collection + adds assets.
  • Creator B is then added to the collection.
  • Creator B, can mint assets into that collection, owner of those assets would be Creator B.
  • Whoever creates it, owns it, whoever sells it earns the revenues from the sales.

Do we have the ability to offer discounted rates if payment is made in our native/own ERC-20 token?

  • OpenSea’s fee is 2.5%, no matter what the currency is.
  • Developers can’t affect our fee comprehensively, but any seller can create a private listing. There are no fees on private listings. No dev fee, no OpenSea fee.
  • Some creators create a listing in ETH eg. 1 ETH, then they create a parallel, discounted listing in their own currency.

Does the white-label/SDK allow for in-game trading?

  • Yes, it supports in-game trading for web-based games (or games with a node.js backend).
  • keep mind it only supports trades on Ethereum.

Are we able to mint ERC-721 and ERC-1155 tokens using our smart contracts and list them for sale using the white-label solution yet get paid on re-sales?

Currently, it seems as though on, we wouldn’t get paid on resales if we mint on our platform and allow our Creators to list on OpenSea.

  • Yes, you can, by using the White Label solution. Will act like OpenSea natively, you can get paid sales. They need to set a seller fee.
  • They can mint wherever, as long as they access the collection editor and set a payout address they can earn royalties.
  • OpenSea is agnostic as to where minting happens. No matter where the item was minted, if the sale happens on OpenSea and you have a developer/seller fee set, you’ll earn a fee.

Will it be possible for us to generate revenue through your white-label site without selling our own NFT items?

For example, if we bring a buyer through our white-label site, and the buyer purchase one of NFT items listed by other seller instead of our NFT items, then will there be any commission to us for that purchase made by the buyer came through our white-label site?

  • You can generate revenue with a white-labeled marketplace by earning referral payments.
  • Please refer to the Earning Bounties article.
  • You can earn between 1-2.5% of the total sale price (40-100% of OpenSea’s fee). This comes out of OpenSea’s fee.
  • If you own the items, or the items are on a collection that you created, you can earn a developer seller fee, too.
  • Everything else (items you don’t own) is the standard 1-2.5% fee.
  • If you want to turn any asset into a referral, you can add this to the item URL ?ref=YOUR_ADDRESS_HERE

What if someone’s listing gets sold, not the ones we listed? For example, let’s say someone’s listing of NFT artwork has been sold at 1 ETH through our white-label site, then you’ll deduct 2.5% transaction fee from that 1 ETH and the person who listed that artwork will take the rest, then what’s left for us?

1) There is an affiliate system, where people who embed our marketplace (with their referral link attached) or share their referral link can earn between 1% and 2.5% of the total sale (taken out of our fee).

2) And there’s a royalty system (secondary sales fee or developer fee), where creators can earn up to 10% of future sales.

  • When a seller is embedded in a marketplace that they created, you can also earn money with a seller fee. In this case, an NFT sells for 1 ETH through their site, we deduct our 2.5% fee and then pay the affiliate out of that 2.5%.
  • For example, Creator A gets a collection and sets a 2.5% royalty for that collection. When orders are created, we include those fees into the order = adding 5% on top. That means a 2.5% fee for OpenSea, and another 2.5% royalty for the collection creator. When that sale is fulfilled, we hold 5% and pay their portion once a month.


Note on Seller Fees

  • Often a developer will create collections and share them with their users. Users will start to create sell orders, but sometimes the developer can’t yet access the collection manager as they weren’t an authorized editor yet. Once authorized, they then set a developer fee.
  • Any sell orders created prior to setting a seller fee will not earn a seller fee at sale time, even if the developer fee is set by sale time. What affects whether a dev earns a fee on any given sale is whether there was a dev fee set at the time the sell order was made. The dev fee at the time of the sale doesn’t matter.
  • After the developer as set the fee, they will get seller fees as sell orders made after they set the dev fee are fulfilled.

Royalty Fees

The collection owner or any authorized editor can change the payout address to any arbitrary address. Only one address can be sent the fees (we can’t split on our end).

Think of it like this. You create your collection, you create 1 item. You list it for 1 ETH. At sale time there are three revenue portions.

  • The main sale fee = 0.95 ETH.
  • Seller fee= 0.025 ETH (2.5%). Received when we do referral payouts, approximately bi-weekly.
  • Referral fee for first-time users on the OpenSea marketplace (including white-labels) = 0.01-0.025 ETH (1-2.5%). Received when we do referral payouts, approximately bi-weekly.

Only the asset owner can get the big chunk (the 95% at sale time). A collection can be “multiplayer”, but when an artist mints into it, the owner of the asset is the artist, not the collection owner. But if it sells on Rarible, the creator of the collection and the platform (OpenSea) both get nothing.