Documentation
How CATPAD works
Everything a cat coin does here is fixed by the program: the full supply sits in the pool, the liquidity is locked by the transaction that creates it, and the trading fee is paid back to the people holding.
Launching
You give a name, a ticker and a picture, then approve twice. The first approval creates the coin and opens its pool; the second locks the pool and takes your own first buy. One cannot happen without the other, and none of it can be changed afterwards.
1,000,000,000
Total supply, fixed
$3,840
Opening market cap
100%
Of the supply in the pool
≈0.23 SOL
Cost to launch — network fees only, CATPAD takes none of it.
- 01
The token is created
The whole supply is minted in one go into a program-owned vault. Mint and freeze authority are burned in the same transaction, so nothing more can ever be created and no wallet can be frozen. No team bag, no presale.
- 02
The pool opens, already locked
The entire supply goes straight into the pool, and the position is locked as it is created. There is no unlock date and no key — not for you, not for CATPAD.
- 03
Trading starts
The launch finishes with a tiny first buy so charts and aggregators pick the pool up. From there the coin trades like any other.
How the price moves
Nobody sets the price. It follows how much of the supply has been bought and climbs faster the further it goes — the last cats cost far more than the first.
Launch
$3,840
Graduation
$48,000
Graduation is 12.5× the launch price. Nothing actually happens there — the pool is real from the first second, so there is no migration and no gate. The price just keeps going.
Fees
Every trade pays 3%. Most of it goes straight back to the people holding the coin. Launching one earns you nothing.
2.52%
Of every trade goes back to the token. This is the part that gets paid out.
0.48%
Of every trade goes to the venue the pool sits on.
When someone buys
The fee arrives in the quote asset. Half is set aside for everyone holding the coin, half keeps CATPAD running.
1.26% to holders
When someone sells
The fee arrives in the coin itself. It collects in the treasury and what has gathered there is burned at intervals.
2.52% set aside to burn
What the creator gets
Nothing. Launching costs roughly 0.23 SOL and pays no revenue afterwards — there is no creator address anywhere in the payout. If you want to earn from a coin you launched, hold it, on exactly the same terms as everybody else.
Claiming your share
Your share builds up on each coin separately and stays there until you pull it. Nothing expires. Shares are worked out once an hour from who holds what, as running totals, so a missed hour is covered by the next one. The first claim on a coin costs a small amount of rent; every claim after that is just the network fee.
API
Plain JSON over GET. Nothing to sign up for, and every number in it is already public on chain — this is a shortcut past reading the accounts yourself.
https://catpad/api/v1
GET /launches
Every tradable launch. A coin shows up here once its pool is locked, and never before.
- sort
- new (default) or hot — the busiest above $12,000.
- limit
- 1 to 100. Defaults to 24.
- cursor
- The nextCursor from the previous page. Only for sort=new.
GET /launches/{mint}
One launch, plus the on-chain accounts to verify it against. A mint whose pool is not locked returns 404.
What comes back
Both endpoints return the same launch object; the second one adds the accounts behind it. A launch has no market figures until the first pricing pass reaches it, about a minute after it locks — until then every one of them is null, never zero.
{
"mint": string,
"name": string,
"symbol": string,
"description": string | null,
"imageUrl": string | null,
"creator": string,
"createdAt": string,
"marketCapUsd": number | null,
"volume24hUsd": number | null,
"change24h": number | null,
"soldPct": number | null,
"holders": number | null,
"listed": boolean | null
}