The seller flow for the v1 marketplace: a holder lists a token they own at a fixed price. They set how much and in which currency (from Toko's curated whitelist), pick a preset duration (max 14 days), and set a referral fee (a 1–10% slider, min 1%). An unsold listing simply returns to the wallet. The token being listed is shown the whole way through. The referral fee (the secondary-sale fee — today always paid to the Toko Marketplace; higher fee = higher placement) is charged only on a completed sale. No auctions, no offers in v1. Source: Design Documentation/secondary-marketplace-design.md.
01List for sale — price & termsEntered from a token in My Tokens, so the asset is pre-selected and shown large on the left. Price (amount + a currency from Toko's curated whitelist) and a preset duration share one row; below them the seller sets a referral fee (1–10%; higher = higher placement). An unsold listing always returns to the wallet — there is no burn option in v1. A live breakdown shows exactly what the seller receives. Under the price field, a reference strip shows your cost (the holding's acquisition price, from Claimed/Bought history) with a live %-from-cost badge, and the collection floor with a %-vs-floor badge and a "Use floor price" button that fills the amount — it never auto-fills on load. Either value renders —, not 0, when it doesn't exist (no floor listings, or no traceable acquisition record) and the badge/button are omitted for that item.
A fixed-price listing — a buyer pays your price to buy it now.
Little Leaf #014
Little Leaf Guardians RareOwned
Single (1 of 1)
Listing details
Up to 8 decimals (ICP precision) · ≈ $121.80
Your cost 10.00 ICP+40% from costCollection floor 12.00 ICP+16.7% vs floor
1d3d7d14d
Max 14 days · expires 14 Jul, 18:00 (local).
Returns to your wallet — the listing ends and the token is simply unlisted again. (Burning isn't available in v1.)
The % of the sale paid to the marketplace on a sale. Higher fee = higher placement — Toko sorts listings by referral fee, highest first, and the front-page spotlight is drawn from the top. Minimum 1%.
5%
1%2%5%8%10%
Your token stays in your wallet and is sale-locked while listed. Ownership transfers only when a buyer completes the purchase.
List price14 ICP
Creator royalty (3%)−0.42 ICP
Referral fee (5%)−0.70 ICP
You receive12.88 ICP
The split and referral fee are taken at settlement — if it doesn't sell, you're charged nothing. The referral fee goes to the Toko Marketplace (or another referrer in future).
01bList a stack — priced per unit, partial buys allowedA stack listing is priced per unit. Buyers take any quantity up to the remainder (all 12, or just 1) at qty × unit price; the rest stays listed at the same terms until sold out, cancelled, or expired. Remaining quantity is race-protected (atomic check-and-decrement; first call wins). The token picker shows stack vs single per holding.
A fixed-price listing of a whole stack — a buyer pays your price for all 12 copies.
×12
Swampie #221
Swamp Things CommonOwned
Stack · ×12 — sells as one lot
Listing details
Per unit — buyers choose how many to take. Full stack total: 30 ICP ≈ $261.00.
Your avg. cost 2.00 ICP+25% from costCollection floor 2.20 ICP+13.6% vs floor
Weighted average across this stack's acquisitions — copies claimed or bought at different prices contribute proportionally.
1d3d7d14d
Max 14 days · expires 14 Jul, 18:00 (local).
Buyers can take any amount. Someone might buy all 12, or just 1 — each pays quantity × your unit price, and whatever's left stays listed at the same terms until it sells out or the listing ends.
5%
1%2%5%8%10%
Price per unit2.5 ICP
If all 12 sell30 ICP
Creator royalty (3%)−0.075 ICP / unit
Referral fee (5%)−0.125 ICP / unit
You receive2.30 ICP / unit sold
Fees settle per sale, on the quantity actually bought — partial sales pay out as they happen.
02Currency & duration presetsPrice is denominated in exactly one token from Toko's curated currency whitelist (ICP · ckBTC · ckETH · ckUSDC · ckUSDT · ckSOL · $TOKO · $DKP). Duration is a fixed set of presets — 1 / 3 / 7 / 14 days (max 14, no until-cancel). Amount entry is capped to the selected token's decimal precision.
ICP listing · 7 days
≈ $121.80 · up to 8 decimals · you receive 13.02 ICP after fees
1d3d7d14d
ckBTC listing · 14 days
≈ $286.00 · up to 8 decimals · you receive 0.00391 ckBTC after fees
1d3d7d14d
Toko curates the currency whitelist; tokens can be added or removed over time.
03Review & confirmA single review step before publish, mirroring the Transfer modal. The asset, price, duration, visibility and net proceeds are restated; publishing requires a wallet signature. The token is sale-locked the moment it goes live.
Confirm listing
✕
Little Leaf #014
Little Leaf Guardians · Rare
List for14 ICP
Duration7 days
Referral fee5%
If unsoldReturns to wallet
You receive12.88 ICP
Sign in your wallet to publish. The token is sale-locked until it sells, expires, or you cancel.
04Listing live & price-changed conflictOn success the listing is live and the token shows as sale-locked, with a direct link to view it. If listing/ownership state changed between page load and confirm, publish fails safely (pre-submit revalidation) rather than acting on stale state.
Listing live
✕
Little Leaf #014 is now listed. It stays in your wallet, sale-locked, until it sells or you cancel.
Little Leaf #014
Listed · 14 ICP · sale-locked
Couldn't publish
✕
This token's state changed. It may have moved or already been listed. Nothing was published — refresh and try again.
05Guards — already listed & invalid priceOnly the current owner can list, and a token can hold at most one active fixed-price listing. If it's already listed, the form is replaced by a manage/cancel state. Inline validation blocks an empty, non-positive, or over-precise price (beyond the token's decimals) before the publish is reachable.
Already listed
Little Leaf #014 is already listed for 14 ICP, expiring in 5 days. A token can have only one active listing.
Invalid price
Enter a price greater than zero, within ICP's 8 decimals.
06Referral fee → placementThe referral fee is a 1–10% slider the seller sets (min 1%). It's the only visibility lever: the marketplace sorts by referral fee, highest first, so a higher fee buys a higher default placement and feeds the front-page spotlight. Either way it's charged only on a completed sale — unsold costs nothing — and goes to the listing's referrer (today always the Toko Marketplace).
Low referral · 1%
List price14 ICP
Creator royalty (3%)−0.42 ICP
Referral fee (1%)−0.14 ICP
You receive13.44 ICP
Keeps the most, but sits lower in the default order.
High referral · 10%
List price14 ICP
Creator royalty (3%)−0.42 ICP
Referral fee (10%)−1.40 ICP
You receive12.18 ICP
Sorts to the top of the marketplace and into the front-page spotlight.
