Documentation

How the market works.

Everything souk does, in plain language. No prior crypto knowledge assumed.

What souk is

souk is a place to open a stall — a token that carries an idea, a project or a community, deployed on Robinhood Chain in about a minute.

You bring a name, a ticker and a sentence about why it exists. souk deploys the token and its bonding curve, and the stall is tradeable the moment the transaction lands. You need no starting capital — the curve is the liquidity. You sign every step from your own wallet.

souk is a launch tool, not an investment product. Opening a stall creates a token — it does not create demand for it. That part is on you and the people who show up.

Opening a stall

1. Make it yours

  • Image — paste a URL. A dropped file previews in the form but is not stored; souk has no file hosting yet, so a stall with no image URL gets generated art from its ticker.
  • Name — up to 42 characters. What people will call it.
  • Ticker — up to 12 characters, uppercase, shown everywhere as $TICKER.
  • Story — optional, up to 1,000 characters, and the single thing most likely to make someone care.

2. Choose the graduation pair

Your stall trades against ETH while it is on the curve. This picks the pair it opens with on a DEX once the curve fills.

3. Open it up

Review, then sign. Opening costs gas and nothing else. You can add a first buy in the same transaction — it executes at the opening price, before anyone else can reach it.

Choosing a pairing

Your pairing is what people buy your token with. It sets who can reach you easily and how the price behaves.

PairingBest whenTrade-off
WETHYou want the widest possible reachYour price moves with ETH
USDTYou want a price people can read in dollarsThinner buyer pool
A tokenized stockThe idea is about a company — pair the coin to the equity itselfYour price moves with that stock, including when the market is shut
Any tokenYou're building alongside an existing communityYou inherit that token's volatility

Pairing against a community's own token is the sharpest tool here. It puts you inside a crowd that already exists — and ties your chart to theirs.

How trading works

A new stall trades on a bonding curve rather than a normal pool. The curve holds the entire supply and sells it along a fixed pricing function: buying takes tokens out and puts ETH in, so the price rises; selling puts tokens back and takes ETH out, so it falls. There is no counterparty and no order book — the contract quotes both sides, always.

Because the curve is the liquidity, a creator never has to fund a pool, and there is no creator LP position for anyone to pull.

Graduation

When a stall's curve has taken in 5 ETH, it graduates automatically, inside the same transaction that crosses the line:

  • The curve closes permanently. No more buys, no more sells.
  • All the ETH it raised, plus 200,000,000 tokens held back for the purpose, go into a DEX pool.
  • The LP tokens are sent to the burn address. Nobody holds them — not the creator, not souk.
  • Any tokens still unsold on the curve are burned, so nothing is left over for anyone to sell into the market later.

After that the stall is an ordinary token on an ordinary DEX pool, with locked liquidity and no owner.

Fees

WhatHow muchWho receives it
Opening a stallGas onlyRobinhood Chain sequencer
Trade fee on the curve1% each waysouk
GraduatingFree

The factory cannot charge more than 5% on a trade — that ceiling is written into the contract, not into this page, and it applies to whoever owns the factory. Creator fee sharing isn't built yet; see My tokens for what a stall you opened is worth today.

Contracts

souk runs on Robinhood Chain mainnet, chain 4663 — an Ethereum layer 2 where tokenized equities settle natively. Every stall is deployed from the same factory, so each token's bytecode is identical and verifiable on the explorer.

Three contracts, all immutable once deployed:

ContractWhat it does
SoukFactoryOpens stalls. The owner can change the settings that apply to future stalls and nothing else — there is no function on it that can touch a curve that already exists.
SoukCurveOne per stall. Holds the supply, quotes both sides, graduates. Has no owner, no withdraw, no pause.
SoukTokenThe token. See below.

What a souk token cannot do

We filter other people's pools for honeypots. For our own, we make it impossible instead — not by policy, but by leaving the code out:

  • No owner. There is no privileged address. Nobody can pause it, tax it, or blacklist a holder.
  • No mint. The whole supply is created once, in the constructor. It cannot grow.
  • No transfer hook and no tax. A transfer is a transfer. Selling cannot be blocked, because there is no code that could block it.
  • No creator liquidity. The curve holds it, and at graduation the LP is burned.

None of that is a promise you have to take on trust. Every stall comes from the same factory, so the bytecode is identical every time — read it once and you have read them all.

Not audited

These contracts have not been through a third-party audit. They have a test suite covering the curve maths, solvency across many trades, reentrancy, slippage, graduation and the absence of privileged functions — but a test suite is written by the same people who wrote the bug. Treat anything you put in as money you are prepared to lose entirely, and size accordingly.

Market data

Every price, market cap, volume figure and candle in the market is read live from Robinhood Chain — nothing here is illustrative.

  • Source — the GeckoTerminal public API, which indexes Uniswap, Pons and the other Robinhood Chain DEXes.
  • Candles — real OHLCV, available at 15m, 1H, 4H and 1D on any stall's page.
  • Refresh — the market re-reads prices every 90 seconds while the tab is open.

The feed allows 30 requests a minute, so souk caches every response for the session and loads a whole market view in a single call. If you see a rate-limit notice, wait a moment and refresh — nothing is broken.

Safety

Anyone can open a stall, which means anyone can open a bad one. A few things worth doing before you buy:

  • Read the address. Names and tickers can be copied. Contract addresses can't.
  • Look at who holds it. One wallet holding most of the supply can end the chart on a whim.
  • Check the age. A stall open for nine minutes has no track record, whatever the chart says.
  • Size it honestly. Treat anything here as money you're prepared to lose entirely.

souk does not endorse or review the stalls in the market, and a stall passing the checks below is not a recommendation. The Official badge marks souk's own token and nothing else.

What souk hides, and why

Some stalls are not stalls. They are traps dressed as one, and a market that lists them is part of the trap. souk runs four checks on every pool. All four are arithmetic on public trade data — no opinion, no allowlist, no one deciding who deserves to be here.

CheckWhat it catchesThreshold
Sells per buyA pool people can buy into but not sell out of. On an honest pool, buys and sells run roughly even because every buyer eventually becomes a seller.Under 0.35, with at least 120 trades
Liquidity vs market capA large price balanced on a puddle. If the pool holds a fraction of a percent of the token's supposed worth, that price is a number on a screen, not an amount you can leave with.Under 0.5%, above $1M market cap
Volume vs liquidityManufactured volume — the same handful of wallets trading a token back and forth to buy a place on a trending list.Over 50× in 24h, alongside a move over 500%
Whether a market exists at allTicker-squatting. Someone opens fifteen pools named after a token people are searching for, puts a few thousand dollars in each, and waits for a mistake.Under $10,000 liquidity with no trades, or under $100 traded, in 24h

A pool that trips any of these is not listed on souk. It does not appear in the market, it does not appear in search, and it has no page — opening its address directly gets you a notice, not a chart. The market shows a count of what was removed so you know the filtering happened.

Softer signals — thin liquidity, unusual churn, a missing market cap — are a different matter. Those are facts about a real market, not evidence of a trap, so nothing is hidden. They get a note on the card and a panel on the stall's page.

souk shows no price, no chart and no market cap for a pool that fails a check. Putting a scam's chart in front of someone with a warning attached is still putting the chart in front of them.

These checks catch pools that are already behaving badly. They cannot catch a stall that has not rugged yet, a team that intends to leave, or a chart that is simply going to go down. Everything in the Safety section above still applies.