internet-court/internet-court-skill / vendored/openserv/openserv-launch
openserv-launch
VerifiedLaunch tokens on Base blockchain via the OpenServ Launch API. Creates ERC-20 tokens with Aerodrome concentrated liquidity pools. Use when launching tokens, deploying memecoins, or building agents that create tokens with locked LP. Read reference.md for the full API reference. Read openserv-agent-sdk and openserv-client for building and running agents. You can launch tokens for your OpenServ agents.
| File | Kind | Size |
|---|---|---|
| LICENSE | other | 346 B |
| SKILL.md | skill md | 7.5 KB |
| examples/agent-launcher.ts | script | 6.4 KB |
| examples/env.example | other | 217 B |
| examples/launch-token.ts | script | 4.1 KB |
| examples/list-tokens.ts | script | 3.2 KB |
| reference.md | markdown | 10.0 KB |
| troubleshooting.md | markdown | 5.0 KB |
reference.md
View on GitHub# OpenServ Launch API Reference
Complete API reference for all endpoints.
**Base URL:** `https://instant-launch.openserv.ai`
For examples, see `examples/` folder.
---
## POST /api/launch
Create a new token with one-sided LP pool on Aerodrome Slipstream.
**When to use:** Launch a new ERC-20 token with automatic liquidity pool creation and LP locking.
### Request Body
| 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 image URL (jpg, jpeg, png, gif, webp, svg, avif, bmp, ico) |
| `website` | string | No | Website URL (must start with http:// or https://) |
| `twitter` | string | No | Twitter handle (with or without @, max 15 chars) |
### Example Request
```bash
curl -X POST "https://instant-launch.openserv.ai/api/launch" \
-H "Content-Type: application/json" \
-d '{
"name": "My Token",
"symbol": "MTK",
"wallet": "0x1234567890abcdef1234567890abcdef12345678",
"description": "A revolutionary memecoin",
"imageUrl": "https://example.com/logo.png",
"website": "https://mytoken.com",
"twitter": "@mytoken"
}'
```
### Example Response (201 Created)
```json
{
"success": true,
"internalId": "65f1a2b3c4d5e6f7g8h9i0j1",
"creator": "0x1234567890abcdef1234567890abcdef12345678",
"token": {
"address": "0xabcdef1234567890abcdef1234567890abcdef12",
"name": "My Token",
"symbol": "MTK",
"supply": "1000000000"
},
"pool": {
"address": "0x9876543210fedcba9876543210fedcba98765432",
"tickSpacing": 500,
"fee": "2%"
},
"locker": {
"address": "0xfedcba9876543210fedcba9876543210fedcba98",
"lpTokenId": "12345",
"lockedUntil": "2027-02-05T10:30:00.000Z"
},
"txHashes": {
"tokenDeploy": "0x1111111111111111111111111111111111111111111111111111111111111111",
"stakingTransfer": "0x2222222222222222222222222222222222222222222222222222222222222222",
"lpMint": "0x3333333333333333333333333333333333333333333333333333333333333333",
"lock": "0x4444444444444444444444444444444444444444444444444444444444444444",
"buy": "0x5555555555555555555555555555555555555555555555555555555555555555"
},
"links": {
"explorer": "https://basescan.org/token/0xabcdef1234567890abcdef1234567890abcdef12",
"aerodrome": "https://aerodrome.finance/swap?from=eth&to=0xabcdef1234567890abcdef1234567890abcdef12",
"dexscreener": "https://dexscreener.com/base/0x9876543210fedcba9876543210fedcba98765432",
"defillama": "https://swap.defillama.com/?chain=base&from=0x0000000000000000000000000000000000000000&tab=swap&to=0xabcdef1234567890abcdef1234567890abcdef12"
}
}
```
### Error Responses
| Status | Description |
| ------ | ----------------------------------------------------- |
| 400 | Validation error (invalid name, symbol, wallet, etc.) |
| 400 | Daily launch limit reached (1 per wallet per 24h) |
| 400 | Creator wallet has no on-chain activity |
| 500 | Transaction failed (insufficient gas, RPC error) |
---
## GET /api/tokens
List launched tokens with pagination.
**When to use:** Browse all tokens launched via the API, optionally filtered by creator.
### Query Parameters
| Parameter | Type | Default | Description |
| --------- | ------ | ------- | ----------------------------------- |
| `limit` | number | 50 | Items per page (1-100) |
| `page` | number | 1 | Page number (1-based) |
| `creator` | string | - | Filter by creator wallet address |
### Example Request
```bash
# List first page of tokens
curl "https://instant-launch.openserv.ai/api/tokens"
# Filter by creator
curl "https://instant-launch.openserv.ai/api/tokens?creator=0x1234..."
# Paginate results
curl "https://instant-launch.openserv.ai/api/tokens?limit=10&page=2"
```
### Example Response
```json
{
"success": true,
"tokens": [
{
"address": "0xabcdef1234567890abcdef1234567890abcdef12",
"name": "My Token",
"symbol": "MTK",
"description": "A revolutionary memecoin",
"imageUrl": "https://example.com/logo.png",
"creator": "0x1234567890abcdef1234567890abcdef12345678",
"pool": "0x9876543210fedcba9876543210fedcba98765432",
"locker": "0xfedcba9876543210fedcba9876543210fedcba98",
"initialMarketCapUsd": 15000,
"launchedAt": "2026-02-05T10:30:00.000Z",
"links": {
"explorer": "https://basescan.org/token/0x...",
"aerodrome": "https://aerodrome.finance/swap?from=eth&to=0x...",
"dexscreener": "https://dexscreener.com/base/0x..."
}
}
],
"pagination": {
"limit": 50,
"page": 1,
"totalDocs": 100,
"totalPages": 2,
"hasPrevPage": false,
"hasNextPage": true,
"prevPage": null,
"nextPage": 2
}
}
```
---
## GET /api/tokens/:address
Get detailed information about a specific token by its contract address.
**When to use:** Fetch complete token details including pool configuration, locker info, and transaction hashes.
### Path Parameters
| Parameter | Type | Required | Description |
| --------- | ------ | -------- | ------------------------------ |
| `address` | string | Yes | Token contract address (0x...) |
### Example Request
```bash
curl "https://instant-launch.openserv.ai/api/tokens/0xabcdef1234567890abcdef1234567890abcdef12"
```
### Example Response
```json
{
"success": true,
"token": {
"address": "0xabcdef1234567890abcdef1234567890abcdef12",
"name": "My Token",
"symbol": "MTK",
"description": "A revolutionary memecoin",
"imageUrl": "https://example.com/logo.png",
"website": "https://mytoken.com",
"twitter": "@mytoken",
"supply": "1000000000",
"decimals": 18
},
"pool": {
"address": "0x9876543210fedcba9876543210fedcba98765432",
"tickSpacing": 500,
"tickLower": -887200,
"tickUpper": 0,
"fee": "2%"
},
"locker": {
"address": "0xfedcba9876543210fedcba9876543210fedcba98",
"lpTokenId": "12345",
"lockedUntil": "2027-02-05T10:30:00.000Z"
},
"fees": {
"creatorWallet": "0x1234567890abcdef1234567890abcdef12345678",
"platformWallet": "0x...",
"creatorShare": "50%",
"platformShare": "50%"
},
"transactions": {
"tokenDeploy": "0x1111...",
"lpMint": "0x3333...",
"lock": "0x4444..."
},
"meta": {
"chainId": 8453,
"initialMarketCapUsd": 15000,
"launchedAt": "2026-02-05T10:30:00.000Z",
"createdAt": "2026-02-05T10:30:00.000Z"
},
"links": {
"explorer": "https://basescan.org/token/0x...",
"aerodrome": "https://aerodrome.finance/swap?from=eth&to=0x...",
"dexscreener": "https://dexscreener.com/base/0x..."
}
}
```
### Error Responses
| Status | Description |
| ------ | ----------------- |
| 400 | Invalid address |
| 404 | Token not found |
---
## Error Format
All errors follow this format:
```json
{
"success": false,
"error": "Detailed error message"
}
```
Common validation errors include:
- `Token name is required`
- `Token name must be 64 characters or less`
- `Token symbol is required`
- `Token symbol must be 10 characters or less`
- `Token symbol must contain only letters and numbers`
- `Invalid Ethereum address format`
- `Description must be 500 characters or less`
- `Image URL must be a direct link to an image file`
- `Website must be a valid URL`
- `Invalid Twitter handle format`
- `Daily launch limit reached (1 per day)`
---
## Contract Addresses (Base Mainnet)
| Contract | Address |
| --------------------------- | -------------------------------------------- |
| CLFactory | `0xaDe65c38CD4849aDBA595a4323a8C7DdfE89716a` |
| NonfungiblePositionManager | `0xa990c6a764b73bf43cee5bb40339c3322fb9d55f` |
| CLPoolLauncher | `0xb9A1094D614c70B94C2CD7b4efc3A6adC6e6F4d3` |
| CLLockerFactory | `0x8BF02b8da7a6091Ac1326d6db2ed25214D812219` |
| Universal Router | `0x6Df1c91424F79E40E33B1A48F0687B666bE71075` |
| WETH | `0x4200000000000000000000000000000000000006` |
---
## TypeScript Types
```typescript
// Request body for POST /api/launch
interface LaunchRequest {
name: string // 1-64 chars
symbol: string // 1-10 chars, uppercase, alphanumeric
wallet: string // Valid Ethereum address
description?: string // Max 500 chars
imageUrl?: string // Direct image URL
website?: string // http/https URL
twitter?: string // Twitter handle
}
// Response from POST /api/launch
interface LaunchResponse {
success: true
internalId: string
creator: string
token: {
address: string
name: string
symbol: string
supply: string
}
pool: {
address: string
tickSpacing: number
fee: string
}
locker: {
address: string
lpTokenId: string
lockedUntil: string
}
txHashes: {
tokenDeploy: string
stakingTransfer: string
lpMint: string
lock: string
buy: string
}
links: {
explorer: string
aerodrome: string
dexscreener: string
defillama: string
}
}
// Token in list response
interface TokenListItem {
address: string
name: string
symbol: string
description: string
imageUrl?: string
creator: string
pool: string
locker: string
initialMarketCapUsd: number
launchedAt: string
links: {
explorer: string
aerodrome: string
dexscreener: string
}
}
// Pagination info
interface Pagination {
limit: number
page: number
totalDocs: number
totalPages: number
hasPrevPage: boolean
hasNextPage: boolean
prevPage: number | null
nextPage: number | null
}
```
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| writing-skillsobra/superpowersUse when creating new skills, editing existing skills, or verifying skills work before deployment | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| xlsxanthropics/skillsUse this skill any time a spreadsheet file is the primary input or output. This means any task where the user wants to: open, read, edit, or fix an existing .xlsx, .xlsm, .xltx, .csv, or .tsv file (e.g., adding columns, computing formulas, formatting, charting, cleaning messy data); create a new spreadsheet from scratch or from other data sources; or convert between tabular file formats. Trigger especially when the user references a spreadsheet file by name or path — even casually (like "the xlsx in my downloads") — and wants something done to it or produced from it. Also trigger for cleaning or restructuring messy tabular data files (malformed rows, misplaced headers, junk data) into proper spreadsheets. The deliverable must be a spreadsheet file. Do NOT trigger when the primary deliverable is a Word document, HTML report, standalone Python script, database pipeline, or Google Sheets API integration, even if tabular data is involved. | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| shipping-and-launchaddyosmani/agent-skillsPrepares production launches. Use when preparing to deploy to production, or when asking what needs to be in place before shipping. Use when you need a pre-launch checklist, when setting up monitoring, when planning a staged rollout, or when you need a rollback strategy. | Stars: 119k | Updated | Claude CodeCodex | Verified | Install |
| childhoodthedotmack/claude-memBabysit a shipped release after merge, publication, or deployment. Verify published packages, production behavior, installed plugins, and late CI or user reports until the observation window is clean; use babysit for PR readiness before release. | Stars: 118k | Updated | Claude CodeCodex | Verified | Install |