Wun Docs.
How to use Wun, step by step, and the technical reference. The rules themselves are on the Rules page.
Guides
Getting Started
Wun runs on Robinhood Chain Testnet. You trade from your own wallet: every launch, trade and claim is a transaction you approve. Wun never holds your funds.
- 01
Connect a wallet
Use Connect wallet at the top right. Rainbow, MetaMask, Coinbase Wallet and Rabby are offered, or any browser wallet.
- 02
Use the right network
Your wallet must be on Robinhood Chain Testnet (chain ID 46630). The app asks to switch when it is not.
- 03
Have ETH
Trades are paid in ETH, and every transaction needs a little ETH for gas.
- 04
Have USDG for a membership
Memberships are paid in USDG. You only need one to trade in Pre-bond or to launch.
Guides
Get a Membership
A membership lets you trade in Pre-bond and launch tokens. From Stage 1, anyone can trade without one. Why Pre-bond is for members
- 01
Open Membership
Choose Monthly (10 USDG) or Lifetime (100 USDG once).
- 02
Approve USDG
If your wallet has not allowed the membership contract to take USDG yet, it asks for that first.
- 03
Confirm the purchase
A second signature buys the membership. It is held onchain by your wallet; there is no account and no automatic charge.
- 04
Renew when you like
A monthly renewal extends your current expiry and keeps your day of the month. An expired membership starts a new month from the purchase. Lifetime never expires.
Guides
Trade a Token
Every market trades in its own pool. The limits that apply depend on the market's stage and are shown before you sign. The limits
- 01
Open a market
Pick a token on Markets. Check its address, stage and fee in the page header.
- 02
Enter an amount
On Buy, enter what you pay in ETH; on Sell, the tokens you sell. The panel shows what you receive after fees.
- 03
Set slippage
0.5%, 1%, 3% or your own. A trade that would fill at a worse price than that is refused, not executed.
- 04
Check your limits, then sign
The panel shows your remaining limits for the stage. One notice follows the trade from your wallet to the receipt.
Guides
Claim Rewards
Rewards wait in each token's reward vault until you claim them. Nothing expires, and nobody claims for you. How rewards are credited
- 01
On a token's page
Your Position shows what you can claim in that market. Press Claim.
- 02
Across all markets
Portfolio › Rewards lists every market with something to claim.
- 03
Creators
On creator-reward tokens the reward share is claimed by the creator, the same way.
- 04
First-buy escrow
Portfolio › Launches shows a first buy's escrow and when it can be withdrawn: at Stage 1 or after seven days. Escrow rules
Guides
Launch a Token
A launch creates the token, its pool and its reward vault in one transaction. What you set at launch is fixed for good. Fees and who earns them
- 01
Identity
An image (PNG, JPEG or WebP, up to 2 MB), a name, a symbol of up to 12 letters and digits, a description, and an optional website and X account. All of it is stored on IPFS and cannot change after launch.
- 02
Market
The quote asset the token trades against, and its trading fee: 1% to 5%, in whole percent.
- 03
Who earns the rewards
The fee's reward share goes to the token's holders or to you, the creator. Chosen once.
- 04
Optional paid first buy
Buy up to 800M tokens inside the launch, at the same price and fee as anyone. They wait in escrow for the beneficiary wallet you name.
- 05
Sign twice
First a free sign-in message, so the image and details can be stored; then the launch transaction, with the launch charge and gas.
Guides
Stay Safe
Tokens on Wun are created by anyone. The contracts enforce the rules; they do not vouch for a token.
- Check the address
- Names, symbols and images can be copied. The token address is the only identity.
- Read before you sign
- Your wallet shows what a transaction does. If it is not what you expected, reject it.
- Never share a seed phrase
- Wun never asks for a seed phrase or private key, and never asks you to send funds to anyone.
- Values are estimates
- Quotes and USD amounts are estimates. USD uses the current ETH/USD reference price (Coinbase, Kraken as fallback).
- Tokens can go to zero
- New tokens are highly speculative and can lose all of their value. Only trade what you can afford to lose.
Reference
Network
Where Wun runs and the values every launch shares.
- Network
- Robinhood Chain Testnet
- Chain ID
- 46630
- Native asset
- ETH
- Public RPC
- https://rpc.testnet.chain.robinhood.com
- Supply per token
- 1,000,000,000
- Launch charge
- —
- Membership asset
- USDG
Reference
Contracts
The deployed contracts, read from the API's configuration. Every address links to the explorer.
Contract addresses appear here once Wun is deployed.
Reference
Events to Index
Onchain events are the source of truth. These are the ones that describe launches, trades, rewards and memberships.
| Contract | Event | What it records |
|---|---|---|
| Factory | Launched | A new token: its creator, quote asset, escrow, reward vault, fee and reward model, and metadata URI. |
| Engine | Trade | Every buy and sell: tokens, gross quote, the fee and the platform's share, the pool's principal and the stage. |
| Engine | StageAdvanced | A market reached Stage 1 or Stage 2. |
| Engine | CreatorFirstBuy | The creator's paid first buy inside a launch. |
| Reward vault | RewardCredited | A trade's reward share was credited to the vault's holders. |
| Reward vault | RewardsClaimed | A wallet claimed its rewards. |
| Reward vault | SharesUpdated | A wallet's reward weight changed: it crossed the 100,000 line or its balance moved. |
| Token | TransferLock | Tokens received by transfer and the time their cooldown ends. |
| Escrow | Released | First-buy tokens withdrawn from escrow. |
| Subscriptions | Purchased | A membership: monthly or lifetime, and its expiry. |
Reference
Errors
When the contracts refuse a transaction, the app shows the reason in plain words. Here is each reason and what it means.
| Reason | What it means |
|---|---|
SUBSCRIPTION | Pre-bond trading requires an active membership. |
ROLLING_LIMIT | This exceeds your rolling 15-minute limit for this stage. |
HOLDING_CAP | Pre-bond wallets can hold at most 20,000,000 tokens (2% of supply). |
TRANSFER_LOCKED | Part of your balance was received by transfer and is still in its cooldown. |
SLIPPAGE | Price moved beyond your slippage limit. Get a new quote. |
ORDER | The order expired or trading is paused. Try again. |
DIRECTION | Amount is too small to trade. |
RESERVE_EXHAUSTED | Not enough quote reserves in the pool for this sale. |
STAGE_TRANSACTION_GUARD | The market just changed stage. Sell in a new transaction. |
| Rejected | You rejected the request in your wallet. Nothing was sent. |
| Insufficient funds | Your wallet doesn't have enough ETH for the transaction and its gas. |
Reference
API
The API serves indexed data for the site. It is read-only for markets and wallets; the chain stays the authority.
- Base URL
- https://api-test.wun.fun
- Reference
- API documentation ↗
| Endpoint | Returns |
|---|---|
GET /v1/config | Chain, contract addresses, launch charge and quote assets |
GET /v1/discovery | The launch floor: markets, sorts, stage filter and search |
GET /v1/tokens/{token} | One market: stage, fee, reward model and reserves |
GET /v1/tokens/{token}/trades | A market's trades, newest first |
GET /v1/wallets/{wallet}/subscription | A wallet's membership: kind, expiry, active |
GET /v1/prices/eth-usd | The ETH/USD reference price used for display |
Reference
Glossary
The words the site uses, one name for each thing.
- Launch
- Creating a token on Wun.
- Launch floor
- The list of all tokens, on Markets.
- Stage
- Pre-bond, Stage 1 and Stage 2, set by how many tokens are left in the pool.
- Pre-bond
- The first stage of every market, open to members.
- Membership
- What lets a wallet trade in Pre-bond and launch tokens.
- Trading fee
- The 1% to 5% on every buy and sell, fixed at launch.
- Holder rewards
- The fee share paid to a token's holders, by balance, from 100,000 tokens.
- Reward vault
- The contract that holds a token's rewards until they are claimed.
- Claim
- Pulling your rewards from the vault to your wallet.
- First buy
- The creator's optional paid purchase at launch.
- Escrow
- Where first-buy tokens wait until Stage 1 or seven days.
- Transfer cooldown
- The wait before tokens received by transfer can be sold.
- Sell limit
- The most a wallet can sell in any 15 minutes, by stage.
- $WUN
- Wun's platform token; half the platform's trading revenue goes to its holders.
- Treasury
- The platform's 2-of-3 Safe.