Docs
How Bawsaq works
Everything about trading, perps, funding, the pool and the newsroom — in plain English. New here? Start with the short how it works overview and its worked example.
Overview
Bawsaq is a fictional stock market for the GTA world. It lists 43 companies from the in-game Bawsaq exchange that you can buy and sell, with perps (Long / Short) on the 10 most popular — more perps are added as liquidity increases. You trade with SOL from a Phantom wallet: put SOL in, and when you close you get SOL back based on how the price moved.
Buys and Sells trade on each stock's own bonding curve: buying puts your SOL into the curve and mints shares, selling returns shares and pays SOL out of the same curve. Perps (Long / Short) are cash-settled against a separate house pool.
Buying & selling
- Buy — you send 0.01–5 SOL. 1% is the buying fee; the rest goes into the stock's bonding curve and you get shares. Your buy nudges the price up (about 2% per SOL). No leverage, no funding and it can never be liquidated — if the price falls you can hold until you decide to sell.
- Sell — your shares go back into the curve and it pays you SOL (less a 1% fee), straight to your wallet. Selling nudges the price down, so the payout reflects your own price impact.
Long & short (perps)
Longs and shorts are perpetual futures: leveraged positions with no expiry. They pay or earn funding continuously while open. Perps are live on 10 stocks for now: CLK, BGR, SPU, ECL, PIS, AMU, FLC, VAP, WZL, FRT. More are added as the liquidity pool grows.
Perps open and close at each stock's perp index, not the spot price — see How prices move.
- Long (2× or 5×) — a leveraged buy. Your exposure is collateral × leverage, so a 10% rise at 5× is +50% on your SOL.
- Short (1×, 2× or 5×) — profits when the price falls. A 10% drop at 2× is +20%. If the price rises, you lose.
- Leverage multiplies losses too. At 5×, a move of about 19% against you liquidates the position; at 2×, about 47.5%.
How prices move
Every stock has a spot price, and perp stocks also have a perp index:
- Spot price — bonding curves. Each stock's spot price comes from its curve (constant product with 100 virtual SOL of depth). Every Buy pushes the price up and every Sell pushes it down — about 2% per SOL. News and street buzz don't move prices directly; traders do, by reacting to them.
- Perp index — the market engine. Longs and Shorts open and close at the perp index. Every 15 minutes the engine moves it by a random step sized by the stock's volatility, a drift from street buzz (up to ±2% an hour), a drift from real-world markets (up to ±0.5% an hour — see News) and a gentle pull toward its long-run level. Rare market events — a breaking story — jump it up or down (up to ±15%), and the story and the move land at the same instant so nobody can trade ahead of it. No trade and no fee ever moves the index, so it can't be pumped. Watch every input live on the engine metrics table. Every index move is recorded, with its full calculation, in each perp stock's price ledger.
Because a curve only pays out what buyers put in, buying and immediately selling just costs the fees — and the price you see is always backed by real SOL.
Perp pricing, maths & fees
Each perp stock has two prices: the spot price (its bonding curve, moved by Buys and Sells) and the perp index (moved only by the engine). Longs and Shorts open, close, liquidate and take profit at the index.
How the perp index moves
Every 15 minutes the engine moves each perp stock's index by the sum of these. No trade moves it — not a Buy, Sell, Long or Short — so it can't be pumped or dumped. Fees never move it either: they all go to perps liquidity.
- What it does
- A random up/down step every 15 min, sized by the stock's volatility. Scales with √time, so four 15-min steps ≈ one hourly move.
- Setting
- Each stock 1.2–4% per hour (1σ)
- Example
- Sprunk ≈ ±1.8%/h, ZiT ≈ ±4%/h
- What it does
- Positive buzz drifts the index up, negative buzz down, and buzz also makes moves bigger (volatility × (1 + |buzz|)). Buzz is rescored hourly from chatter on X.
- Setting
- Up to ±2.0% per hour at max buzz
- Example
- Buzz +0.5 → about +1%/h; buzz −0.5 → about −1%/h
- What it does
- Every 3h the newsroom reads real market news — stock indices, the Fed and interest rates, wars, oil and fuel prices, chip shortages, blackouts, big sell-offs — and scores each sector by how it hits its real-world counterparts (war → arms up; fuel spike → energy up, autos down; chip shortage → tech and autos down). A stock's score = 0.6 × the broad market + its sector + any direct exposure. A sudden swing to an extreme triggers a market event.
- Setting
- Up to ±0.5% per hour at max; shocks up to ±8%
- Example
- Chip crunch + tech sell-off → Fruit drifts down; conflict flares → Ammu-Nation drifts up
- What it does
- A gentle pull back toward the stock's long-run level so prices don't drift forever.
- Setting
- 1.0% of the gap per hour
- Example
- 20% above its level → pulled ~0.2%/h back
- What it does
- Breaking stories that move a perp stock up or down — a health scare, a product launch. The story and the move land at the same instant, so nobody can trade ahead of it. Direction leans with street buzz and real-world markets. The stock's long-run level moves too.
- Setting
- 1.5% chance per hour, 4%–12% (max ±15% for desk events)
- Example
- About one event per perp every ~3 days
- What it does
- Don't move the index. Spot Buys/Sells move only the spot (curve) price; every fee goes to the pool.
- Setting
- —
- Example
- Pumping spot can't game perps
| Factor | What it does | Setting | Example |
|---|---|---|---|
| Volatility (random move) | A random up/down step every 15 min, sized by the stock's volatility. Scales with √time, so four 15-min steps ≈ one hourly move. | Each stock 1.2–4% per hour (1σ) | Sprunk ≈ ±1.8%/h, ZiT ≈ ±4%/h |
| Street buzz | Positive buzz drifts the index up, negative buzz down, and buzz also makes moves bigger (volatility × (1 + |buzz|)). Buzz is rescored hourly from chatter on X. | Up to ±2.0% per hour at max buzz | Buzz +0.5 → about +1%/h; buzz −0.5 → about −1%/h |
| Real-world markets | Every 3h the newsroom reads real market news — stock indices, the Fed and interest rates, wars, oil and fuel prices, chip shortages, blackouts, big sell-offs — and scores each sector by how it hits its real-world counterparts (war → arms up; fuel spike → energy up, autos down; chip shortage → tech and autos down). A stock's score = 0.6 × the broad market + its sector + any direct exposure. A sudden swing to an extreme triggers a market event. | Up to ±0.5% per hour at max; shocks up to ±8% | Chip crunch + tech sell-off → Fruit drifts down; conflict flares → Ammu-Nation drifts up |
| Mean reversion | A gentle pull back toward the stock's long-run level so prices don't drift forever. | 1.0% of the gap per hour | 20% above its level → pulled ~0.2%/h back |
| Market events | Breaking stories that move a perp stock up or down — a health scare, a product launch. The story and the move land at the same instant, so nobody can trade ahead of it. Direction leans with street buzz and real-world markets. The stock's long-run level moves too. | 1.5% chance per hour, 4%–12% (max ±15% for desk events) | About one event per perp every ~3 days |
| Trades & fees | Don't move the index. Spot Buys/Sells move only the spot (curve) price; every fee goes to the pool. | — | Pumping spot can't game perps |
Perp maths
- Formula
- 1% of your deposit
- Example: 0.1 SOL, 5× Long
- 0.001 SOL fee → 0.099 SOL collateral
- Formula
- collateral × leverage
- Example: 0.1 SOL, 5× Long
- 0.099 × 5 = 0.495 SOL
- Formula
- the perp index when you open
- Example: 0.1 SOL, 5× Long
- $50.00
- Formula
- collateral × leverage × index move (shorts: reversed) − funding
- Example: 0.1 SOL, 5× Long
- Index +10% → +0.0495 SOL (+50%)
- Formula
- More-crowded side pays the other, accrues every second, up to ±0.10% of exposure per hour
- Example: 0.1 SOL, 5× Long
- 0.495 SOL × 0.05%/h ≈ 0.00025 SOL/h
- Formula
- when only 5% of your collateral is left (a 95% loss) → price = entry × (1 ∓ 0.95 ÷ leverage). 5×: 19% move, 2×: 47.5%
- Example: 0.1 SOL, 5× Long
- 5× Long: index −19% → $40.50
- Formula
- value ≥ collateral × 6 (+500%) → closed automatically
- Example: 0.1 SOL, 5× Long
- 5× Long: index +100% → $100.00
- Formula
- 1% of the payout
- Example: 0.1 SOL, 5× Long
- —
- Formula
- current value + collateral × min(5, leverage × 0.3), capped at the max payout
- Example: 0.1 SOL, 5× Long
- 0.099 + 0.099 × 1.5 = 0.2475 SOL set aside
| Formula | Example: 0.1 SOL, 5× Long | |
|---|---|---|
| Fee to open | 1% of your deposit | 0.001 SOL fee → 0.099 SOL collateral |
| Exposure | collateral × leverage | 0.099 × 5 = 0.495 SOL |
| Entry price | the perp index when you open | $50.00 |
| Profit / loss | collateral × leverage × index move (shorts: reversed) − funding | Index +10% → +0.0495 SOL (+50%) |
| Funding | More-crowded side pays the other, accrues every second, up to ±0.10% of exposure per hour | 0.495 SOL × 0.05%/h ≈ 0.00025 SOL/h |
| Liquidation | when only 5% of your collateral is left (a 95% loss) → price = entry × (1 ∓ 0.95 ÷ leverage). 5×: 19% move, 2×: 47.5% | 5× Long: index −19% → $40.50 |
| Take-profit cap | value ≥ collateral × 6 (+500%) → closed automatically | 5× Long: index +100% → $100.00 |
| Fee to close | 1% of the payout | — |
| Pool reserve | current value + collateral × min(5, leverage × 0.3), capped at the max payout | 0.099 + 0.099 × 1.5 = 0.2475 SOL set aside |
Where every fee goes
- Fee
- 1% of deposit
- SOL goes to
- House pool (backs perps)
- Fee
- 1% of payout
- SOL goes to
- House pool (backs perps)
- Fee
- 1% of deposit
- SOL goes to
- House pool (backs perps)
- Fee
- 1% of payout
- SOL goes to
- House pool (backs perps)
- Fee
- whatever is sent in
- SOL goes to
- House pool (backs perps)
- Fee
- whole collateral
- SOL goes to
- House pool (backs perps)
| Fee source | Fee | SOL goes to |
|---|---|---|
| Buy | 1% of deposit | House pool (backs perps) |
| Sell | 1% of payout | House pool (backs perps) |
| Open Long / Short | 1% of deposit | House pool (backs perps) |
| Close Long / Short | 1% of payout | House pool (backs perps) |
| Project token creator fees | whatever is sent in | House pool (backs perps) |
| Liquidated perp | whole collateral | House pool (backs perps) |
100% of every fee goes to the house pool — the escrow balance minus the SOL locked in the curves — which is the liquidity that pays perp winners. Every trade and liquidation makes it deeper, so bigger positions and more perp markets can open. The curves stay fully backed by buyers' SOL.
Price ledger
Every perp stock has a public price ledger — open it from the stock's page or the Perps page (example: CLK). It lists every change to the perp index, newest first, so you can check that no move was made up or slipped in.
- What each entry shows — the index before and after, the type (15-minute engine step, market event, macro shock or admin event), and for engine steps every input and term of the formula: volatility, buzz, macro score, mean reversion, the random draw, drift and the resulting price. Events show their size, source and the story they came with.
- Two timestamps — calculated is when the engine worked out the move; applied is the database's own clock at the moment the price changed. The entry is written in the same database transaction as the price change, so a price can't change without an entry, and the gap between the two clocks is milliseconds.
- Random draws you can check — nothing random is picked freely. Each step's random move and its market-event roll (whether an event fires, which way, and how big) come from SHA-256 of one seed: the previous ledger hash, the ticker and the calculation time. Every step records its roll, so the ledger proves both the events that happened and the ones that didn't.
- Tamper-evident — entries are append-only (the database rejects edits and deletes) and hash-chained: each hash is SHA-256(previous hash | entry). Changing any past entry would break every hash after it.
- Verified in your browser — the ledger page re-computes every hash, chain link, random draw and formula on your own device, checks that each entry starts exactly where the previous one ended (so no change happened off the ledger), and marks each entry Verified or Failed. The raw data is public at
/api/ledger/<TICKER>if you want to check it yourself.
The engine formula: next = before × exp((reversion + buzz drift + macro drift − σ²/2)·dt + σ·√dt·z), with σ = volatility × (1 + |buzz| + ½|macro|), rounded to 4 decimals. Spot prices aren't in the ledger — they move only with Buys and Sells on the curve, which are on-chain.
Funding rates
Funding keeps longs and shorts balanced. The more crowded side pays the other a small percentage of their exposure, accruing every second. The rate is quoted per hour and updates instantly whenever anyone opens or closes a Long or Short. If there are more longs than shorts, longs pay; if more shorts, shorts pay. Buys are funding-free and don't count toward the balance — funding only applies to leveraged Longs and to Shorts.
- The rate depends on how lopsided the stock is, up to 0.10% per hour (about 2.4% a day).
- The current rate is shown on each stock's trade panel as “you pay” or “you earn”.
- Funding builds up second by second while the position is open (you can watch it on your positions) and is settled when you close. It counts toward liquidation.
Liquidation, stop-loss & take-profit
- Liquidation (perps only) — Buys are never liquidated. For a Long or Short, once your position has lost 95% of its collateral (only 5% left, after funding) it's closed and nothing is paid back. That's a 19% index move against you at 5×, 47.5% at 2×. It's checked every time the index moves (every 15 minutes, and right after a market event). The trade panel shows your liquidation price and how far it is from your entry.
- Stop-loss (perps only, optional) — on any open Long or Short, tap Set stop and pick a perp-index price: below the index for a Long, above it for a Short, and before your liquidation price. Your wallet signs the change (setting, editing and removing all need your signature, so nobody else can touch it). It's checked every time the index moves; once the index reaches your stop, the position closes at the index and the payout goes straight to your wallet. The index moves in steps, so the exit can land past your stop — it's a stop-market, not a guaranteed price.
- Take-profit cap (perps only) — Buys have unlimited upside. The most a Long or Short can win is +500% of its collateral. When it hits that, it's closed automatically and paid out. The trade panel shows the take-profit price.
- You can never lose more than you put in. There are no margin calls or extra deposits.
Liquidity pool
All SOL sits in one escrow wallet. Every fee — buying, selling, opening and closing — plus the project token's creator fees and liquidated collateral stays there as perps liquidity, so the pool grows with every trade. The Pool page shows its live balance, what it owes right now, utilization, long vs short open interest and recent trades. You can verify the wallet on the Solana explorer.
Two pools. Spot Buys live in their bonding curves — every share is backed by the SOL buyers paid in, so the curves can always pay sellers. Perps are paid from the separate house pool, which must cover each open Long or Short's current value plus a 30% stress move. If it can't take a new perp, your deposit is refunded automatically.
Fees & limits
| Position size | 0.01–5 SOL |
| Spot | Buy / Sell all 43 stocks · 1× · no funding · no liquidation |
| Perps | Long 2× / 5× · Short 1× / 2× / 5× on 10 stocks |
| Fee to buy / open | 1% of your deposit (Buy, Long and Short) |
| Fee to sell / close | 1% of the payout |
| Funding | Longs & Shorts: up to ±0.10% of exposure per hour · Buy: none |
| Max profit | Buys: unlimited · Perps: +500% of your position (auto take-profit) |
| Where fees go | 100% to the house pool (perps liquidity) |
| Liquidation | Perps only: after losing 95% of collateral (19% index move at 5×) |
| Curve depth | 100 virtual SOL per stock — about 2% price move per SOL bought or sold |
| Network fees | Normal Solana transaction fees (fractions of a cent) |
News & Local News Stories
- Breaking news — every hour the newsroom writes a story about the biggest mover, by one of our fictional reporters.
- Market events — rare breaking stories that move a perp stock's index at the moment they publish (see How prices move).
- Opening Bell — each day one listed company “rings the bell” with a feature story.
- Local News Stories — every few hours the newsroom scans Bleeter for the wildest player gameplay videos, watches them, and files an in-world news story. Each article embeds the original post, and on the homepage they play in story mode with the player's video behind the headline. Links are checked against X before publishing.
- Buzz — social chatter on X feeds each stock's buzz score (rescored every hour). Positive buzz drifts the perp index up, negative buzz down, up to ±2% an hour.
- Real-world markets — every few hours the newsroom reads real market news (indices, the Fed, wars, oil and fuel, chip shortages, blackouts, sell-offs) and scores each sector the way that news hits its real-world counterparts. That pressure drifts the perp index up to ±0.5% an hour, and a sudden swing can trigger a market event. Live snapshot: /api/macro.
Wallets & settlement
- Connect Phantom, Solflare or Backpack. On a phone, tap the wallet button → Open in Phantom (or your wallet): Bawsaq opens inside the wallet app and asks you to approve.
- Opening sends your SOL to the pool in a normal Solana transfer. The server reads the amount from the blockchain — each deposit can only open one position.
- Closing asks you to sign a message (free, no transaction) to prove the position is yours. The pool then sends your payout in a new transaction.
- Every deposit and payout links to the Solana explorer from your positions.
FAQ
Are these real stocks?
No. They're fictional companies from the GTA universe. Prices come from our engine and from trading on Bawsaq.
How many shares are there?
As many as people have bought. Each stock's bonding curve creates shares when you buy and removes them when you sell, so supply and market cap (shares held × price) grow with demand. Every share is backed by the SOL buyers put into that curve.
Can I lose more than I deposit?
No. The worst case is losing the collateral of that position.
Why was my deposit refunded?
The amount was outside the allowed size, you tried a Long/Short on a stock without perps, or the house pool didn't have room for that perp at that moment. Refunds return your full deposit with no fee.
Why did the price move when I traded?
Buys and Sells trade on the stock's bonding curve, so they move its spot price — about 2% per SOL. Longs and Shorts never move any price.
Why are the spot price and the perp index different?
They're set differently: spot by Buys and Sells on the curve, the perp index by the market engine. Keeping them separate means nobody can pump the spot price to profit on a perp.
Can I set a stop-loss?
Yes, on any open Long or Short: tap Set stop on the position, choose a perp-index price and sign it in your wallet. It closes the position when the index reaches it (at the index, which can be past your stop). See Liquidation, stop-loss & take-profit.
How do I know prices aren't manipulated?
Every perp index move is in the stock's public price ledger with its full calculation, the time it was calculated and the time it was applied, hash-chained and checked in your browser. Spot prices only move with trades on the bonding curve. See Price ledger.
Where do fees go?
All fees (1% to buy/open, 1% to sell/close), the project token's creator fees and liquidated collateral go to the house pool — the liquidity that backs perps. Every trade makes the pool deeper, so bigger perp positions and more perp markets can open.
Is this real money?
Yes. Bawsaq runs on Solana mainnet: deposits and payouts are real SOL. Only trade what you can afford to lose.
Fictional companies for entertainment. Not affiliated with Rockstar Games. Not financial advice.