Prepares your launch, as the site's launch form does (the same checks, fees and rules): stores the picture and the coin's metadata and answers { mint, transaction, summary }, the transaction base64 for your wallet to sign (a pump.fun launch adds venue and transactions, the same one in a list). Sign it with your wallet without sending it and give it to submit_launch within the hour. The picture is imageUrl: an https address on a public host, fetched once, held to the site's picture rules (png, jpg, gif or webp, at most 4 MB). A coin with a prize names one: skin (an id from search_prizes), case, or basket (2 to 10 ids). With a dev buy your wallet's WBTC does not cover, it answers devSwap instead: sign its transaction and send it (send_transaction, or any Solana RPC), then prepare_launch again with devBuySats as given. pair: 'souvenir' makes the coin trade against $SOUVENIR instead of SOL, on Souvenir's own curve, while launch_options says souv.on; its first buy, if any, is firstBuySouv, raw $SOUVENIR from your wallet. On such a coin a first buy written in SOL is paid in $SOUVENIR: when your wallet lacks it, prepare_launch answers souvSwap instead. Sign its transaction, send it (send_transaction, or any Solana RPC) and wait until it is confirmed, then call prepare_launch again with the same arguments plus firstBuySouv set to souvSwap.target. If it answers souvSwap again with the same held, the swap is not in Souvenir's read yet: wait and ask again, and do not sign that one. Takes the token from sign_in, as token or as the request's Authorization: Bearer header. Refused with "Launching through the API is not open yet." while it is not open to your wallet. Launching a coin, in order: (1) sign_in_challenge with your wallet's address, sign its message with that wallet, then sign_in for a token; (2) launch_options, and search_prizes for the prize (or shopper_sample for a coin that picks its own prizes); (3) prepare_launch; (4) sign the transaction it answers with your wallet, without sending it, and give it to submit_launch; (5) launch_status until it answers confirmed: a pump.fun launch first answers split with a second transaction, which you sign (or sign and send) and give to submit_split, then launch_status again. Your wallet pays and signs everything: Souvenir never needs or asks for its private key.
View input schema
{
"type": "object",
"properties": {
"token": {
"type": "string",
"description": "The token sign_in gave. Not needed when the request sends it as Authorization: Bearer <token>."
},
"name": {
"type": "string",
"minLength": 1,
"maxLength": 32,
"description": "The coin's name."
},
"symbol": {
"type": "string",
"minLength": 1,
"maxLength": 10,
"pattern": "^[A-Za-z0-9$]+$",
"description": "Its ticker: letters and digits."
},
"description": {
"type": "string",
"maxLength": 500
},
"imageUrl": {
"type": "string",
"description": "The coin's picture: an https address on a public host; png, jpg, gif or webp, at most 4 MB."
},
"bannerUrl": {
"type": "string",
"description": "A banner for the top of its page, optional: https; png, jpg or webp, at most 3 MB, three times as wide as tall, at least 600 px wide."
},
"links": {
"type": "object",
"additionalProperties": false,
"properties": {
"x": {
"type": "string"
},
"telegram": {
"type": "string"
},
"website": {
"type": "string"
}
},
"description": "https links; without a website, the coin's Souvenir page."
},
"venue": {
"type": "string",
"enum": [
"meteora",
"pump"
],
"default": "meteora",
"description": "meteora: Souvenir's own curve (it needs feeBps). pump: pump.fun, while launch_options says venues.pump."
},
"feeBps": {
"type": "integer",
"enum": [
100,
150,
200,
250,
300,
350,
400,
450,
500,
550,
600,
650,
700,
750,
800,
850,
900,
950,
1000
],
"description": "The trading fee in basis points (meteora); on a BTC pump.fun launch, its creator fee, one of launch_options pump.feeLevels."
},
"shareBps": {
"type": "integer",
"enum": [
0,
500,
1000,
1500,
2000,
2500,
3000,
3500,
4000,
4500,
5000,
5500,
6000,
6500,
7000,
7500,
8000,
8500,
9000,
9500,
10000
],
"description": "The fee's share for the prize pot, in basis points (7500 by default on the site); 0 is a coin with no prize."
},
"skin": {
"type": "string",
"description": "The prize: an id from search_prizes, or a CS2 skin's market name."
},
"case": {
"type": "string",
"description": "One of Souvenir's cases instead, <id>@<version>."
},
"basket": {
"type": "array",
"items": {
"type": "string"
},
"minItems": 2,
"maxItems": 10,
"description": "A basket of prizes instead: round 1 draws the first, each draw picks the next."
},
"basketOdds": {
"type": "array",
"items": {
"type": "integer"
},
"description": "Each basket prize's chance in whole percents, in the basket's order (equal without)."
},
"ladder": {
"type": "array",
"items": {
"type": "string"
},
"minItems": 2,
"maxItems": 10,
"description": "A prize ladder instead: 2 to 10 places in order, 1st first, each its own winner at every draw (each worth no more than the place above)."
},
"curator": {
"type": "object",
"additionalProperties": false,
"required": [
"sample"
],
"properties": {
"sample": {
"type": "string",
"pattern": "^[0-9a-f]{32}$"
}
},
"description": "A shopper instead: the id of a sample pick this wallet asked for (shopper_sample). The coin picks each round’s prize itself from the sample’s brief and price band; round 1’s prize is the sample’s. Send nothing else in it."
},
"launchWindow": {
"type": "boolean",
"description": "meteora: the fee starts at 50% and falls to the coin's over 60 seconds."
},
"volatility": {
"type": "boolean",
"description": "meteora: Meteora's dynamic fee on top of the base fee."
},
"tickets": {
"type": "object",
"additionalProperties": false,
"properties": {
"curve": {
"type": "string",
"enum": [
"standard",
"cap",
"soft",
"sqrt"
]
},
"capPct": {
"type": "number",
"enum": [
1,
2,
3,
5
]
},
"minPct": {
"type": "number",
"enum": [
0.001,
0.01,
0.1
]
}
},
"description": "How a holder's balance turns into draw tickets; without it, capped at 3% of the supply a wallet."
},
"holdHours": {
"type": "integer",
"enum": [
0,
1,
6,
24
],
"description": "How long a coin must be held before it counts in a draw."
},
"staking": {
"type": "boolean",
"description": "Staking open from the start."
},
"charity": {
"type": "object",
"description": "A charity coin: { address, name, url?, pledgeBps?, rounds?, ship?, variant? }, as the site's form sends it."
},
"shield": {
"type": "boolean",
"description": "The launch shield, on a BTC pump.fun launch while launch_options says pump.shield.on."
},
"firstBuyLamports": {
"type": "string",
"pattern": "^[0-9]{1,20}$",
"description": "A first buy in lamports (Souvenir's curve, or a SOL pump.fun launch)."
},
"devBuyLamports": {
"type": "string",
"pattern": "^[0-9]{1,20}$",
"description": "A dev buy on a BTC pump.fun launch, in lamports, while launch_options says pump.devBuy.on."
},
"devBuySats": {
"type": "string",
"pattern": "^[0-9]{1,20}$",
"description": "The devSwap's devSats, given back once its swap landed."
},
"slippageBps": {
"type": "integer",
"minimum": 10,
"maximum": 5000,
"default": 500
},
"pair": {
"type": "string",
"enum": [
"sol",
"souvenir"
],
"default": "sol",
"description": "What the coin trades against: sol, or souvenir ($SOUVENIR) on Souvenir's own curve while launch_options says souv.on."
},
"firstBuySouv": {
"type": "string",
"pattern": "^[0-9]{1,20}$",
"description": "A first buy on a coin paired with $SOUVENIR, in raw $SOUVENIR (6 decimals) from your wallet, at most launch_options souv.maxFirstBuySouv. With firstBuyLamports it is the target souvSwap answered, sent again."
}
},
"required": [
"name",
"symbol",
"imageUrl",
"shareBps"
],
"additionalProperties": false
}