Docs
Everything about how Stocklings works, in plain words.
1. Minting
Sign up with your Solana address and a password, then press Mint. It is free: our mint wallet mints the NFT and sends it to your registered address. No wallet connection or payment is needed.
- Total supply: 250 Stocklings. Free to mint: one per registered address, and the address must hold at least $5 of $STOCKLING.
- Minting is free for $STOCKLING holders. The holder check uses the live DexScreener price.
- The server rolls a rarity tier using the odds below, then picks one character from that tier at random. Every character in a tier has the same chance.
2. Rarity weights and odds
| Tier | Mint odds | Payout weight |
|---|---|---|
| Legendary | 3% | 20 |
| Epic | 9% | 8 |
| Rare | 16% | 4 |
| Uncommon | 27% | 2 |
| Common | 45% | 1 |
Your share of each payout is your Stockling's weight divided by the total weight of all minted Stocklings.
share = your weight / total minted weight your amount = pot x share
Example: a Legendary (weight 20) in a collection with a total weight of 400 gets 20 / 400 = 5% of every pot.
3. How payouts are funded
- $STOCKLING is launched on pump.fun. The creator fees it earns go to the public main wallet.
- Fees are claimed every 2 minutes. Each claim sends 70% to holder xStock payouts, 10% to $STOCKLING buybacks, and leaves 20% in the main wallet for swap and network fees, token-account rent, and taxes.
- Every 5 minutes, the holder payout pot is split across living Stocklings by rarity weight.
- For each holder, the bot buys the matching xStock token through Jupiter and sends it to the holder's wallet.
- Failed payouts remain owed to that holder and retry until confirmed on-chain. Amounts below 0.01 SOL carry to the next cycle.
Main wallet (public address only):
DLn2QrJiKpQaeQ6atxXs3ySfH5oJxkUsZneG1DrJDwS3The holder share, minimum, and interval are read from the site settings and shown on the Payouts page.
4. xStocks tokens
xStocks are tokenized tracker certificates issued by Backed. Each follows the price of a real share and exists on Solana as a Token-2022 token with 8 decimals. These are the exact tokens Stocklings uses:
5. Payout feed
- $STOCKLING is live. Payouts start as creator fees are claimed.
- The public feed lists only real on-chain transactions.
6. Risks
- Payouts depend on creator fees. If trading volume is low, payouts are small or zero. Nothing is guaranteed.
- xStocks prices move with the real shares and can go down. Swap prices, liquidity and routes can change.
- xStocks are not available in every country. Check that you are allowed to hold them.
- Solana network issues, bugs or third-party outages (Jupiter, DexScreener, wallets) can delay or stop payouts.
- Nothing on this site is investment advice.
7. API
Base URL: https://stocklings.fun. JSON bodies. Errors return {error} with 401, 403, 409, 429 or 503.
- POST /api/public/auth/signup {address, password} → {session: {access_token, ...}, wallet}
- POST /api/public/auth/login {address, password} → same shape
- GET /api/public/mint/status (Authorization: Bearer <access_token>) → {coinLaunched, testWallet, mintOpen, minted, reserved, supply, requiredUsd, wallet, holder, request}
- POST /api/public/mint/request (Bearer) → {request: {id, serial_number, name, uri, status, asset_address, mint_tx, ...}}
After requesting, poll mint/status until request.status is "minted". Serials come from one global counter; one mint per address.
NVDA
AAPL
GOOGL
SPCX
TSLA
MSFT
AMZN
META
AVGO
PLTR
COIN
HOOD
MSTR
CRCL
NFLX
AMD
INTC
ORCL
MCD
KO
PEP
WMT
GME