DESK MANUAL
Every rule, every number, every function. Constants shown here are per-season contract constants — once contracts are live, this page renders them from chain.
Overview
MarginBrokers is 4,444 margin-account badges on Robinhood Chain. The pot buys real tokenized stock every round and pays every active badge by weight. The twist: you can lever your weight with $MARGIN — and the market itself decides whether that made you rich or liquidated.
Zero-sum by construction. The pot is a fixed pie per round; levers only change how it is sliced. Nothing is printed, no emissions exist anywhere in the system.
How a round works
- ▸1 · POT FILLS — mint fees, royalties, exit fees, token trading fees, and last round's liquidation slashes drip in.
- ▸2 · ROUND OPENS — pot ≥ 0.01 ETH lets anyone call openRound. The next rotation stock is announced; entry price = TWAP snapshot.
- ▸3 · POSITIONS FREEZE — whatever lever each badge set before open is locked: CASH ×1, 2X, or 3X.
- ▸4 · 24H WINDOW — the tokenized stock trades on its own AMM; the protocol just watches.
- ▸5 · SETTLE — anyone calls settleRound for a 2% bounty. Exit TWAP → round return R. The pot swaps into the round's stock.
- ▸6 · DISTRIBUTION — R > 0: levered badges credited ×2/×3. Flat-red above the line: levers revert to ×1. Below the line: LIQUIDATED.
- ▸7 · THE FEED — liquidation and survivor cards post automatically. Half of every slash burns, half refills the pot.
The lever math
- CASH ×1
- no lock · immune to liquidation · the house side of every lever
- 2X
- lock 20,000 $MARGIN · liquidated if the window closes ≤ −3.0%
- 3X
- lock 60,000 $MARGIN · liquidated if the window closes ≤ −2.0%
expected weight (2X) = 2·P(green) + 1·P(flat-red) + 0·P(liq) ≈ 2(0.52) + 1(0.33) + 0(0.15) = 1.37 The +0.37 share premium is PAID FOR by the expected slash: 0.15 × 20,000 $MARGIN per round. Lock sizes and lines are tuned so lever-EV ≈ cash-EV at launch prices.
The multiplier applies ONLY on green windows. A flat or mildly red close wastes the lever (you revert to ×1). Below the line, your round weight is zero and your locked stack is slashed: 50% burned forever, 50% into the next pot.
Where the money goes
- Mint (4,444 × 0.004 ETH)
- 88% pot · 2% settle bounty pool · 10% protocol
- Secondary royalty (5%)
- 100% pot
- Exit fee (0.0002 ETH)
- 90% pot · 10% protocol
- $MARGIN trading fee share
- 100% pot
- Liquidation slashes
- 50% burn · 50% pot
Four perpetual pipes. Mint revenue seeds round one; royalties, exits, token fees and slashes keep it alive forever after. The protocol takes no side in any round.
Stock rotation
NVDA → AAPL → MSFT → AMZN → GOOGL → META → GME → TSLA → repeat
- ▸Rotation order is fixed in the contract — no admin picks the stock.
- ▸Everyone knows the NEXT stock before setting a lever. Levering into TSLA is a different bet than levering into MSFT.
- ▸Distributed stock accrues to each badge's vault — claim it or let it stack. The vault travels with the badge on transfer.
Every function
- setLever(id, tier)
- pre-open only; pulls and freezes the $MARGIN lock
- openRound()
- permissionless; requires pot ≥ 0.01 ETH; snapshots entry TWAP
- settleRound()
- permissionless after the window; computes R, swaps pot into stock, credits by weight, slashes liquidated locks, pays 2% bounty to the caller
- claim(id)
- transfers accrued stock from the badge's vault to the holder
- exit(id)
- burn badge + 0.0002 ETH fee → vault stock out, 90% of fee to pot
No admin round control. No pause on rounds. Rotation, thresholds, locks and lines are contract constants, posted here and on-chain — never changed mid-round; adjusted only between seasons.
Price integrity
- ▸Entry/exit prices are cumulative-price TWAPs read directly from the tokenized stock's own AMM pool over ≥30 minutes — no oracle vendor.
- ▸Per-round return is clamped to ±10%: a manipulated wick cannot force mass liquidation beyond the clamp.
- ▸Liquidity gate: if pool depth is below the floor constant at open, the round falls through to the next rotation stock.
- ▸Everything is readable on-chain by anyone — the app just prettifies what the contract proves.
$MARGIN
- Supply
- 1,000,000,000 — 100% fair launch, no team allocation, no presale
- Utility
- slashable lever collateral — the only way $MARGIN 'does something' is by being risked
- Sinks
- per-round lever locks (recurring freeze) + 50% slash burns (permanent)
- Emissions
- none, anywhere, ever
The hard line: $MARGIN can never buy a certain outcome — only exposure. Locking raises your variance, not your odds. Thresholds are public contract constants; there is nothing to pay for an edge with.
Security
- ▸Both contracts verified on the chain explorer BEFORE the mint page goes live. One pinned CA in the LP, docs, Telegram and X pin.
- ▸No upgradeable proxies — what you audit is what runs.
- ▸No privileged round functions; open/settle are public, bounty-paid, state-gated.
- ▸The web app is read-only. Every write is wallet → contract, so a compromised web server cannot move funds.
- ▸We never DM contract addresses. Anyone DMing you one is a scammer.
FAQ
- Can I change my lever mid-round?
- No. Positions freeze at round open — that's what makes the bet honest.
- What if nobody levers?
- Rounds still fire; everyone is ×1 and it behaves like a plain stock-buying floor.
- What happens to my vault if I sell the badge?
- It travels with the badge. Buying a badge buys its accrued stock and its history.
- Who runs the rounds?
- Anyone. openRound and settleRound are permissionless; the settler earns 2% of the pot.
- Is levering gambling?
- It's a zero-sum weight game between badge holders with posted odds and public constants. Nothing is house-banked.
Disclaimer
MarginBrokers is an experimental on-chain game. $MARGIN is a utility token with no promise of profit. Badge distributions depend entirely on protocol activity and market prices of tokenized stocks; they can be small, irregular, or zero. Levering can result in loss of locked tokens. Nothing here is financial advice. Tokenized stocks are not brokerage accounts and carry their own platform risks. Participate only with what you can afford to lose, and verify the pinned contract address before any interaction.