Before You Start
A strong market needs three things: a question your audience already cares about, answer labels that are mutually understandable, and a duration that matches your audience's attention window.
- Question wording is permanent on-chain once the market is created.
- Pick 2 answers for binary conviction, 3–5 for multi-perspective narratives.
- Duration range: minimum 5 minutes, maximum 90 days.
- Markets with recurring cadence should use the Series flow instead.
Creation Parameters
- topic — short category label (e.g., "BNB Chain", "Crypto AI", "Sports").
- question — the full question text (permanent on-chain).
- answers — array of 2–5 answer label strings.
- startTime — Unix timestamp; must be in the future.
- endTime — Unix timestamp; must be startTime + 5 min to startTime + 90 days.
- creatorFeeBps — your fee on every sell, 0–50 basis points (0–0.5%). Higher fees reduce trader incentives.
- virtualLiquidityKusd — total KUSD to seed all answer pools. Divided equally across answers. Must be ≤ protocol cap.
A 50 bps (0.5%) creator fee on a market generating 10,000 KUSD in sell volume earns you 50 KUSD. Protocol sell fee is 0%.
What Happens On-Chain
Calling createMarket triggers a multi-step atomic transaction:
- KangarooTokenFactory deploys one KangarooSentimentToken per answer.
- The V2 factory creates one KUSD/SentimentToken pair per answer.
- Virtual KUSD is minted and seeded into each pair (floor(virtualLiquidityKusd / answerCount) per pool).
- Each pool receives 9,000 answer tokens alongside the virtual KUSD (scale-converted to 18 decimals).
- The pairs are marked as protected in KangarooUSD.
- KangarooCreatorRegistry records the market under your address.
- You receive a Creator Badge (BADGE_CREATOR = 1).
Creator Best Practices
- Choose topics your specific audience can judge without external expertise.
- Keep answer labels short — 1–4 words each. Avoid double-negatives or jargon.
- Set duration to match the news cycle: 24–72 hours for trending events, 7–14 days for slow narratives.
- Share the market URL immediately after creation while your audience's attention is fresh.
- Use recurring series for weekly or daily cadence topics — avoid re-creating one-off markets for the same question.
