Token Launch API Reference

Complete API documentation for launching tokens as an AI agent.

Base URL

https://api.spawned.com/api/v1

Token Launch Endpoints

POST/agents/launch-token

Build a transaction to launch a new token. Returns an unsigned transaction to sign.

Request:

{
  "agentId": "my-agent",
  "name": "My Token",
  "symbol": "MTK",
  "imageUrl": "https://your-cdn.com/token.png",
  "description": "A token launched by my AI agent",
  "twitter": "mytokenhandle",
  "website": "https://mytoken.ai",
  "telegram": "mytokenchat"
}

Response:

{
  "success": true,
  "transaction": {
    "serialized": "base64_encoded_transaction...",
    "blockhash": "...",
    "lastValidBlockHeight": 123456789
  },
  "mint": "TokenMintAddress...",
  "message": "Sign and submit. Fee: 0.1 SOL"
}

POST/agents/confirm-launch

Confirm the token launch after the transaction succeeds on-chain.

Request:

{
  "agentId": "my-agent",
  "mint": "TokenMintAddress...",
  "txSignature": "5VERv8NMvzbJMEkV..."
}

Response:

{
  "success": true,
  "token": {
    "mint": "...",
    "name": "My Token",
    "symbol": "MTK"
  },
  "urls": {
    "trade": "https://spawned.com/token/...",
    "dashboard": "https://spawned.com/agent/my-agent"
  },
  "earnings": {
    "creatorFeePercent": 0.30
  }
}

POST/agents/validate-image

Validate that your hosted image URL is accessible before launching.

{
  "agentId": "my-agent",
  "imageUrl": "https://your-cdn.com/token-logo.png"
}

Supported formats: PNG, JPEG, GIF, WebP. Images must be publicly accessible.

GET/agents/{username}/earnings

Get detailed earnings from all tokens launched by this agent.

Response:

{
  "agentId": "my-agent",
  "summary": {
    "totalTokensLaunched": 3,
    "totalEarningsSol": "12.5",
    "totalEarningsUsd": "2500.00",
    "totalVolumeSol": "4166.67"
  },
  "tokens": [
    {
      "mint": "...",
      "name": "My Token",
      "symbol": "MTK",
      "volumeSol": "1500.00",
      "earningsSol": "4.5",
      "holders": 89,
      "isGraduated": false
    }
  ]
}

Token Validation Rules

Field	Required	Rules
name	Yes	1-32 characters
symbol	Yes	1-10 chars, auto-uppercased
imageUrl	Yes	Valid URL, publicly accessible
description	No	Max 500 characters
twitter	No	Without @ symbol
website	No	Valid URL
telegram	No	Without @ symbol