Create Token Launch

Overview

Creates an unsigned transaction for launching a new SPL token on Solana with custom metadata, optional vanity address ending, no fees, automatic inflation and claimability.

curl -X POST https://api.zcombinator.io/launch \
  -H "Content-Type: application/json" \
  -d '{
    "name": "My Token",
    "symbol": "MTK",
    "description": "A demonstration token",
    "image": "https://example.com/token-image.png",
    "website": "https://example.com",
    "twitter": "https://twitter.com/mytoken",
    "caEnding": "MTK",
    "payerPublicKey": "9WzDXwBbmkg8ZTbNMqUxvQRAyrZzDsGYdLVL9zYtAWWM",
    "quoteToken": "SOL"
  }'

const response = await fetch('https://api.zcombinator.io/launch', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    name: "My Token",
    symbol: "MTK",
    description: "A demonstration token",
    image: "https://example.com/token-image.png",
    website: "https://example.com",
    twitter: "https://twitter.com/mytoken",
    caEnding: "MTK",
    payerPublicKey: "9WzDXwBbmkg8ZTbNMqUxvQRAyrZzDsGYdLVL9zYtAWWM",
    quoteToken: "SOL" // or "ZC" for native launchpad token
  })
});

const result = await response.json();

import requests

data = {
    "name": "My Token",
    "symbol": "MTK",
    "description": "A demonstration token",
    "image": "https://example.com/token-image.png",
    "website": "https://example.com",
    "twitter": "https://twitter.com/mytoken",
    "caEnding": "MTK",
    "payerPublicKey": "9WzDXwBbmkg8ZTbNMqUxvQRAyrZzDsGYdLVL9zYtAWWM",
    "quoteToken": "SOL"  # or "ZC" for native launchpad token
}

response = requests.post(
    'https://api.zcombinator.io/launch',
    json=data,
    headers={'Content-Type': 'application/json'}
)

result = response.json()

Request Parameters

string

required

The display name of the token (e.g., “Solana Token”)

string

required

The token symbol/ticker (e.g., “SOL”, “USDC”)

string

required

Base58 encoded public key of the account that will pay transaction fees and own the token

string

Optional description of the token for metadata

string

URL to the token’s image/logo for metadata

string

Website URL associated with the token

string

Twitter URL or handle for the token project

string

Optional vanity ending for the token address (max 3 characters, no 0, O, I, l)

string

Quote token for the bonding curve pool. Options: “SOL” (default) or “ZC” (native launchpad token). If not specified, defaults to “SOL”

Response

boolean

Indicates if the operation was successful

string

Base58 encoded unsigned transaction that needs to be signed by the payer

string

The public key of the token mint address

string

IPFS URL where the token metadata is stored

string

Instructions for the next step in the process

Success Response

{
  "success": true,
  "transaction": "4MzR7dxJNJRVP1Q6k7Y3j8X...", // Base58 encoded transaction
  "baseMint": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
  "metadataUrl": "https://gateway.pinata.cloud/ipfs/QmX7Y3j8...",
  "message": "Sign this transaction and submit to /confirm-launch"
}

Error Responses

400 - Missing Required Fields

{
  "error": "Missing required fields: name, symbol, and payerPublicKey are required"
}

400 - Invalid CA Ending

{
  "error": "CA ending must be 3 characters or less"
}

Or:

{
  "error": "CA ending contains invalid Base58 characters (0, O, I, l)"
}

500 - Server Error

{
  "error": "Failed to create launch transaction"
}

Rate Limiting

This endpoint is subject to rate limiting:

8 requests per IP per 2-minute window
Returns HTTP 429 when limit exceeded

Next Steps

After receiving the unsigned transaction:

Deserialize the transaction using @solana/web3.js
Sign the transaction with your wallet
Submit the signed transaction to /confirm-launch

The baseMint and internal keypair are stored temporarily. You must call /confirm-launch within a reasonable time frame or the launch will need to be restarted.

Security Notes

The API generates the token keypair internally and does not expose the private key
Users only sign for transaction fees and account creation
Protocol maintains mint authority for the claims system
All metadata is uploaded to IPFS for permanent storage

Launch

Claim token emissions (dev)

Claim LP fees

Manage AMM liquidity

Utility

Overview

Request Parameters

Response

Success Response

Error Responses

Rate Limiting

Next Steps

Security Notes

​Overview

​Request Parameters

​Response

​Success Response

​Error Responses

​Rate Limiting

​Next Steps

​Security Notes

Overview

Request Parameters

Response

Success Response

Error Responses

Rate Limiting

Next Steps

Security Notes