# three.ws Pump.fun Token Launch

> three.ws Pump.fun Token Launch is a paid API for AI agents from three.ws, paid per call via x402, $5/call, status unknown (last checked 2026-09-15).

Launches a new token on Pump.fun (Solana) with optional vanity mint address, returning the mint address, transaction signature, and metadata URI

## Facts

- Endpoint: POST https://three.ws/api/x402/pump-launch
- Price: $5/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/three-ws-pump-fun-token-launch-a3a15c08
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_LR4bT9yHVlVYUcIDyFywp

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability three-ws-pump-fun-token-launch-a3a15c08 -d '<json body>'
```

Example prompt: Launch a new Pump.fun token called 'Helios' with the symbol 'HELIO' on Solana mainnet, and try to get a mint address starting with 'HEL'.

## When to prefer this

Use this endpoint when you need to programmatically launch a new token on Pump.fun (Solana) with optional vanity mint address generation. Prefer this over manual Pump.fun UI when automating token creation for 3D agents or other projects that need on-chain token issuance with metadata at scale.

## Known failure modes

- Vanity prefix too long or rare — causes timeout or excessive iteration count
- Invalid creator wallet address — returns 400 or transaction failure
- Duplicate token symbol — may succeed on-chain but cause confusion
- Insufficient USDC for $5 payment — request rejected before processing
- Network congestion on Solana — transaction may fail or be delayed
- IPFS metadata upload failure — metadataUri may be null or unavailable

## How this service works

Make a 3D AI agent from a selfie in 60 seconds. Drop one HTML tag to embed it on any website. Agents think on IBM watsonx.ai (Granite); optionally charge per chat with built-in micropayments.

## Output

Returns a JSON object with the Solana mint address, token name and symbol, creator wallet, network, Solscan explorer link, transaction signature, IPFS metadata URI, Pump.fun coin URL, vanity prefix/suffix used, number of vanity iterations attempted, and time taken in milliseconds.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "name",
  "symbol"
 ],
 "properties": {
  "name": {
   "type": "string",
   "description": "Token name, e.g. \"Helios\". 1–32 chars."
  },
  "symbol": {
   "type": "string",
   "description": "Token ticker, e.g. \"HELIO\". 1–10 chars. Check availability first with the free GET /api/crypto/symbol?ticker=<symbol> so you do not collide with a live coin."
  },
  "creator": {
   "type": "string",
   "description": "Solana pubkey (base58) to receive pump.fun creator rewards. Defaults to the launcher when omitted."
  },
  "twitter": {
   "type": "string",
   "description": "Twitter/X URL for the pinned metadata (imageUrl path)."
  },
  "website": {
   "type": "string",
   "description": "Website URL for the pinned metadata (imageUrl path)."
  },
  "imageUrl": {
   "type": "string",
   "description": "https URL of the token image. When metadataUri is omitted, the image + a descriptor (name/symbol/description/socials) are pinned to pump.fun IPFS for you (png, jpeg, gif, webp; max 5 MB)."
  },
  "telegram": {
   "type": "string",
   "description": "Telegram URL for the pinned metadata (imageUrl path)."
  },
  "description": {
   "type": "string",
   "description": "Coin description. Used only when we pin metadata for you (imageUrl path)."
  },
  "metadataUri": {
   "type": "string",
   "description": "Pre-pinned pump.fun metadata descriptor (JSON on IPFS). Provide this OR imageUrl. When supplied it is used verbatim and no pinning happens server-side."
  },
  "vanityPrefix": {
   "type": "string",
   "description": "Base58 prefix to grind into the mint address (≤5 chars; longer = slower). When a matching pre-ground address is already in stock, it is delivered instantly instead of grinding — see vanity_source in the response."
  },
  "vanitySuffix": {
   "type": "string",
   "description": "Base58 suffix to grind into the mint address (≤5 chars; longer = slower). Same instant-inventory upsell as vanityPrefix."
  },
  "vanityIgnoreCase": {
   "type": "boolean",
   "description": "Match vanityPrefix/Suffix case-insensitively (faster grind). Default false."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "mint",
  "signature",
  "metadataUri",
  "pumpfun_url"
 ],
 "properties": {
  "mint": {
   "type": "string"
  },
  "name": {
   "type": "string"
  },
  "symbol": {
   "type": "string"
  },
  "creator": {
   "type": "string"
  },
  "network": {
   "type": "string"
  },
  "explorer": {
   "type": "string",
   "format": "uri"
  },
  "signature": {
   "type": "string"
  },
  "metadataUri": {
   "type": "string",
   "format": "uri"
  },
  "pumpfun_url": {
   "type": "string",
   "format": "uri"
  },
  "vanity_prefix": {
   "type": [
    "string",
    "null"
   ]
  },
  "vanity_source": {
   "enum": [
    "inventory",
    "ground",
    null
   ],
   "type": [
    "string",
    "null"
   ],
   "description": "'inventory': the mint was a pre-ground address served instantly from stock (same price, no grind wait). 'ground': mined fresh for this launch. null: no vanityPrefix/vanitySuffix was requested."
  },
  "vanity_suffix": {
   "type": [
    "string",
    "null"
   ]
  },
  "vanity_iterations": {
   "type": "integer"
  },
  "vanity_duration_ms": {
   "type": "number"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/three-ws-pump-fun-token-launch-a3a15c08/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from three.ws](https://www.zero.xyz/host/three.ws/llms.txt)