FAQ

Basics#

What does it cost to launch a token?#

Nothing beyond network gas.

Can I change my token's name, supply, or image?#

Name, symbol, and supply are on-chain and permanent. There is no mint and no burn. The image and description live off-chain and can be updated by the creator; the tokenURI() pointing at them cannot be changed by anyone.

How long does graduation take?#

It is not a waiting period. It happens inside the buy that sells out the curve. What varies is how long a curve takes to fill, and that is entirely down to demand.

Does graduation mean a token is good?#

No. It means the curve filled. It says nothing about future liquidity, price, or your ability to exit.

Trading#

What are the fees?#

2% on curve trades, 0.30% on swaps. Full breakdown of who receives what is on fees.

What if I buy more than the curve has left?#

The contract uses only what it needs and refunds the rest in the same transaction. You cannot overpay into a graduation.

Can I sell before graduation?#

Yes. Curve sells are available the whole time the curve is active, priced by the same invariant in reverse. You cannot sell more than the curve has circulated.

Why did my trade revert with NOT_ACTIVE?#

The launch graduated. Route through JoseonSwapRouter instead of the curve. A UI holding stale state is the usual cause.

Why did my trade revert with SLIPPAGE?#

Someone traded between your quote and your transaction. Re-quote and retry, or widen your minimum-out.

Is there MEV or front-running here?#

On the curve, ordering matters as it does on any AMM: an earlier buy gets a better price. What is specifically prevented is interfering with a graduation. The pool a launch graduates into is reserved when the token is created, cannot be traded before the migration opens it, and anything sent to it beforehand is swept out — so it cannot be front-run at a fake price or blocked by occupying it.

Two tokens have the same name. Which is real?#

Whichever address you meant. Names, symbols, and images are all copyable, and nothing here is vetted. Check the token address, the creator, and the holder distribution before trading.

Liquidity#

Can liquidity be pulled after graduation?#

Not the initial position. It is held by a locker with no withdraw function. Liquidity added by others afterwards belongs to them and can be removed by them.

How much liquidity does a graduated pool start with?#

3.6 WETH against 200,000,000 tokens — 7.2 ETH of TVL at an 18 ETH FDV.

Can I add liquidity to a graduated pool?#

Yes, exactly like any V2 pair, and you receive LP tokens for your share.

Creators#

When and how do I get paid?#

Curve fees accrue as people trade, and you claim them from your curve. After graduation, 0.15% of swap volume accrues in the pool and you claim it there. Both are pull-based, nothing expires, and the app shows both balances in Portfolio.

Do my fees stop after graduation?#

No, they change source. Curve fees are capped at roughly 0.051 ETH total; swap fees are 0.15% of volume indefinitely. Past ~34 ETH of post-graduation volume, swap fees have paid you more than the entire curve did.

Can I split fees between wallets?#

Not at the protocol level. The registry stores one fee recipient address per launch, so there is nothing to divide. The app briefly offered a percentage split, but the percentages were never enforced on-chain, so it was removed. For a real split, set the fee recipient to a splitter contract you control.

Can I hand a token over to someone else?#

Yes, via CTO. Only the protocol's immutable feeAdmin can reassign the fee recipient — requiring the current recipient to sign would mean an abandoned project could never be taken over. It moves future fees only; anything already earned stays with whoever earned it. The token, the pool, the price, and the locked liquidity are untouched.

Building#

Is there an SDK?#

No, and deliberately. The contracts are simple enough that viem plus a few ABI fragments covers it, with nothing to keep in sync across stack versions. See contract calls.

Do I need an API key?#

No. Reads on api.joseon.fun are public and CORS-open.

Why are amounts strings in the API?#

They are base-unit integers, and a 1e27 token supply overflows a JS number. Parse with BigInt.

How fresh is the API?#

Seconds. One indexing loop runs continuously a few blocks behind the head and pushes events over a WebSocket, and a wallet action nudges a pass immediately rather than waiting for a timer.

Why is my token unverified on the explorer?#

The explorer does not automatically match a freshly deployed token and curve against already-verified bytecode. We submit them shortly after launch — see network.

Risk#

What can the team do to my token?#

Not mint, not move balances, not drain a curve, not unlock liquidity, not repoint metadata. The admin keys control where the protocol's own fee share goes and which launch factory may graduate. Full list on safety and risk.

Can I lose money?#

Yes. Tokens can be created by anyone, and any launch can result in a total loss.