Listings
A Listing is a mechanism to distribute one or more items to end users. You as a developer create a listing with various configuration, including:
- ID of the item or the collection.
- Price.
- Quantity listed.
- Listing currency.
- Start and end time.
- Accepted payment providers.
- Listing policies.
Your end users can then consume the listing via the public api. End-users express their desire to purchase a listing by creating a purchase intent. Depending on the payment method, once a purchase intent is created, further steps may be needed to complete the purchase.
While a listing can have a price associated with it, it is important to note that a listing can also be free for end users to consume. You can even decide to pay the gas fees for your users, so they simply enter an email or an Ethereum address to mint. See payment providers for more details.
A listing can be created for one item, multiple items specified using item IDs or token IDs, or an entire collection (ERC-721 only). When you create a listing on the collection level, any of the items in the collection is available for purchase, and can be intentionally obscured to enable a randomized drop.
Only one listing is allowed at a time for any given item or a collection. An item-level listing can only be created if there are no collection-level listings for the same items. Similarly, a collection-level listing can only be created if there are no item-level listings in the collection.
Learn how to create item-level and collection-level listings.
You can currently only create collection-level listings on ERC-721 collections.
Items must be locked before any listings can be created.