POSTCreate Launch

Build the on-chain transactions for a new Genesis token launch. Returns unsigned transactions that must be signed and sent before calling Register Launch.

Endpoint

POST /v1/launches/create

Request Body

The request body also accepts includeBackendSigner, derivedSignerPublicKey, nonce, and buildAllTxs. These drive the signing flow used by metaplex.com itself; leave them unset when calling the API directly.

Launch Configuration

The launch object describes the full token and launch setup:

For a new token, the allocation supplies must add up to exactly supply. A new token with a supply other than the 1,000,000,000 default returns 403 unless custom supply is enabled for your account.

Launch Types

The schema also defines auction and custom. auction is a placeholder that is not implemented yet, and custom is rejected by the public API with 400.

Allocation Types

Each allocation in the allocations array has a type field, a name, a supply, and a configuration object keyed by the same type name:

• launchpoolV2 — Proportional distribution pool
• presaleV2 — Fixed-price presale
• bondingCurveV2 — Bonding curve sale
• unlockedV2 — Unlocked tokens to a recipient
• claimScheduleV2 — Tokens released to a recipient on a vesting schedule, with an optional cliff

Raydium liquidity is configured as a fund flow on the sale allocation, not as its own allocation: a RaydiumLP flow creates a Raydium CPMM pool, and a RaydiumClmmLP flow creates a Raydium CLMM (concentrated liquidity) position. CLMM launches return 403 unless they are enabled for your account.

Existing Tokens

Set useExistingToken: true and pass the token's mintAddress to launch a token you already minted. decimals must match the on-chain mint. Unlike a new token, the allocations may fund only part of the supply: their total must be greater than 0 and no more than supply, and the rest stays in the creator's wallet. Existing-token launches return 403 unless they are enabled for your account, and are not available for the bondingCurve type.

Agent Launches

Pass agent to create the launch with a registered agent as its creator:

The agent's asset signer wallet becomes the launch creator. Pass the same agent.mint to Register Launch.

Example Request — Launch Pool Type

curl -X POST https://api.metaplex.com/v1/launches/create \
  -H "Content-Type: application/json" \
  -d '{
    "wallet": "YourWalletPublicKey...",
    "launch": {
      "name": "My Token",
      "symbol": "MTK",
      "image": "https://gateway.irys.xyz/...",
      "decimals": 6,
      "supply": 1000000000,
      "network": "solana-devnet",
      "quoteMint": "So11111111111111111111111111111111111111112",
      "type": "launchpool",
      "finalize": true,
      "publicKey": "YourWalletPublicKey...",
      "allocations": [...]
    }
  }'

Success Response

{
  "success": true,
  "transactions": [
    "base64-encoded-transaction-1...",
    "base64-encoded-transaction-2..."
  ],
  "blockhash": {
    "blockhash": "...",
    "lastValidBlockHeight": 123456789
  },
  "mintAddress": "MintPublicKey...",
  "genesisAccount": "GenesisAccountPDA..."
}

Error Response

{
  "success": false,
  "error": "Validation failed",
  "details": [...]
}

Error Codes

Recommended: Use the SDK

Instead of calling this endpoint directly, use createAndRegisterLaunch which handles the entire flow — creating transactions, signing, sending, and registering — in one call:

1import {
2  createAndRegisterLaunch,
3  CreateLaunchInput,
4  genesis,
5} from '@metaplex-foundation/genesis'
6import { createUmi } from '@metaplex-foundation/umi-bundle-defaults'
7import { keypairIdentity } from '@metaplex-foundation/umi'
8
9const umi = createUmi('https://api.mainnet-beta.solana.com')
10  .use(genesis())
11
12// Use keypairIdentity to set a wallet when running server-side:
13// umi.use(keypairIdentity(myKeypair))
14
15const input: CreateLaunchInput = {
16  wallet: umi.identity.publicKey,
17  token: {
18    name: 'My Token',
19    symbol: 'MTK',
20    image: 'https://gateway.irys.xyz/...',
21  },
22  launchType: 'launchpool',
23  launch: {
24    launchpool: {
25      tokenAllocation: 500_000_000,
26      depositStartTime: new Date(Date.now() + 48 * 60 * 60 * 1000),
27      raiseGoal: 250,
28      raydiumLiquidityBps: 5000,
29      fundsRecipient: umi.identity.publicKey,
30    },
31  },
32}
33
34const result = await createAndRegisterLaunch(umi, {}, input)
35console.log(`Launch live at: ${result.launch.link}`)

See API Client for the full SDK documentation including all three integration modes.