OpenServ Launch API

Launch tokens instantly on Base blockchain with one-sided concentrated liquidity pools on Aerodrome Slipstream.

Reference files:

reference.md - Full API reference for all endpoints
troubleshooting.md - Common issues and solutions
examples/ - Complete code examples

Base URL: https://instant-launch.openserv.ai

What This API Does

Deploys ERC-20 tokens - 1 billion supply, standard token contract
Creates Aerodrome CL pools - One-sided liquidity with 2,000,000x price range
Locks LP for 1 year - Automatic rug-pull protection
Splits fees 50/50 - Creator wallet receives 50% of all trading fees

Quick Start

Dependencies

npm install axios

Launch a Token

import axios from 'axios'

const response = await axios.post('https://instant-launch.openserv.ai/api/launch', {
  name: 'My Token',
  symbol: 'MTK',
  wallet: '0x1234567890abcdef1234567890abcdef12345678',
  description: 'A cool memecoin',
  imageUrl: 'https://example.com/logo.png',
  website: 'https://mytoken.com',
  twitter: '@mytoken'
})

console.log(response.data)
// {
//   success: true,
//   token: { address: '0x...', name: 'My Token', symbol: 'MTK', supply: '1000000000' },
//   pool: { address: '0x...', tickSpacing: 500, fee: '2%' },
//   locker: { address: '0x...', lpTokenId: '12345', lockedUntil: '2027-02-03T...' },
//   txHashes: { tokenDeploy: '0x...', lpMint: '0x...', lock: '0x...', buy: '0x...' },
//   links: { explorer: '...', aerodrome: '...', dexscreener: '...' }
// }

Endpoints Overview

Endpoint	Method	Description
`/api/launch`	POST	Create a new token with LP pool
`/api/tokens`	GET	List launched tokens
`/api/tokens/:address`	GET	Get token details by address

Launch Request Fields

Field	Type	Required	Description
`name`	string	Yes	Token name (1-64 characters)
`symbol`	string	Yes	Token symbol (1-10 chars, uppercase, alphanumeric)
`wallet`	string	Yes	Creator wallet address (receives 50% of fees)
`description`	string	No	Token description (max 500 characters)
`imageUrl`	string	No	Direct link to image file (jpg, png, gif, webp, svg)
`website`	string	No	Website URL (must start with http/https)
`twitter`	string	No	Twitter handle (with or without @)

Launch Response

interface LaunchResponse {
  success: true
  internalId: string           // Database record ID
  creator: string              // Creator wallet address
  token: {
    address: string            // Deployed token contract
    name: string
    symbol: string
    supply: string             // Always "1000000000"
  }
  pool: {
    address: string            // Aerodrome CL pool
    tickSpacing: number        // 500
    fee: string                // "2%"
  }
  locker: {
    address: string            // LP locker contract
    lpTokenId: string          // NFT position ID
    lockedUntil: string        // ISO date (1 year from launch)
  }
  txHashes: {
    tokenDeploy: string        // Token deployment tx
    stakingTransfer: string    // 5% staking allocation tx
    lpMint: string             // LP position mint tx
    lock: string               // LP lock tx
    buy: string                // Initial buy tx
  }
  links: {
    explorer: string           // Basescan token page
    aerodrome: string          // Aerodrome swap page
    dexscreener: string        // DEXScreener chart
    defillama: string          // DefiLlama swap
  }
}

Token Defaults

Setting	Value
Token Supply	1 billion
Initial Market Cap	$15,000
Price Range	2,000,000x (~$30B)
Pool Fee	2%
Tick Spacing	500
Fee Split	50/50 (creator/platform)
Lock Duration	1 year
Staking Allocation	5%
Initial Buy	0.0005 ETH

Example: Agent with Token Launch Capability

import { Agent, run } from '@openserv-labs/sdk'
import { provision, triggers } from '@openserv-labs/client'
import { z } from 'zod'
import axios from 'axios'

const agent = new Agent({
  systemPrompt: 'You help users launch tokens on Base blockchain.'
})

agent.addCapability({
  name: 'launch_token',
  description: 'Launch a new ERC-20 token with LP pool on Aerodrome',
  schema: z.object({
    name: z.string().describe('Token name (1-64 chars)'),
    symbol: z.string().describe('Token symbol (1-10 chars, uppercase)'),
    wallet: z.string().describe('Creator wallet address'),
    description: z.string().optional().describe('Token description'),
    imageUrl: z.string().optional().describe('Logo image URL'),
    website: z.string().optional().describe('Website URL'),
    twitter: z.string().optional().describe('Twitter handle')
  }),
  async run({ args }) {
    const response = await axios.post('https://instant-launch.openserv.ai/api/launch', args)
    const { token, pool, links } = response.data
    return `Token launched! Address: ${token.address}, Pool: ${pool.address}, Trade: ${links.aerodrome}`
  }
})

async function main() {
  await provision({
    agent: {
      instance: agent,
      name: 'token-launcher',
      description: 'Launch tokens on Base with Aerodrome LP'
    },
    workflow: {
      name: 'Token Launcher',
      goal: 'Launch ERC-20 tokens on Base blockchain with Aerodrome concentrated liquidity pools',
      trigger: triggers.webhook({ waitForCompletion: true, timeout: 600 })
    }
  })
  await run(agent)
}

main().catch(console.error)

Rate Limits

1 token per wallet per 24 hours (spam prevention)
Creator wallet must have on-chain activity (not empty)

Network

All tokens are deployed on Base Mainnet (chainId: 8453).

Updating This Skill

This skill may be outdated. The OpenServ team ships updates regularly—new features, API changes, and bug fixes won't be reflected here until you update. If something isn't working as expected, or you want to make sure you have the latest information, update the skill before proceeding.

# Check if updates are available
npx skills check

# Update all installed skills to latest versions
npx skills update

Or reinstall the OpenServ skills directly:

npx skills add openserv-labs/skills

Related Skills

openserv-agent-sdk - Build agents with token launch capabilities
openserv-client - Provision and deploy agents on the platform
openserv-multi-agent-workflows - Multi-agent collaboration patterns
openserv-ideaboard-api - Find ideas and ship token-related services

openserv-launch