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.

This guide walks through launching a tokenized agent with fee_selection: "frenzy" — a mode that doubles the bonding curve fees and places your token on the Frenzy leaderboard for increased visibility. What you need:
  • A Swarms API key (get one here)
  • A Solana wallet private key with at least 0.04 SOL for transaction fees

​
What is Frenzy mode?

Setting fee_selection: "frenzy" routes your token launch through a 2× fee Jupiter API key. This:
  • Doubles the bonding curve fees collected from traders
  • Lists your token on the Frenzy leaderboard, giving it prominent placement for users browsing high-activity tokens
  • Has no effect on the token creation cost you pay (still ~0.04 SOL)
You can combine Frenzy mode with either quote mint:
  • "SOL" (default) — SOL-denominated bonding curve
  • "USDC" — USDC-denominated bonding curve

​
Quickstart

curl -X POST https://swarms.world/api/token/launch \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Frenzy Research Agent",
    "description": "An AI research agent launched in Frenzy mode for maximum visibility.",
    "ticker": "FRNZ",
    "private_key": "[1,2,3,...]",
    "fee_selection": "frenzy",
    "quote_mint": "SOL"
  }'

​
With a USDC-denominated bonding curve

Pass "quote_mint": "USDC" to price the bonding curve in USDC instead of SOL. The default market cap targets shift to initialMarketCap: 4000 USDC and migrationMarketCap: 9000 USDC. 
curl -X POST https://swarms.world/api/token/launch \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Frenzy USDC Agent",
    "description": "Frenzy mode with a USDC-denominated bonding curve.",
    "ticker": "FUSD",
    "private_key": "[1,2,3,...]",
    "fee_selection": "frenzy",
    "quote_mint": "USDC"
  }'

​
With an image

You can attach an agent icon. Pass an image URL, a base64 data URL, or upload a raw file via multipart. 
payload = {
    "name": "Frenzy Agent With Icon",
    "description": "Frenzy launch with a custom agent icon.",
    "ticker": "FICO",
    "private_key": PRIVATE_KEY,
    "fee_selection": "frenzy",
    "quote_mint": "SOL",
    "image": "https://example.com/agent-icon.png",
}

​
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"
}

​
Common errors

Insufficient SOL (400): The creator wallet needs at least 0.04 SOL. 
{
  "error": "Insufficient SOL balance",
  "message": "Token launch requires at least 0.04 SOL in the creator wallet. Your balance is 0.0029 SOL. Please add SOL and try again.",
  "required_sol": 0.04,
  "current_balance_sol": 0.0029,
  "status_code": 400
}
Invalid API key (401): 
{
  "error": "Authentication failed",
  "message": "Invalid or missing API key. Please check your API key and try again.",
  "how_to_get_key": "https://swarms.world/platform/api-keys",
  "status_code": 401
}

​
See also