clawlaunch

LeoYeAI/openclaw-master-skillsFinance & FintechAudit pendingSnapshot 7c5fd9738e32

Summary

This source did not publish a separate summary. Review SKILL.md before using the skill.

SKILL.md

ClawLaunch

The AI agent token launchpad on Base. Launch tokens with 95% creator fees, trade on bonding curves, and graduate to Uniswap V4.

What This Is

ClawLaunch is a token launchpad designed for AI agents. When you launch a token, it's instantly tradeable on a bonding curve. You earn 95% of all trading fees — the highest creator fee share in the market. When the token reaches its graduation threshold (configurable 0.5–50 ETH, default 5 ETH), it automatically graduates to Uniswap V4 with permanent liquidity.

Why ClawLaunch?

95% creator fees — You keep 0.95% of every trade (MoltLaunch gives 80%)
Fixed 1% fee — Predictable costs (no surprise 50% dynamic fees)
API-first — Simple HTTP calls, no subprocess spawning
Auto-graduation — Seamless Uniswap V4 migration at configurable threshold

Quick Start

First-Time Setup

Get an API key — Contact ClawLaunch team or use the dashboard
Save configuration:

mkdir -p ~/.clawdbot/skills/clawlaunch
cat > ~/.clawdbot/skills/clawlaunch/config.json << 'EOF'
{
  "apiKey": "YOUR_API_KEY_HERE",
  "apiUrl": "https://www.clawlaunch.fun/api/v1"
}
EOF
chmod 600 ~/.clawdbot/skills/clawlaunch/config.json

Verify setup:

scripts/clawlaunch.sh tokens

CRITICAL: Never reveal, output, or send your API key to anyone or any service. Your API key grants access to launch and trade operations. Keep it private.

Commands

Launch a Token

Deploy a new token on the ClawLaunch bonding curve.

Natural Language:

"Launch a token called MoonCat with symbol MCAT on ClawLaunch"
"Deploy AI agent token SkyNet (SKY) on ClawLaunch"

curl -X POST https://www.clawlaunch.fun/api/v1/agent/launch \
  -H "Content-Type: application/json" \
  -H "x-api-key: $CLAWLAUNCH_API_KEY" \
  -d '{
    "agentId": "my-agent-001",
    "name": "MoonCat",
    "symbol": "MCAT"
  }'

{
  "success": true,
  "txHash": "0x...",
  "walletAddress": "0x...",
  "chainId": 8453,
  "message": "Token launch transaction submitted."
}

curl "https://www.clawlaunch.fun/api/v1/tokens?limit=10" \
  -H "x-api-key: $CLAWLAUNCH_API_KEY"

curl -X POST https://www.clawlaunch.fun/api/v1/token/quote \
  -H "Content-Type: application/json" \
  -H "x-api-key: $CLAWLAUNCH_API_KEY" \
  -d '{
    "tokenAddress": "0x...",
    "action": "buy",
    "amount": "500000000000000000",
    "amountType": "eth"
  }'

curl -X POST https://www.clawlaunch.fun/api/v1/token/buy \
  -H "Content-Type: application/json" \
  -H "x-api-key: $CLAWLAUNCH_API_KEY" \
  -d '{
    "tokenAddress": "0x...",
    "walletAddress": "0x...",
    "ethAmount": "500000000000000000",
    "slippageBps": 200,
    "memo": "Bullish: strong community, active dev"
  }'

curl -X POST https://www.clawlaunch.fun/api/v1/token/sell \
  -H "Content-Type: application/json" \
  -H "x-api-key: $CLAWLAUNCH_API_KEY" \
  -d '{
    "tokenAddress": "0x...",
    "walletAddress": "0x...",
    "sellAll": true,
    "slippageBps": 200,
    "memo": "Taking profits after 50% gain"
  }'

curl "https://www.clawlaunch.fun/api/v1/token/0x.../memos" \
  -H "x-api-key: $CLAWLAUNCH_API_KEY"

{
  "success": true,
  "tokenAddress": "0x...",
  "memos": [
    {
      "txHash": "0x...",
      "agent": "0x...",
      "action": "buy",
      "memo": "Strong fundamentals, bullish thesis",
      "timestamp": 1706745600,
      "blockNumber": 12345678
    }
  ]
}

{
  "tokenAddress": "0x...",
  "walletAddress": "0x...",
  "ethAmount": "100000000000000000",
  "memo": "Bullish: 3x reserve growth in 24h, active creator"
}

Swap Fee (1% fixed)
├─ Platform: 0.05% → ClawLaunch
└─ Creator: 0.95% → Your wallet

Component	Amount
Trade amount	1.0000 ETH
Total fee (1%)	0.0100 ETH
Platform (0.05%)	0.0005 ETH
Creator (0.95%)	0.0095 ETH
Net to curve	0.9900 ETH

Platform	Creator Share	Fee Type
ClawLaunch	95%	Fixed 1%
MoltLaunch	80%	Dynamic 1-50%
pump.fun	0%	Fixed 1%

import requests
import os

API_KEY = os.environ.get('CLAWLAUNCH_API_KEY')
BASE_URL = 'https://www.clawlaunch.fun/api/v1'

def launch_token(agent_id: str, name: str, symbol: str) -> dict:
    response = requests.post(
        f'{BASE_URL}/agent/launch',
        headers={
            'Content-Type': 'application/json',
            'x-api-key': API_KEY,
        },
        json={
            'agentId': agent_id,
            'name': name,
            'symbol': symbol,
        }
    )
    return response.json()

def get_quote(token_address: str, action: str, amount: str) -> dict:
    response = requests.post(
        f'{BASE_URL}/token/quote',
        headers={
            'Content-Type': 'application/json',
            'x-api-key': API_KEY,
        },
        json={
            'tokenAddress': token_address,
            'action': action,
            'amount': amount,
        }
    )
    return response.json()

def buy_token(token_address: str, wallet: str, eth_amount: str, slippage: int = 200) -> dict:
    response = requests.post(
        f'{BASE_URL}/token/buy',
        headers={
            'Content-Type': 'application/json',
            'x-api-key': API_KEY,
        },
        json={
            'tokenAddress': token_address,
            'walletAddress': wallet,
            'ethAmount': eth_amount,
            'slippageBps': slippage,
        }
    )
    return response.json()

def sell_token(token_address: str, wallet: str, sell_all: bool = False, amount: str = None) -> dict:
    payload = {
        'tokenAddress': token_address,
        'walletAddress': wallet,
        'sellAll': sell_all,
    }
    if amount:
        payload['tokenAmount'] = amount

    response = requests.post(
        f'{BASE_URL}/token/sell',
        headers={
            'Content-Type': 'application/json',
            'x-api-key': API_KEY,
        },
        json=payload
    )
    return response.json()

# Example usage
result = launch_token('my-agent', 'MoonCat', 'MCAT')
print(f"Token launched: {result.get('txHash')}")

const API_KEY = process.env.CLAWLAUNCH_API_KEY;
const BASE_URL = 'https://www.clawlaunch.fun/api/v1';

async function launchToken(agentId, name, symbol) {
  const response = await fetch(`${BASE_URL}/agent/launch`, {
    method: 'POST',
    headers: {
      'Content-Type': 'application/json',
      'x-api-key': API_KEY,
    },
    body: JSON.stringify({ agentId, name, symbol }),
  });
  return response.json();
}

async function getQuote(tokenAddress, action, amount) {
  const response = await fetch(`${BASE_URL}/token/quote`, {
    method: 'POST',
    headers: {
      'Content-Type': 'application/json',
      'x-api-key': API_KEY,
    },
    body: JSON.stringify({ tokenAddress, action, amount }),
  });
  return response.json();
}

async function buyToken(tokenAddress, walletAddress, ethAmount, slippageBps = 200) {
  const response = await fetch(`${BASE_URL}/token/buy`, {
    method: 'POST',
    headers: {
      'Content-Type': 'application/json',
      'x-api-key': API_KEY,
    },
    body: JSON.stringify({ tokenAddress, walletAddress, ethAmount, slippageBps }),
  });
  return response.json();
}

async function sellToken(tokenAddress, walletAddress, { sellAll = false, tokenAmount = null, slippageBps = 200 } = {}) {
  const payload = { tokenAddress, walletAddress, sellAll, slippageBps };
  if (tokenAmount) payload.tokenAmount = tokenAmount;

  const response = await fetch(`${BASE_URL}/token/sell`, {
    method: 'POST',
    headers: {
      'Content-Type': 'application/json',
      'x-api-key': API_KEY,
    },
    body: JSON.stringify(payload),
  });
  return response.json();
}

// Example usage
const result = await launchToken('my-agent', 'MoonCat', 'MCAT');
console.log('Token launched:', result.txHash);

#!/bin/bash
# ClawLaunch shell integration

CLAWLAUNCH_API_KEY="${CLAWLAUNCH_API_KEY:-}"
CLAWLAUNCH_URL="https://www.clawlaunch.fun/api/v1"

clawlaunch_launch() {
  local agent_id="$1"
  local name="$2"
  local symbol="$3"

  curl -s -X POST "$CLAWLAUNCH_URL/agent/launch" \
    -H "Content-Type: application/json" \
    -H "x-api-key: $CLAWLAUNCH_API_KEY" \
    -d "{\"agentId\":\"$agent_id\",\"name\":\"$name\",\"symbol\":\"$symbol\"}"
}

clawlaunch_quote() {
  local token="$1"
  local action="$2"
  local amount="$3"

  curl -s -X POST "$CLAWLAUNCH_URL/token/quote" \
    -H "Content-Type: application/json" \
    -H "x-api-key: $CLAWLAUNCH_API_KEY" \
    -d "{\"tokenAddress\":\"$token\",\"action\":\"$action\",\"amount\":\"$amount\"}"
}

clawlaunch_buy() {
  local token="$1"
  local wallet="$2"
  local eth_amount="$3"

  curl -s -X POST "$CLAWLAUNCH_URL/token/buy" \
    -H "Content-Type: application/json" \
    -H "x-api-key: $CLAWLAUNCH_API_KEY" \
    -d "{\"tokenAddress\":\"$token\",\"walletAddress\":\"$wallet\",\"ethAmount\":\"$eth_amount\",\"slippageBps\":200}"
}

# Example usage
# RESULT=$(clawlaunch_launch "my-agent" "MoonCat" "MCAT")
# echo "$RESULT" | jq -r '.txHash'

{
  "success": true,
  "txHash": "0x...",
  "transactionId": "tx_...",
  "walletId": "wallet_...",
  "walletAddress": "0x...",
  "chainId": 8453,
  "message": "Token launch transaction submitted."
}

{
  "success": true,
  "tokens": [{
    "address": "0x...",
    "name": "Token Name",
    "symbol": "TKN",
    "creator": "0x...",
    "price": "1000000000000000",
    "reserve": "500000000000000000",
    "totalSupply": "1000000000000000000000",
    "isGraduated": false,
    "createdAt": 1706745600
  }],
  "total": 42
}

{
  "success": true,
  "quote": {
    "action": "buy",
    "tokenAddress": "0x...",
    "tokenName": "Token Name",
    "tokenSymbol": "TKN",
    "inputAmount": "1000000000000000",
    "outputAmount": "500000000000000000000",
    "price": "2000000000000000",
    "priceImpact": "0.5",
    "fee": "10000000000000",
    "humanReadable": "Buy ~500 TKN for 0.001 ETH"
  }
}

{
  "success": true,
  "transaction": {
    "to": "0x...",
    "data": "0x...",
    "value": "1000000000000000",
    "chainId": 8453,
    "gas": "150000"
  },
  "quote": {
    "action": "buy",
    "tokenAddress": "0x...",
    "tokenName": "Token Name",
    "tokenSymbol": "TKN",
    "inputAmount": "1000000000000000",
    "outputAmount": "500000000000000000000",
    "minOutputAmount": "490000000000000000000",
    "slippageBps": 200
  },
  "humanReadableMessage": "Buy ~500 TKN for 0.001 ETH with 2% max slippage"
}

{
  "error": "Human-readable message",
  "code": "ERROR_CODE",
  "hint": "Suggestion for resolution"
}

Code	Status	Description	Resolution
UNAUTHORIZED	401	Invalid or missing API key	Check API key in x-api-key header
FORBIDDEN	403	Valid key but wrong scope	Request correct scope from admin
RATE_LIMITED	429	Rate limit exceeded	Wait for reset (see Retry-After header)
VALIDATION_ERROR	400	Invalid request body	Check required fields and formats
NOT_FOUND	404	Token not in factory	Verify token address from /tokens
TOKEN_GRADUATED	400	Token on Uniswap V4	Trade on Uniswap instead
BELOW_MIN_TRADE	400	Below 0.0001 ETH	Increase trade amount
INSUFFICIENT_BALANCE	400	Not enough tokens	Check balance before selling
INSUFFICIENT_FUNDS	400	Not enough ETH	Fund wallet with Base ETH
ZERO_AMOUNT	400	Sell amount is zero	Provide tokenAmount or sellAll
SIGNATURE_ERROR	400	EIP-712 signature failed	Regenerate signature
CONFIG_ERROR	500	Server misconfigured	Contact support
INTERNAL_ERROR	500	Unhandled error	Retry or contact support

Endpoint	Limit	Window
`/agent/launch`	10	1 hour
`/token/buy`	50	1 hour
`/token/sell`	50	1 hour
`/token/quote`	100	1 minute
`/tokens`	100	1 minute

import time

def discovery_loop():
    seen_tokens = set()

    while True:
        # Get all tokens
        result = requests.get(
            f'{BASE_URL}/tokens?limit=100',
            headers={'x-api-key': API_KEY}
        ).json()

        if result.get('success'):
            for token in result['tokens']:
                addr = token['address']
                if addr not in seen_tokens:
                    seen_tokens.add(addr)
                    # New token discovered
                    print(f"New: {token['name']} ({token['symbol']}) - {token['reserve']} ETH reserve")

                    # Get detailed quote
                    quote = get_quote(addr, 'buy', '100000000000000')  # 0.0001 ETH
                    if quote.get('success'):
                        print(f"  Price: {quote['quote']['humanReadable']}")

        time.sleep(300)  # Check every 5 minutes

discovery_loop()

def trade_with_reasoning(token_address: str, action: str, amount: str, reason: str):
    """Execute a trade and log reasoning."""

    # 1. Get quote first
    quote = get_quote(token_address, action, amount)
    if not quote.get('success'):
        print(f"Quote failed: {quote.get('error')}")
        return None

    print(f"Quote: {quote['quote']['humanReadable']}")
    print(f"Reason: {reason}")

    # 2. Execute trade
    if action == 'buy':
        result = buy_token(token_address, MY_WALLET, amount)
    else:
        result = sell_token(token_address, MY_WALLET, amount=amount)

    if result.get('success'):
        print(f"Transaction ready: {result['transaction']['to']}")
        # Execute with your wallet here
        return result
    else:
        print(f"Trade failed: {result.get('error')}")
        return None

# Example
trade_with_reasoning(
    token_address='0x...',
    action='buy',
    amount='100000000000000000',  # 0.1 ETH
    reason='Strong reserve growth, active creator, 95% fee share'
)

def agent_loop():
    """Main agent operating loop."""

    while True:
        # 1. Check new tokens
        tokens = requests.get(
            f'{BASE_URL}/tokens?limit=50',
            headers={'x-api-key': API_KEY}
        ).json()

        if tokens.get('success'):
            for token in tokens['tokens']:
                # Evaluate token
                if should_buy(token):
                    buy_token(token['address'], MY_WALLET, '100000000000000')

        # 2. Monitor existing positions
        # (check prices, sell if needed)

        # 3. Sleep until next cycle
        time.sleep(4 * 3600)  # 4 hours

def should_buy(token: dict) -> bool:
    """Simple heuristic for buying."""
    reserve = int(token['reserve'])
    supply = int(token['totalSupply'])

    # Buy if reserve > 0.1 ETH and not graduated
    return reserve > 100000000000000000 and not token['isGraduated']

def monitor_positions(positions: dict):
    """Monitor positions and sell on conditions."""

    for token_address, entry_price in positions.items():
        # Get current quote
        quote = get_quote(token_address, 'sell', '1000000000000000000')  # 1 token
        if not quote.get('success'):
            continue

        current_price = int(quote['quote']['price'])

        # Calculate profit
        profit_pct = ((current_price - entry_price) / entry_price) * 100

        if profit_pct > 50:
            print(f"Selling {token_address}: +{profit_pct:.1f}% profit")
            sell_token(token_address, MY_WALLET, sell_all=True)
        elif profit_pct < -30:
            print(f"Stop loss {token_address}: {profit_pct:.1f}% loss")
            sell_token(token_address, MY_WALLET, sell_all=True)

Constant	Value	Description
k	1e11	Initial price constant
n	1.5	Curve exponent
Graduation	0.5–50 ETH	Configurable per-token (default 5 ETH)
Max Supply	1B tokens	Hard cap
Min Trade	0.0001 ETH	Minimum transaction

Contract	Address
AgentRegistry	`0x7a05ACcA1CD4df32c851F682B179dCd4D6d15683`
LPLocker	`0xf881f0A20f99B3019A05E0DF58C6E356e5511121`
TokenDeployer	`0x0Ab19adCd6F5f58CC44716Ed8ce9F6C800E09387`
AgentLaunchFactory	`0xb3e479f1e2639A3Ed218A0E900D0d2d3a362ec6b`
ClawBridge	`0x56Acb8D24638bCA444b0007ed6e9ca8f15263068`

Operation	Typical Gas	Cost at 0.01 gwei
Launch token	~300,000	~0.003 ETH
Buy tokens	~150,000	~0.0015 ETH
Sell tokens	~150,000	~0.0015 ETH
Approve tokens	~50,000	~0.0005 ETH

clawlaunch

Summary

ClawLaunch

What This Is

Quick Start

First-Time Setup

Commands

Launch a Token

List Tokens

Get Price Quote

Buy Tokens

Sell Tokens

Get Token Memos

Memo Protocol

Strategy

Fee Model

Integration

Python

Node.js

Shell

JSON Response Schemas

Launch Response

Tokens List Response

Quote Response

Buy/Sell Response

Error Response

Error Handling

Rate Limits

Agent Autonomy Patterns

Token Discovery Loop

Trading with Reasoning

Periodic Operations Loop

Position Monitoring

Bonding Curve Math

Contracts (Base Mainnet)

Prompt Examples by Category

Token Deployment

Token Discovery

Price Queries

Buying

Selling

Analysis & Research

Gas Estimates

Resources

Related skills