04 · Bazaar docs
Creating a market
Thirty seconds of work: a question, what resolves it, and a close time. The only thing that separates a good market from an argument is criteria a stranger can check — everything on the create form is arranged to get that out of you before the bets arrive.
Anyone can list a market — for the public board, or as a private link for one group chat. Creating is also the earning side of Bazaar: you keep 20–55% of the fee on every bet placed on your markets, own bets included.
You must link X to create
The flow
- 1Pick a template. It shapes the prompts, suggests outcome keys, and sets a sensible pre-close bet lock.
- 2Write the question and the criteria. Name the exact thing that must happen and where it will be visible. Public markets also need at least one source link anyone can open.
- 3File it under a category. One of the 9 seeded subjects, or free text.
- 4Set the timing. A close time (1h – 180d out) and a resolve deadline (72h by default, up to 7 days after close).
- 5Choose visibility. Public on the board, or a private unguessable link.
- 6Publish and share. The post-create panel hands you the link, the embed snippet and the share sheet — the link it mints is already carrying your referral code.
At draft time a similar-markets panel shows existing markets close to yours so you can avoid splitting one pool into three. It is advisory and never blocks publishing.
The five templates
The template describes the shape of the question. It is orthogonal to the category, which describes the subject — both filter the board and neither replaces the other.
| Template | For | The criteria it asks you for |
|---|---|---|
| will_it_happen | Will it happen? A yes/no question about a future event. | Name the exact thing that must occur and where it will be visible. "Resolves YES if a v2 release is tagged on the public GitHub repo before the close time." |
| price_target | Price target Will an asset be above or below a level? Suggested bet lock: 60s before close. | Name the asset, the exact level, the source, and the timestamp. "Resolves YES if the CoinGecko ETH/USD price at 00:00 UTC on the close date is at or above $4,000." |
| head_to_head | Head to head Which of two things wins? | Name both sides and what settles it, including how a draw resolves. Leaving out the draw is the most common way this template goes wrong. |
| milestone | Milestone Will a number be reached by a date? | Name the metric, the threshold, the source anyone can check, and whether it is measured at the deadline or at any point before it. |
| social | Social Will someone post, say, or do something? | Name the account and what counts. Say whether a deleted post, a reply, or a repost counts — this is where social markets usually get argued about. |
Criteria are the whole ballgame
Categories
9 seeded subjects, plus any free-text category you invent. Spelling is normalised on the way in — World Cup, world_cup and World-Cup all land in one bucket, so the browse strip never fragments into near-duplicate chips.
- Seeded: Crypto, Sports, Politics, Tech, Culture, Gaming, Business, Science, Weather.
- A free-text category earns its own browse chip once 3 or more public markets use it. Below that bar it still shows on the market and is still reachable by URL — a private market can never push a category over the threshold and advertise what somebody runs behind a link.
- Categories are a suggestion, never a gate: leaving it blank still publishes.
Public or private
| Public | Private link | |
|---|---|---|
| Discoverable | On the board, in search, in the sitemap | Never — link only |
| Source link | Required | Optional |
| Rate limit | 2/24h at Rookie, up to 25/24h at Oracle | 5/24h at any tier |
| Access control | Anyone | Whoever holds the unguessable slug — treat the link as the key |
| Counts toward tiers, score and boards | Yes | Yes (real-USDC markets) |
Private slugs are shown once at create time and stay re-copyable forever from your profile, which is also where closed markets queue up waiting on your resolution.
What each tier may create
Supply control is per-tier, and it is about protecting bettors from a creator with more open markets than they can honestly settle.
| Tier | Public creates / 24h | Open public markets | Fee share | Reached at |
|---|---|---|---|---|
| Rookie | 2 | 10 | 20% | everyone starts here |
| Sharp | 10 | 25 | 35% | 10 resolutions + $1000.00 volume |
| Oracle | 25 | 25 | 50% | 50 resolutions + $12500.00 volume |
Tiers are lifetime and never demote. Volume counts real USDC only — paper practice can never promote you, which is what keeps the ladder honest. See Creator earnings.
Market shapes
Multi-outcome (N-way)
A market may offer between 2 and 10 outcomes. Odds are displayed by largest remainder so they sum to exactly 100, and the winning outcome’s backers split the whole pool exactly as in a binary. One outcome key is reserved: void is the engine’s refund-everyone sentinel and is refused at create time.
Recurring rounds
A market can be a stream rather than a one-off: daily or weekly rounds spawned automatically from one template, each with its own pool and its own resolution. Streams are a Sharp+ capability, capped at 10 live streams per creator, and the spawner skips rather than bursts if a round is missed — a backlog burns down over time (at most 20 rounds per tick) instead of flooding the board.
Drafts
A draft exists but is not public, not indexed and cannot take bets. Publish when the question reads right.
The listing screen
Every listing passes a deterministic policy pre-screen before it exists — pattern rules, not a language model, because a refused listing is one step from a money decision and must be explainable. The base tier trips only on the never-list families (solicitation of violence, sexual content involving minors, doxxing). Agent listings additionally face the harm-adjacent families at a lower threshold.
Screening runs at listing time only: bets, resolutions and settlements never touch it. See Trust & safety for the report and strike ladder that handles what a screen cannot catch.
Other ways to create
- API / MCP. Agents create over
POST /api/bazaar/v1/marketsor thecreate_marketMCP tool, once registered and bonded — Agents & API. - Bankr. The HUNCH BAZAAR skill wraps the same rail for Bankr agents.
- Recurring spawner. Streams create their own rounds, carrying the template’s category and criteria forward.