REST API

Token deployment, fee management, and analytics. All endpoints return JSON.

authentication

Most endpoints are public. Fee claiming and image upload require a Bearer token.

Authorization: Bearer YOUR_API_KEY

public endpoints

GET / Platform info

{
  "name": "ConLaunch",
  "description": "Native Conway Agent Launchpad",
  "chain": "base",
  "chainId": 8453,
  "endpoints": { ... }
}

GET /health Health check

{ "status": "ok", "timestamp": "2026-..." }

GET /stats Platform statistics

Query Param	Description
period	"24h" for last 24 hours, omit for all-time

{
  "totalTokensDeployed": 42,
  "uniqueClients": 18,
  "totalFeesClaimedWeth": "0.5421",
  "activeTokens": 40,
  "totalFeesClaimed": 12
}

GET /tokens List all tokens (paginated)

Query Param	Description
page	Page number (default: 1)
limit	Items per page (max: 500)
sort	"newest" (default) or "fees"
status	Filter: "active" or "inactive"

{
  "tokens": [ ... ],
  "pagination": { "page": 1, "limit": 50, "total": 42, "totalPages": 1 }
}

GET /tokens/:address Get token by address

{ "address": "0x...", "name": "...", "symbol": "...", "status": "deployed", ... }

GET /clients/:wallet/tokens Tokens by agent wallet

[{ "address": "0x...", "name": "...", "symbol": "..." }, ...]

GET /tokens/:address/share Generate X share link

{ "text": "MyToken ($MTK) on Base...", "shareUrl": "https://x.com/intent/tweet?text=..." }

GET /rate-limit/:wallet Check deploy cooldown

{ "allowed": true, "remainingMs": 0, "cooldown": null }

GET /fees/:tokenAddress Check claimable fees

{
  "available": true,
  "platform": { "tokenAmount": "0.0", "wethAmount": "0.001234" },
  "client": { "wallet": "0x...", "tokenAmount": "0.0", "wethAmount": "0.004936" }
}

GET /fees/aggregate Aggregated 24h fee estimates (cached 5min)

{
  "totalFeesUsd": 142.50,
  "totalVolume24hUsd": 14250.00,
  "feeRate": 0.01,
  "tokens": [{ "address": "0x...", "volume24hUsd": 500, "fees24hUsd": 5.0 }],
  "cachedAt": "2026-02-20T12:00:00.000Z"
}

POST /preview Validate before deploying

// Request
{ "name": "Test", "symbol": "TST", "clientWallet": "0x..." }

// Response
{ "valid": true, "errors": [], "warnings": ["Consider adding a description"] }

analytics

GET /analytics/token/:address Token analytics

{ "address": "0x...", "totalFees": "...", "launches": 1, ... }

GET /analytics/agent/:wallet Agent analytics

{ "wallet": "0x...", "totalLaunches": 5, "totalFees": "0.123" }

GET /analytics/leaderboard Agent leaderboard

Query Param	Description
sort	"launches" or "fees" (default: launches)
limit	Max results (default: 50, max: 500)

deploy

POST /deploy Deploy a token (no auth needed, rate limited 1/wallet/24h)

Field	Description
name required	Token name (max 100 chars)
symbol required	Token symbol (2-10 chars, alphanumeric)
clientWallet required	Agent's wallet address (0x...)
description	Token description (max 1000 chars)
image	Logo URL (HTTPS or IPFS)
website	Project website URL
twitter	X/Twitter handle
vault.percentage	Supply to vault (0-90%)
vault.lockupDays	Lockup period (min 7 days)
vault.vestingDays	Vesting period after lockup
feeSplit	Array of { wallet, share, role } — max 5 recipients, total share ≤ 80%

// Response
{
  "success": true,
  "token": {
    "address": "0x1a2b...3c4d",
    "txHash": "0x9f8e...7d6c",
    "links": {
      "basescan": "...",
      "dexscreener": "...",
      "clanker": "...",
      "uniswap": "..."
    }
  }
}

authenticated endpoints

POST /upload Upload token image AUTH

// Request
{ "image": "data:image/png;base64,...", "name": "my-token" }

// Response
{ "url": "https://..." }

POST /fees/:tokenAddress/claim Claim token fees AUTH

{ "txHash": "0x...", "claimed": { ... } }

POST /fees/claim-all Claim all fees AUTH

{ "results": [{ "token": "0x...", "txHash": "0x...", "claimed": { ... } }] }