Floatpad API

Prompt for your assistant

Paste this into Claude, ChatGPT or Cursor. It carries every endpoint and the signing flow.

I'm building on the Floatpad API (Solana launchpad on Meteora). Base URL: https://www.floatpad.lol

How it works:
- No API key. JSON in and out. Errors are { "error": string, "code": string } with a 4xx/5xx status.
- Amounts are integer strings: SOL in lamports (1e9), tokens with 6 decimals.
- Anything that moves funds returns an unsigned, already simulated base64 VersionedTransaction. The user's wallet signs it (@solana/web3.js), then POST it to /api/trade/send (trades and claims) or /api/launch/send (launches), then poll GET /api/tx/status until it is "confirmed", "failed" or "expired".
- A launch also needs a fresh mint Keypair that signs the launch transaction before the wallet does, and POST /api/launches afterwards to list the coin (repeat while it returns 202).

Endpoints:
- GET /api/coins: The 120 newest coins launched through Floatpad, newest first. Cached for 30 seconds.
- GET /api/stats: Totals across every coin, from Meteora's on-chain fee counters: fees and who they went to, volume, SOL in curves and pools, and launches per day. All SOL amounts are lamports. Cached for a minute.
- GET /api/coin/{mint}/state (path: mint: string): Where the coin trades right now and how far along its bonding curve it is. venue is curve, graduating (Meteora is moving it to its pool; trading pauses for about a minute) or pool.
- GET /api/coin/{mint}/position (query: mint: string (path), wallet: string): A wallet's SOL balance and its balance of this coin, in raw units.
- GET /api/trade/quote (query: mint: string, side: "buy" | "sell", amount: string, slippage?: number): What a trade returns at the current price: tokens out for a buy, lamports out for a sell. Both amounts are raw integers as strings.
- POST /api/trade/prepare (body: wallet: string, mint: string, side: "buy" | "sell", amount: string, slippage?: number): Builds and simulates the buy or sell, and returns it unsigned as a base64 versioned transaction. The wallet pays its own network fee. Sign it, then pass it to Send a transaction.
- POST /api/trade/send (body: tx: string, wallet: string, mint: string): Relays a signed trade or fee claim through Floatpad's RPC and returns its signature. Only transactions that the wallet pays for and that touch Meteora and token programs for this coin are accepted. Sent is not landed: check Transaction status next.
- GET /api/tx/status (query: signature: string, lastValidBlockHeight?: number): Whether a signature landed. expired means its blockhash is too old for it to ever land, so it is safe to try again. Poll about once a second.
- POST /api/metadata (form: name: string, symbol: string, image: file, description?: string, website?: string, twitter?: string, telegram?: string): Stores the image and the token's metadata JSON, and returns the metadata URI to launch with. Only URIs from this call can be launched.
- POST /api/launch/prepare (body: wallet: string, mint: string, name: string, symbol: string, uri: string, devBuySol?: number, shield?: boolean): One transaction that creates the coin's bonding curve on Floatpad's config with your wallet as creator, plus an optional first buy in the same transaction so nobody can buy before you. Generate a fresh mint keypair: it signs too.
- POST /api/launch/send (body: tx: string, mint: string): Relays the fully signed launch. Only a Meteora launch of this mint on Floatpad's config is accepted.
- POST /api/launches (body: signature: string, mint: string, lastValidBlockHeight?: number): Reads the launch back from chain and lists the coin on Floatpad. Safe to repeat. A 202 means it has not landed yet: call again in a second or two. A 410 means it never will.
- GET /api/claim (query: mint: string, wallet: string): What the creator can claim now, in lamports: curve trading fees, and LP fees once the coin has graduated.
- POST /api/claim (body: mint: string, wallet: string): An unsigned, simulated transaction that sends every waiting fee to the creator in SOL. Sign it and pass it to Send a transaction.
- GET /api/creator (query: wallet: string): Every coin a wallet launched, newest first, with its stage, curve progress, market cap and unclaimed fees in lamports.
- POST /api/creator (body: wallet: string): One unsigned, simulated claim per coin with fees waiting, largest first, up to 8 at a time. Sign them all (signAllTransactions takes one approval) and send each to Send a transaction. remaining counts coins left for the next call.

Before writing code, ask me for anything you need that is not here (wallet adapter, framework, RPC, hosting). Never ask for or hardcode a private key or seed phrase; signing must happen in the user's wallet.