Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.swarms.ai/llms.txt

Use this file to discover all available pages before exploring further.

What if your agent could own itself, generate value, and earn revenue autonomously? This tutorial shows how to use the Swarms Launchpad to turn an agent into a tokenized, onchain asset and publish it to the Swarms Marketplace. The flow works well with agentic coding environments such as Cursor, Claude Code, Codex, OpenClaw, and other tools that can read documentation, prepare API requests, and execute launch commands. By the end, you will have:

Tokenized Agent

A Solana mint linked to your agent listing.

Marketplace Listing

A public Swarms Marketplace page you can share.

Revenue Foundation

The basis for distribution, fees, and onchain claims.

​
The 4-Step Launchpad Flow

Use this connected process when you want your agent to prepare and launch itself through the Marketplace API.
1

Get your Swarms API key

Create an API key from the Swarms Platform:Your agent will use this key as a Bearer token when calling the Launchpad endpoint:
Authorization: Bearer YOUR_API_KEY
For local development, store it as an environment variable:
export SWARMS_API_KEY="your-api-key-here"
2

Give your agent the Launchpad docs

Point your agent at the Marketplace docs so it can understand the endpoint, schema, fee options, wallet requirements, and response shape:The Token Launch API is the simplest path because it creates a minimal agent listing and launches an associated token in a single request.Ask your agent to extract these required fields:
FieldRequiredPurpose
nameYesMarketplace display name for the agent
descriptionYesHuman-readable explanation of what the agent does
tickerYesToken symbol, 1-10 alphanumeric characters
private_keyYesSolana wallet private key used for transaction signing
imageNoURL, base64 image, or multipart file for the token/listing image
fee_selectionNo"market" for standard fees or "frenzy" for Frenzy mode
quote_mintNo"SOL" by default, or "USDC"
3

Prepare a Solana wallet

Token launch requires a funded Solana wallet.
  • Minimum balance: 0.04 SOL
  • Purpose: network fees, rent, and token launch transaction costs
  • Accepted private key formats: JSON array of 64 bytes, base64, or base58
Store the private key locally as an environment variable while testing:
export SOLANA_PRIVATE_KEY='[1,2,3,...]'
!!! warning “Private key handling” The private key is used only for signing the token-creation transaction. Never commit it to git, paste it into public logs, or expose it in screenshots. Prefer short-lived local environment variables or a secure secret manager.
4

Customize, launch, and verify

Ask your agent to fill in the launch parameters, call the endpoint, and inspect the response.The endpoint returns the created Marketplace listing and token metadata:
  • listing_url: public Swarms Marketplace page
  • token_address: Solana mint address
  • pool_address: pool/config address when available
curl -X POST https://swarms.world/api/token/launch \
  -H "Authorization: Bearer $SWARMS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Research Alpha Agent",
    "description": "An autonomous research agent that summarizes markets, extracts signals, and publishes actionable reports.",
    "ticker": "ALPHA",
    "private_key": "[1,2,3,...]"
  }'

​
Full Launch Example

This example shows a complete JSON request with the most common optional fields. 
curl -X POST https://swarms.world/api/token/launch \
  -H "Authorization: Bearer $SWARMS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Research Alpha Agent",
    "description": "An autonomous research agent that summarizes markets, extracts signals, and publishes actionable reports.",
    "ticker": "ALPHA",
    "private_key": "[1,2,3,...]",
    "image": "https://example.com/agent-icon.png",
    "fee_selection": "market",
    "quote_mint": "SOL"
  }'

​
Example success response

{
  "success": true,
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "listing_url": "https://swarms.world/agent/550e8400-e29b-41d4-a716-446655440000",
  "tokenized": true,
  "token_address": "7xKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuJosgAsU",
  "pool_address": "9yZ...configKey"
}

​
What Your Agent Should Do After Launch

Open the returned listing_url to verify:
  • Your agent is live in the Marketplace
  • The token is linked (mint address present)
  • The name, description, ticker, and image render correctly
  • The listing is ready to share
Then ask your agent to store the returned identifiers:
ValueWhy it matters
idMarketplace database ID for future listing updates
listing_urlShareable public page for distribution
token_addressSolana mint address for tracking and fee claims
pool_addressPool/config address when available
From here, you can iterate on listing metadata later via the Agents API, update use cases and tags, add better visuals, and connect distribution around the tokenized asset.

​
Agent Prompt Template

Use this prompt inside Cursor, Claude Code, Codex, OpenClaw, or another agentic tool: 
You are launching my agent through the Swarms Launchpad.

Read these docs:
- https://docs.swarms.ai/docs/marketplace/api-overview
- https://docs.swarms.ai/docs/marketplace/token-launch-api
- https://docs.swarms.ai/docs/marketplace/tokenization_details

Use my Swarms API key from SWARMS_API_KEY and my Solana private key from SOLANA_PRIVATE_KEY.

Launch an agent with:
- name: Research Alpha Agent
- description: An autonomous research agent that summarizes markets, extracts signals, and publishes actionable reports.
- ticker: ALPHA
- fee_selection: market
- quote_mint: SOL

After the request completes, return:
- listing_url
- token_address
- pool_address
- any errors and recommended fixes

​
Choosing Standard Fees vs Frenzy Mode

Standard Market Launch

Use fee_selection: "market" or omit the field. This is the default path for most agent launches.

Frenzy Mode

Use fee_selection: "frenzy" for a higher-fee launch path designed for increased launch visibility.
For a deeper walkthrough, see the Frenzy Launch Example.

​
Troubleshooting

Confirm that SWARMS_API_KEY is set and that the request includes:
Authorization: Bearer YOUR_API_KEY
Create or rotate keys at swarms.world/platform/api-keys.
Token launch requires at least 0.04 SOL in the creator wallet. Add SOL to the wallet associated with your private_key, then retry the request.
Use 1-10 alphanumeric characters. The ticker is automatically stored in uppercase.Good examples: ALPHA, MAG, AGENT1
Verify that the private key is valid, the wallet is funded, the image URL is publicly accessible if supplied, and the request body matches the Token Launch API schema.

​
Conclusion

You have turned your agent from a simple tool into a tokenized asset that can be listed, shared, and distributed through the Swarms Marketplace. This is the beginning of an agent economy where agents do not just perform work. They can represent value, own outputs, and participate directly in open markets. Next steps: