Sales Mechanics
Primary market sales are configured on an artwork. An artwork can have multiple primary market sales over time (e.g., different phases of a release), but only one can be active at a time.
Sale Strategies
Each primary market listing uses one of three strategies:
| Strategy | Description | Use Case |
|---|---|---|
PMBuyNowLimitedEditionStrategy | Fixed price, limited supply | Standard drops with set edition count |
PMBuyNowOpenEditionStrategy | Fixed price, unlimited supply during window | Time-limited open editions |
PMAuctionStrategy | Bidding-based sales | Single-piece auctions or ranked auctions |
Additional Mechanics
Sale strategies can be combined with additional mechanics:
- Dutch Auction — Price decreases over time in brackets
- Decreasing Supply — Available supply decreases over time
- Ranked Auction — Top N bidders win, all pay the same clearing price
- Mint Pass — Restrict purchases to holders of specific NFTs
- Reserve List — Priority access for specific collectors
Multi-Phase Sales
To run multiple phases (e.g. a reserve-gated early phase followed by a public phase), create separate sales on the same artwork in Verse Studio. Only one sale can be active at a time.
How it works:
- Each phase is a separate primary market listing with its own price, reserve list, and schedule
- When using Verse Elements, the SDK automatically detects and uses the currently active sale for the artwork — no code changes are needed between phases
- Configure each phase's start and end time in Studio
- When one phase ends, create the next phase's sale in Studio
Running two listings on the same artwork in parallel is not supported. Scheduling multiple listings sequentially in advance is also not currently possible — each new phase must be created manually in Studio after the previous phase has ended.
Leave at least a 30-minute buffer between one phase ending and the next starting. This gives you time to verify the previous phase completed correctly and set up the next sale.
Querying Primary Sales
Use primaryMarketListing to query the currently active sale for an artwork, or primaryMarketListings to get all listings including past ones. Each listing includes its strategy, schedule, and stats. See the Schema Reference for full type details.