# Flonk

> flonk (https://flonklaunch.xyz) is a Solana memecoin launchpad on Raydium LaunchLab. any coin can be paired to SOL, USDC, BONK or a tokenized stock (xStocks: SPYx, NVDAx, TSLAx, AAPLx, QQQx, SPCXx, GOOGLx, METAx, CRCLx, MSTRx). buyers pay in the pair token and sellers get it back. the API only returns unsigned transactions; your wallet signs everything. flonk never holds keys or funds and never swaps for you.

## Flow
1. GET /api/config: pair tokens (symbol, mint, decimals, token program, live USD price, paused), the curve, and fee tiers. v1 lists on the 1% tier only (0.60% flonk, 0.15% creator, 0.25% Raydium).
2. Sign in once a day (free, no transaction): sign this exact message with your wallet, then POST /api/chain {op:"session", wallet, domain, nonce, ts, signature} -> {token}. Message: "<domain> wants you to sign in with your Solana account:\n<wallet>\n\nSign in to flonk. Free, no transaction.\n\nURI: https://<domain>\nVersion: 1\nChain ID: solana:mainnet (solana:devnet on the demo)\nNonce: <8-40 letters/digits>\nIssued At: <ISO time of ts>". domain = the host you call; ts = now in ms (valid 5 minutes); signature base64.
3. POST /api/upload {dataUrl, wallet, token}: host the coin image (PNG/JPEG/WEBP/GIF, max 1 MB), returns {url}.
4. POST /api/launch {creator, name, symbol, image, description?, links?, quote, tier:"standard", buy?, vanity?:true, mint?}: returns the unsigned launch transactions and the mint. Tickers are unique on flonk (409 if taken). The dev buy is capped at 2% of supply. With vanity:true the mint is a reserved address ending in FLoNK when one is available; otherwise send your own fresh mint keypair's address as mint. So most flonk coins end in FLoNK, not all: the source of truth for a coin's contract address is its page on https://flonklaunch.xyz.
5. Sign each transaction with your wallet (and your mint keypair if you supplied the mint), then POST /api/send {tx, vanityMint?} for each, in order.
6. Trade: POST /api/trade {wallet, pool, side:"buy"|"sell", amount, slippageBps?} -> sign -> POST /api/send {tx}.

## Read-only
- GET /api/chain?op=coins: listed coins (pool, mint, name, symbol, quote, progress, volume, status 0 curve / 1 uplisting / 2 uplisted)
- GET /api/chain?op=coin&id=<coin id>: one coin
- GET /api/quote?pool=<pool>&side=buy|sell&amount=<base units>
- GET /api/chain?op=ticker: recent listings and trades
- GET /api/chain?op=bonkburn: $BONK burned by flonk's fee wallet, each with its tx

## Units
Integer base units as strings, in the pair token's own decimals (from /api/config): SOL 9, USDC 6, BONK 5, xStocks 8. Flonk coins have 6 decimals.

## Pages
/ (coins), /list (list a coin), /coin?c=<id>, /burns, /analytics, /docs, /docs/risks, /terms, /privacy