> For the complete documentation index, see [llms.txt](https://stonkmarket.gitbook.io/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://stonkmarket.gitbook.io/docs/stonk-v3/v3.md).

# Overview

v3 is the third generation of the stonk.market launchpad. It keeps everything v2 did — a token launched into a Uniswap v4 pool, trading only while the NYSE is open — and changes what happens to the fees, how a launch opens, and who gets to keep a ticker.

{% hint style="info" %}
**v3 is live on Robinhood Chain mainnet** (chainId 4663) since 14 September 2026 — real money. Addresses and every live parameter are in [Mainnet Deployment](/docs/stonk-v3/deployments-mainnet.md). Base mainnet has no v3 deployment and still runs [v2](/docs/reference/deployments.md), as does Robinhood Chain's own v2 deployment, which stays live alongside this one.
{% endhint %}

## What's new, in one line each

|                    | v2                                             | v3                                                                                          |
| ------------------ | ---------------------------------------------- | ------------------------------------------------------------------------------------------- |
| **Fees**           | 1% split three ways, all of it leaves the pool | 1% split **four** ways — a tenth of every fee becomes liquidity that can never be withdrawn |
| **$market**        | didn't exist                                   | a protocol token funded by 30% of every other token's fees, bought and burned               |
| **Opening**        | every launch waits for the next bell           | launched during market hours? **trades immediately**                                        |
| **Snipers**        | a 5% wallet cap, and nothing else              | the first second of trading costs **99%**, decaying to 1% over 3 seconds                    |
| **Tickers**        | first come, first served, for ever             | a ticker is **exclusive for 48 hours**, then anyone may reuse it                            |
| **Trading window** | hardcoded NYSE                                 | any schedule, chosen per token from a registry of oracles                                   |

## The three things worth understanding

* [**Fees and where they go**](/docs/stonk-v3/fees.md) — the four-way split, why 40% of every fee can never be withdrawn by anybody, and what you have to call to get paid.
* [**How a launch opens**](/docs/stonk-v3/launch-mechanics.md) — immediate vs. the bell, the decaying anti-snipe fee, and the 48-hour ticker lock.
* [**Mainnet deployment**](/docs/stonk-v3/deployments-mainnet.md) — every live address and parameter on Robinhood Chain, read back off the chain. The [testnet stack](/docs/stonk-v3/deployments-testnet.md) is documented separately.

## Architecture

Nine contracts. The factory launches tokens; the hook is where every trade is priced.

```
StonkFactoryV3 ──── launches ────> StonkTokenV3 (a clone per token)
      │                                   │
      │ registers the pool                │ reads its trading window from
      ▼                                   ▼
  StonkHookV3  <──── every swap ──── NyseWindowOracle ──> NYSE calendar
      │                                   ▲
      │ withholds the fee                 │ must be listed in
      ▼                                   │
  ├─ permanent liquidity (stays in the pool, for ever)
  └─ StonkFeeLocker ──> creator, treasury, and
                        StonkFeeRouter ──> StonkBuyback      (buys $market and burns it)
                                      └──> StonkLiquidityRouter (deepens $market's pool)

  StonkNameRegistry — who holds which ticker, and until when
  StonkOracleRegistry — which trading-window schedules a launch may choose
  StonkLens — read-only helpers for frontends
```

### Why the hook matters more than the factory

The factory runs once per token. The hook runs on **every single trade**, and it is the contract that decides four things at once: whether the market is open, what the fee is right now, how much of that fee stays in the pool for ever, and whether the buy would breach the wallet cap. If you only read one contract, read that one.

## What hasn't changed

* **Trading is still gated on real market hours.** A stonk token cannot be transferred when the NYSE is shut. That includes $market itself in v3 — see [Fees](/docs/stonk-v3/fees.md#a-consequence-worth-knowing).
* **Liquidity still can't be pulled.** No launch, no creator, and no admin can remove liquidity from a stonk pool. v3 makes that stronger, not weaker.
* **There is no owner on a launched token.** The only mutable field is the metadata URI, and only the creator can change it.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://stonkmarket.gitbook.io/docs/stonk-v3/v3.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.