Create Token on PumpFun

Create a token on PumpFun with Launchpad Trade API

POST/pumpfun/create

Deploy a new token on PumpFun with a single API call. Optionally include a dev buy in the same transaction to secure the first position on the bonding curve.

Quick Start

curl -X POST https://api.launchpad.trade/pumpfun/create \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "devPrivateKey": "YOUR_PRIVATE_KEY",
    "name": "My Token",
    "symbol": "MYTOKEN",
    "image": "https://ipfs.io/ipfs/QmExample.../image.png",
    "description": "A sample token on PumpFun",
    "devBuy": 0.5
  }'

See all parameters, dev buy, pumpfun modes, and image sources details below.

Parameters

Required

Parameter	Type	Description
`devPrivateKey`	string	Private key of the wallet that creates the token. Pays the creation cost (~0.02 SOL) and executes the dev buy if set
`name`	string	Token name displayed on PumpFun and explorers. Max 32 characters
`symbol`	string	Token ticker symbol (e.g. `MYTOKEN`). Max 10 characters, alphanumeric
`image`	string	Token image URL. Must be from a whitelisted source. Accepted formats: PNG, JPG, GIF, WebP

Optional

Parameter	Type	Default	Description
`description`	string	—	Token description displayed on PumpFun. Max 200 characters
`twitter`	string	—	Twitter/X profile URL (`https://twitter.com/...` or `https://x.com/...`)
`telegram`	string	—	Telegram group or channel URL (`https://t.me/...`)
`website`	string	—	Project website URL
`devBuy`	number	0	Amount in SOL for the initial dev buy. See Dev Buy
`isMayhem`	boolean	false	Enable AI-driven post-launch activity for 24h. Irreversible. See Mayhem Mode
`isCashback`	boolean	false	Redirect creator fees (0.3%) to traders instead of the creator. Irreversible. See Cashback Mode
`priorityFee`	object	FAST (0.00015 SOL)	Transaction priority level. See Priority Fee
`platformTag`	object \| false	No attribution	Tag the transaction with a DEX source. See Platform Attribution

Dev Buy

When devBuy is set to a value greater than 0, the initial purchase happens in the same transaction as the token creation.

The dev wallet is always the first buyer on the bonding curve
No slippage risk — you buy at the initial price before anyone else
The response includes a devBuy object with the SOL spent and tokens received

Creation and dev buy share the same signature, slot, and latency. There is no gap between creation and first buy.

PumpFun Modes

PumpFun offers two optional modes that are configured at creation and cannot be changed afterwards.

Mayhem Mode

When isMayhem: true, PumpFun’s AI agent Agent Pumpy automatically trades your token for 24 hours after launch with random buy and sell transactions.

An additional 1B tokens are minted at creation (total supply temporarily 2B)
Agent Pumpy trades the token for 24h with randomized activity
All unsold tokens are burned at the end of the 24h period
Generates consistent on-chain activity during the critical post-launch window

isMayhem is irreversible — it must be set at creation and cannot be disabled. PumpFun does not guarantee any economic outcome from Mayhem Mode. See PumpFun’s Mayhem Mode disclaimer.

Cashback Mode

When isCashback: true, the standard 0.3% creator fees generated by trades are redirected to traders instead of being paid to the token creator. Each trader receives cashback proportional to their swap volume on that token.

Traders accumulate cashback on every swap they make on the token
The creator wallet receives no fees from trading activity
Community Takeovers (CTOs) are not possible on cashback-enabled tokens
Signals long-term commitment from the creator — no economic incentive to abandon the project

isCashback is irreversible — once enabled at creation, the creator will never receive trading fees for this token.

Both modes are independent and can be combined. You are responsible for ensuring your use complies with applicable laws and regulations.

Image Sources

Token images must be hosted on a whitelisted source:

Source	Accepted URL pattern
IPFS.io	`https://ipfs.io/ipfs/*`
Pinata	`https://.mypinata.cloud/ipfs/`

Images from other sources will be rejected. Upload to IPFS before calling the API.

Upload to IPFS

You can upload your token image to IPFS using PumpFun’s free upload endpoint. The returned metadataUri is the URL to use as the image parameter when creating your token.

From a file
From a URL

Upload a local image file to IPFS.

curl -X POST https://pump.fun/api/ipfs \
  -F "file=@./image.png"

Download an image from a URL and upload it to IPFS.

curl -s -o /tmp/image.png "https://example.com/image.png" && \
curl -X POST https://pump.fun/api/ipfs \
  -F "file=@/tmp/image.png"

The endpoint returns an IPFS URL you can use directly:

{
  "metadataUri": "https://ipfs.io/ipfs/QmXkFh..."
}

More Examples

All options — socials, dev buy, and priority fee

Full token creation with all social links, dev buy, and platform attribution.

curl -X POST https://api.launchpad.trade/pumpfun/create \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "devPrivateKey": "YOUR_PRIVATE_KEY",
    "name": "My Token",
    "symbol": "MYTOKEN",
    "image": "https://ipfs.io/ipfs/QmExample.../image.png",
    "description": "A sample token on PumpFun",
    "twitter": "https://x.com/mytoken",
    "telegram": "https://t.me/mytoken",
    "website": "https://mytoken.xyz",
    "devBuy": 1.0,
    "priorityFee": {
      "mode": "ULTRA"
    },
    "platformTag": {
      "platform": "PHOTON"
    }
  }'

Mayhem Mode + Cashback Mode

Token creation with AI-driven post-launch activity and fee redistribution to traders. Both flags are irreversible.

curl -X POST https://api.launchpad.trade/pumpfun/create \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "devPrivateKey": "YOUR_PRIVATE_KEY",
    "name": "My Token",
    "symbol": "MYTOKEN",
    "image": "https://ipfs.io/ipfs/QmExample.../image.png",
    "description": "A sample token on PumpFun",
    "devBuy": 0.5,
    "isMayhem": true,
    "isCashback": true,
    "priorityFee": {
      "mode": "FAST"
    }
  }'

Response

With dev buy (200)
Without dev buy (200)

{
  "success": true,
  "data": {
    "tokenAddress": "7GCihgDB8fe6KNjn2MYtkzZcRjQy3t9GHdC8uHYmW2hr",
    "signature": "5UfDuX7nPqR3kLm8vYz...",
    "slot": 234567890,
    "networkLatency": 48,
    "confirmLatency": 535,
    "devBuy": {
      "amountSol": 0.5,
      "tokensReceived": 1000000000
    }
  }
}

When devBuy is 0 or absent, the devBuy object is not included in the response.

{
  "success": true,
  "data": {
    "tokenAddress": "7GCihgDB8fe6KNjn2MYtkzZcRjQy3t9GHdC8uHYmW2hr",
    "signature": "5UfDuX7nPqR3kLm8vYz...",
    "slot": 234567890,
    "networkLatency": 46,
    "confirmLatency": 505
  }
}

Errors

{
  "success": false,
  "error": {
    "code": "INVALID_IMAGE",
    "message": "Image URL must be from a whitelisted source"
  }
}

Code	Message	Cause
`INVALID_WALLET`	Invalid private key	Dev wallet private key is invalid
`INVALID_NAME`	Token name too long	Name exceeds 32 characters
`INVALID_SYMBOL`	Token symbol too long	Symbol exceeds 10 characters
`INVALID_IMAGE`	Image URL must be from a whitelisted source	Image URL not from an accepted source
`INVALID_IMAGE`	Invalid image format	Image format not supported (use PNG, JPG, GIF, or WebP)
`INVALID_SOCIAL`	Invalid Twitter URL	Twitter URL format is incorrect
`INVALID_SOCIAL`	Invalid Telegram URL	Telegram URL format is incorrect
`INSUFFICIENT_SOL`	Insufficient SOL balance	Not enough SOL for creation cost + dev buy
`RATE_LIMIT`	Rate limit exceeded	Too many requests — see Rate Limits
`INTERNAL_ERROR`	Internal server error	Retry or contact support

Notes

Use ULTRA priority fee for time-sensitive launches where first-block positioning matters. See Priority Fee for details.

Token creation costs ~0.02 SOL (paid by the dev wallet)
The dev wallet needs enough SOL to cover creation cost + dev buy amount + priority fee

What’s Next?

Buy Tokens

Buy more tokens after creation

Claim Creator Fees

Collect accumulated trading fees from your token

Update Fee Shares

Configure fee recipients and percentages

Priority Fee

Configure transaction speed and cost

Getting Started

Concepts

Trading

Launch

Wallets

Funding

Utilities

Quick Start

Parameters

Required

Optional

Dev Buy

PumpFun Modes

Mayhem Mode

Cashback Mode

Image Sources

Upload to IPFS

More Examples

Response

Errors

Notes

What’s Next?

Buy Tokens

Claim Creator Fees

Update Fee Shares

Priority Fee

Getting Started

Concepts

Trading

Launch

Wallets

Funding

Utilities

​Quick Start

​Parameters

​Required

​Optional

​Dev Buy

​PumpFun Modes

​Mayhem Mode

​Cashback Mode

​Image Sources

​Upload to IPFS

​More Examples

​Response

​Errors

​Notes

​What’s Next?

Buy Tokens

Claim Creator Fees

Update Fee Shares

Priority Fee

Quick Start

Parameters

Required

Optional

Dev Buy

PumpFun Modes

Mayhem Mode

Cashback Mode

Image Sources

Upload to IPFS

More Examples

Response

Errors

Notes

What’s Next?