curl --request POST \
  --url http://127.0.0.1:8788/launch/{chain} \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "platform": "pump",
  "wallets": [
    "2qPNgjtkrEN5T1uoEENQx2xMRfomyJYm5o4pZwYa32CP",
    "GU5Y6qEsqDYRG7iuSzFhbcHsPfXyz5FTeUwFmdJMxCvB",
    "ERFXmFZ7n3MSUBQeFX44U4iCNQGLBNbhDawebzU9JDdp"
  ],
  "amounts": [
    0.5,
    0.2,
    0.1
  ],
  "token": {
    "name": "Docs Test",
    "symbol": "DOCS",
    "description": "docs",
    "image": "https://example.com/i.png",
    "metadataUri": "https://example.com/meta.json"
  },
  "slippageBps": 1000,
  "computeUnitPrice": 100000,
  "jitoTipAmountSol": 0.001,
  "rpcUrl": "https://api.mainnet-beta.solana.com"
}
'

{
  "ok": true,
  "data": {
    "platform": "pump",
    "family": "solana",
    "mint": "Af6hqgjTc5fBuQR3nVwdaZRjM3opeRC9122uQiifEsid",
    "transactions": [
      "9Z1toeB5upUXCq8vMt7VP7wSB6D5VvK8Kz2QKc4dPn5kY1vT…znsFkN7T",
      "8jNQYWuScTknmgbLHMRzAUvhNpqS6MZi9GvZATb3bZJR8UhH…VeEEFeQw",
      "RPGHZnfEe3xe9hdnzH6FwECtjWrCtjpBMhDcfTfV2G1yBaoS…inkRW3Jw"
    ],
    "legs": [
      {
        "kind": "create",
        "wallet": "2qPNgjtkrEN5T1uoEENQx2xMRfomyJYm5o4pZwYa32CP",
        "walletIndex": 0,
        "version": 1
      },
      {
        "kind": "buy",
        "wallet": "GU5Y6qEsqDYRG7iuSzFhbcHsPfXyz5FTeUwFmdJMxCvB",
        "walletIndex": 1,
        "version": 1
      },
      {
        "kind": "buy",
        "wallet": "ERFXmFZ7n3MSUBQeFX44U4iCNQGLBNbhDawebzU9JDdp",
        "walletIndex": 2,
        "version": 1
      }
    ]
  },
  "error": null,
  "nextCursor": null
}

Reference

Build a launch

Builds the unsigned transactions of one launch. Nothing is signed for your wallets and nothing is sent. The fields a request needs depend on the platform: pick the matching body below. The whole call is bounded at 90 seconds (504).

Request-shape errors answer 400, and a catalogued launchpad without a builder 501. Refusals raised inside a builder answer 502 (launch_failed) with the reason in error.message, even when the fix is on your side: balances, curve limits, on-chain fee caps, quote assets and Bags, but also some checks that need no network (pump’s mintKey, pump wallet addresses, missing image).

POST

launch

{chain}

curl --request POST \
  --url http://127.0.0.1:8788/launch/{chain} \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "platform": "pump",
  "wallets": [
    "2qPNgjtkrEN5T1uoEENQx2xMRfomyJYm5o4pZwYa32CP",
    "GU5Y6qEsqDYRG7iuSzFhbcHsPfXyz5FTeUwFmdJMxCvB",
    "ERFXmFZ7n3MSUBQeFX44U4iCNQGLBNbhDawebzU9JDdp"
  ],
  "amounts": [
    0.5,
    0.2,
    0.1
  ],
  "token": {
    "name": "Docs Test",
    "symbol": "DOCS",
    "description": "docs",
    "image": "https://example.com/i.png",
    "metadataUri": "https://example.com/meta.json"
  },
  "slippageBps": 1000,
  "computeUnitPrice": 100000,
  "jitoTipAmountSol": 0.001,
  "rpcUrl": "https://api.mainnet-beta.solana.com"
}
'

{
  "ok": true,
  "data": {
    "platform": "pump",
    "family": "solana",
    "mint": "Af6hqgjTc5fBuQR3nVwdaZRjM3opeRC9122uQiifEsid",
    "transactions": [
      "9Z1toeB5upUXCq8vMt7VP7wSB6D5VvK8Kz2QKc4dPn5kY1vT…znsFkN7T",
      "8jNQYWuScTknmgbLHMRzAUvhNpqS6MZi9GvZATb3bZJR8UhH…VeEEFeQw",
      "RPGHZnfEe3xe9hdnzH6FwECtjWrCtjpBMhDcfTfV2G1yBaoS…inkRW3Jw"
    ],
    "legs": [
      {
        "kind": "create",
        "wallet": "2qPNgjtkrEN5T1uoEENQx2xMRfomyJYm5o4pZwYa32CP",
        "walletIndex": 0,
        "version": 1
      },
      {
        "kind": "buy",
        "wallet": "GU5Y6qEsqDYRG7iuSzFhbcHsPfXyz5FTeUwFmdJMxCvB",
        "walletIndex": 1,
        "version": 1
      },
      {
        "kind": "buy",
        "wallet": "ERFXmFZ7n3MSUBQeFX44U4iCNQGLBNbhDawebzU9JDdp",
        "walletIndex": 2,
        "version": 1
      }
    ]
  },
  "error": null,
  "nextCursor": null
}

The create and the first buys, unsigned. Also at /v1/launch/{chain}. Guides: Launch overview (the transaction plan, mint keys, errors), Solana launchpads, Robinhood Chain.

Many fixable inputs come back as 502 launch_failed, not 400: a 32-byte mintKey, an underfunded payer, a curve setting out of the launchpad’s range. Read error.message.

Authorizations

x-api-key

string

header

required

Path Parameters

chain

string

required

sol (alias solana) or robinhood (aliases hood, rh, robin, robinhoodchain, 4663). eth (ethereum), bsc (bnb, binance, binancesmartchain) and base are recognised but have no builder. Case and punctuation are ignored.

Example:

"sol"

Body

application/json

JSON. Unknown fields are ignored; a field with the wrong type is a 400. The Content-Type header is not checked.

Pump.fun (sol)
Raydium LaunchLab (sol)
Meteora DBC / Bags (sol)
pons.family (robinhood)

POST /launch/sol with platform pump (or absent). Create via create_v2, the creator's buy_v2 fused into it, then one buy_v2 per other wallet.

wallets

(string | object)[]

required

Base58 public keys. wallets[0] is the creator: it pays and signs the create and makes the creator's buy inside it. Every other wallet with a non-zero amount gets one buy transaction of its own. At most 50, the creator included.

Required array length: 1 - 50 elements

A wallet address, or { address, amount }. When any object in wallets carries an amount, those amounts are used (missing ones count as 0) and amounts is ignored.

walletAddresses

string[]

Alias of wallets (strings only), read when wallets is absent or empty.

amounts

number[]

Whole units of the quote (SOL by default). A wallet past the end of amounts buys amounts[0]; with no amounts at all every wallet buys 0.01. Send explicit zeros for wallets that must not buy. Every wallet after the first spends a random 0–2% less than its amount (see config.trading.decreaseRange).

Required range: x >= 0

rpcUrl

string<uri>

Solana RPC used for every chain read. Alias rpc. Falls back to the server's SOLANA_RPC.

rpc

string

Alias of rpcUrl

token

object

Token metadata. Flat top-level fields of the same name are used when this object is absent.

Show child attributes

name

string

Flat alternative to token.name

symbol

string

Flat alternative to token.symbol

description

string

Flat alternative to token.description

image

string

Flat image URL (also logo, imageUrl)

logo

string

Flat image URL

imageUrl

string

Flat image URL

metadataUri

string

Flat alternative to token.uri

twitter

string

website

string

encoding

enum<string>

default:base58

Encoding of the returned transactions (and of stages[].transactions).

Available options:

base58,

bs58,

base64,

b64

slippageBps

integer

default:9900

Each buy is an exact-token buy capped at quote × (1 + floor(slippageBps / 10) / 1000) (0.1% steps). Default 99%.

Required range: x >= 0

computeUnitPrice

integer

default:50000

Priority price in micro-lamports per compute unit. Written into each v1 message as a priority fee of ceil(limit × price / 1e6) lamports.

Required range: x >= 0

computeUnitLimit

integer

default:600000

Limit of the buy transactions only. The create always asks for 400000.

Required range: 0 <= x <= 4294967295

jitoTipSol

number

default:0

Jito tip in SOL, sent to Cw8CFyM9FkoMi7K7Crf6HNQqf4uEMzpKw6QNghXLvLkY from the last buy transaction only, never from a create. 0 or absent sends no tip. Alias jitoTipAmountSol.

Required range: x >= 0

jitoTipAmountSol

number

Alias of jitoTipSol

feeWallet

string

Product-fee recipient. With feeBps, every buy pays feeBps of its quote amount to this wallet inside its own transaction. Both or neither (400).

feeBps

integer

Product fee in basis points of each buy. Not capped by the service.

Required range: x >= 0

platform

string

default:pump

pump, pumpfun, pump.fun (case and punctuation ignored), or absent.

mintKey

string

The mint's 64-byte secret key, base58. Signs the create here. Absent: a mint is generated and returned as mint. A 32-byte public key is refused (502). Alias mintPubkey.

mintPubkey

string

Alias of mintKey

quoteMint

string

default:SOL

Quote asset: SOL (exact spelling), the USDC mint EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v, or any mint in pump's quote registry (decimals read from chain). Anything else, tickers included, is a 502. Alias quote.

quote

string

Alias of quoteMint

mayhem

boolean

Mayhem Mode. Aliases mayhemMode, isMayhemMode, pumpType (precedence mayhem > mayhemMode > pumpType). SOL or USDC quote only.

mayhemMode

boolean

Alias of mayhem (also isMayhemMode)

pumpType

boolean

Alias of mayhem (it is not a launch mode)

holderReward

boolean

Holder-rewards coin: creator fees go to holders, permanently. Refused when pump's Global disables it. Aliases isHolderReward, holder_reward.

creatorFeeBps

integer

Flat creator fee replacing pump's standard schedule; 0 or absent keeps the standard schedule. At most Global.maxConfigurableCreatorFeeBps (300 on 2026-10-01), read from chain. Aliases creator_fee_bps, creatorFeeBasisPoints, creator_fee_basis_points.

Required range: x >= 0

cashBack

boolean

true is refused (400): pump no longer creates cashback coins. Alias isCashBack.

offchainCreator

string

Public key written as the coin's creator instead of wallets[0]. Only for a launch with no buy at all: every amount must be an explicit 0. Alias displayCreator.

config

object

Legacy nested shape { tokenCreation: { metadata, defaultSolAmount, isMayhemMode, isHolderReward, creatorFeeBps, quoteMint }, trading: { slippageBps, decreaseRange: { min, max }, computeUnitPrice, computeUnitLimit }, jito }. When present it replaces token, quoteMint and slippageBps, and missing amounts default to defaultSolAmount (0.01); the Jito tip still comes from jitoTipSol. decreaseRange (percent, default min 2, max 8) lowers each other buyer's spend by a random amount below min%; { min: 0, max: 0 } turns it off.

Response

The unsigned transactions of the launch

boolean

required

true on success

data

Solana launch · object

required

The result; null on failure

Solana launch
Bags first call
pons V2
pons V1

Show child attributes

error

null | object

required

Show child attributes

nextCursor

null

required

Always null (nothing here is paged)