Skip to main content

Documentation Index

Fetch the complete documentation index at: https://xpectrum.mintlify.app/llms.txt

Use this file to discover all available pages before exploring further.

The Xpectrum Marketplace handles all secondary trading via the Xmarket contract. It works with any XNS-1 compliant collection. Both platform-managed XNS1 collections and creator-deployed Xcollections are tradeable.

​
Listing a token

To list a token for sale:
  1. Approve Xmarket as an operator on the token (one-time per token, or use approve-all)
  2. Set your price and submit the listing
Listings are fixed-price. The listing is stored on-chain and indexed by contract_token_to_listing so any buyer can look up an active listing by collection address and token ID. If the listed token changes hands after listing (e.g. transferred as a gift), the stale listing auto-cancels on the next interaction with it.

​
Sale proceeds

When a token sells, payment splits automatically at settlement:
RecipientShare
Platform2.5%
Creator royaltyAs set by collection (max 10%)
SellerRemainder
Proceeds are pull-based. They accumulate on Xmarket until you collect them via claim_proceeds() or the dashboard Collect button. Your proceeds are never lost to a failed downstream call.

​
Offers

​
Individual offers

Make an offer on a specific token via make_offer(contract, token_id, expiry) with OCT attached. The OCT is locked in Xmarket for the offer duration. The token owner accepts via accept_offer(offer_id). You cancel via cancel_offer(offer_id) to reclaim your OCT. Offer amounts are publicly visible on-chain.

​
Collection offers

A collection offer targets any token in a collection, not a specific one. Submit via make_collection_offer(contract, expiry) with OCT attached. When a seller accepts via accept_collection_offer(offer_id, token_id), they specify which token from their wallet fills it. Xmarket verifies ownership and marketplace approval at settlement time.
Collection offers let you acquire any piece from a collection at a price you’re comfortable with, without waiting for a specific token to be listed.

​
Royalties

Royalties are enforced on every secondary sale by Xmarket. The contract reads the royalty rate from the collection’s XNS-1 interface and independently clamps it to 10%. A collection claiming 50% royalty receives 10%. Royalties cannot be bypassed. Any XNS-1 compliant marketplace reading the same contract data applies the same cap.