Token Launch

Token Launch API for AI Agents

AI agents can now launch their own ERC-20 tokens, manage liquidity, and distribute governance rights programmatically. Purple Flea's token launch API supports Uniswap V3 deployment, initial liquidity provisioning, and token vesting schedules — all via a single API call.

Get Free API Key → View API Docs

ERC-20

and SPL support

Uniswap Auto-Pool

Vesting

Schedules Built-in

10 min

From Idea to Live Token

Why Agents Launch Tokens

Three legitimate economic use cases for autonomous agents deploying their own tokens into the market.

💸

Revenue Sharing Token

An agent that provides valuable services (trading signals, data analysis, escrow coordination) can issue a revenue-sharing token. Token holders receive a percentage of the agent's fee income, proportional to their stake. The token aligns incentives between the agent's work and its supporters.

🗳️

Governance Token for DAOs

Agents that coordinate groups of sub-agents or manage shared resources can issue governance tokens. Token holders vote on strategy parameters, fee structures, and capital allocation. A single agent can spawn an entire on-chain organization with verifiable governance from day one.

⚙️

Utility Token for Agent Ecosystems

Agents building multi-agent ecosystems can create utility tokens as the native currency. Other agents pay in this token to access services, creating a closed-loop token economy. Token burns on each transaction create deflationary pressure as the ecosystem grows.

Launch Process

Four steps from initial concept to a live, tradeable token with Uniswap V3 liquidity.

Define Token Parameters

Set the token name, symbol, total supply, and decimal places. Choose which chain to deploy on (Ethereum mainnet for max liquidity, Base for low gas, Solana for speed). Define the initial distribution: what percentage goes to the liquidity pool, what is held by the agent, what is reserved for vesting.

Deploy ERC-20 Contract

A single POST to /v1/token/deploy compiles and deploys an audited ERC-20 contract. The contract includes standard transfer, approval, and allowance functions, plus optional extensions: mint (for future issuance), burn (deflationary mechanics), and pause (emergency halt). Contract address returned within one block.

Add Initial Uniswap V3 Liquidity

Create a Uniswap V3 pool with concentrated liquidity in your desired price range. Choose the fee tier (0.05% for stablecoins, 0.3% for standard, 1% for volatile). The API handles pool creation, position minting, and price range selection automatically. Your token is immediately tradeable on Uniswap after this step.

Configure Vesting and Lockup

Set vesting schedules for any tokens held by the agent or allocated to early contributors. Define cliff periods (no tokens released before a date), linear vesting (gradual release over N months), and milestone-based vesting (tokens release when on-chain conditions are met). All vesting is enforced by smart contract with no override.

API Endpoints

Complete token lifecycle management from deployment through distribution.

Method	Endpoint	Description
POST	/v1/token/deploy	Deploy an ERC-20 (Ethereum/Base) or SPL (Solana) token contract. Returns contract address and deployment transaction hash. Specify name, symbol, total supply, decimals, and chain.
POST	/v1/token/add-liquidity	Create a Uniswap V3 pool and add initial liquidity. Specify token address, ETH or USDC amount, fee tier, and price range. Returns pool address and position NFT ID.
GET	/v1/token/info	Get live token metrics: current price, market cap, 24h volume, number of unique holders, circulating vs. total supply, and liquidity depth at key price levels.
POST	/v1/token/vest	Configure on-chain vesting schedule: cliff date, linear vesting duration, and beneficiary address. Deployed as a VestingWallet smart contract that releases tokens per block.
POST	/v1/token/airdrop	Distribute tokens to a list of addresses in a single transaction using an optimized airdrop contract. Up to 1,000 recipients per call. Supports equal distribution or custom amounts per address.
GET	/v1/token/holders	Get current top holder list: addresses, balances, and percentage of supply. Includes wallet labels for known exchanges, protocols, and whale wallets where identifiable.

Launch Template

A minimal viable token launch in Python — deploy, add liquidity, and return the live token address in one function call.

import requests

HEADERS = {"Authorization": "Bearer YOUR_PURPLEFLEA_API_KEY"}
PF_BASE = "https://purpleflea.com/api"

def launch_token(name: str, symbol: str, supply: int, initial_liquidity_eth: float) -> dict:
    """Deploy an ERC-20 token on Base and add Uniswap V3 liquidity"""

    print(f"Deploying {symbol} token with supply {supply:,}...")

    # Step 1: Deploy ERC-20 contract on Base (low gas)
    token = requests.post(
        f"{PF_BASE}/v1/token/deploy",
        json={
            "name": name,
            "symbol": symbol,
            "total_supply": supply,
            "decimals": 18,
            "chain": "base",
            "features": ["burnable"]
        },
        headers=HEADERS
    ).json()

    contract = token["contract_address"]
    print(f"Deployed at: {contract}")

    # Step 2: Add Uniswap V3 liquidity (full range)
    liquidity = requests.post(
        f"{PF_BASE}/v1/token/add-liquidity",
        json={
            "token_address": contract,
            "eth_amount": initial_liquidity_eth,
            "fee_tier": 3000,     # 0.3% fee tier
            "price_range": "full",   # v3 full range position
            "chain": "base"
        },
        headers=HEADERS
    ).json()

    pool = liquidity["pool_address"]
    print(f"Uniswap V3 pool: {pool}")
    print(f"Initial price: {liquidity['initial_price_eth']} ETH per {symbol}")

    # Step 3: Set vesting for agent-held allocation (24-month linear)
    requests.post(
        f"{PF_BASE}/v1/token/vest",
        json={
            "token_address": contract,
            "beneficiary": token["agent_wallet"],
            "amount": int(supply * 0.2),   # 20% to agent
            "cliff_months": 6,
            "vesting_months": 24
        },
        headers=HEADERS
    )

    return {
        "contract": contract,
        "pool": pool,
        "symbol": symbol,
        "explorer_url": f"https://basescan.org/token/{contract}"
    }


# Launch an example agent service token
result = launch_token(
    name="Purple Trading Token",
    symbol="PTT",
    supply=1_000_000,
    initial_liquidity_eth=0.5
)
print(f"Token live at: {result['explorer_url']}")
      

Post-Launch Management

Launch is just the beginning. Agents manage token economics continuously after deployment.

📊

Price and Volume Monitoring

Poll /v1/token/info on a schedule. Alert when price drops below a support level, volume spikes above average, or a single wallet accumulates more than 10% of supply. React automatically with buybacks or announcements.

💧

Liquidity Management

Monitor pool depth and adjust the V3 position range as the token price moves. Narrow the range when the market stabilizes to earn more fees. Widen it during volatility to reduce impermanent loss. All adjustable via /v1/token/add-liquidity with updated parameters.

🔙

Buybacks and Burns

Route a portion of trading fee income into programmatic buybacks. Use the Trading API to buy tokens on Uniswap when price is below a target, then call the burn function to reduce circulating supply. Creates systematic deflationary pressure tied to real revenue.

MCP Tool Calling

All token launch and management endpoints are available as MCP tools for AI agent frameworks.

token_deploy token_add_liquidity token_info token_vest token_airdrop token_holders

Connect via https://purpleflea.com/mcp to use these tools from Claude, GPT-4, or any MCP-compatible framework.