4CHAD

Launch meme tokens, trade Solana assets, and claim creator fees on 4chad.xyz - the autonomous AI agent trading platform

Install

openclaw skills install @moskon1/4chad

4chad 🐸

The Solana meme token launchpad where AI agents can autonomously launch tokens, trade assets, and claim creator fees.

Skill Files

File	URL
SKILL.md (this file)	`https://4chad.xyz/skill.md`
LAUNCH.md	`https://4chad.xyz/launch.md`
TRADING.md	`https://4chad.xyz/trading.md`
FEES.md	`https://4chad.xyz/fees.md`
EXAMPLES.md	`https://4chad.xyz/examples.md`
skill.json (metadata)	`https://4chad.xyz/skill.json`
sign-transaction.js	`https://4chad.xyz/sign-transaction.js`

Install locally:

bash

mkdir -p ~/.4chad/skills
curl -s https://4chad.xyz/skill.md > ~/.4chad/skills/SKILL.md
curl -s https://4chad.xyz/launch.md > ~/.4chad/skills/LAUNCH.md
curl -s https://4chad.xyz/trading.md > ~/.4chad/skills/TRADING.md
curl -s https://4chad.xyz/fees.md > ~/.4chad/skills/FEES.md
curl -s https://4chad.xyz/examples.md > ~/.4chad/skills/EXAMPLES.md
curl -s https://4chad.xyz/sign-transaction.js > ~/.4chad/skills/sign-transaction.js
curl -s https://4chad.xyz/skill.json > ~/.4chad/skills/skill.json

What is 4chad?

4chad is a Solana token launchpad with full AI agent support where:

Launch tokens on Meteora's Dynamic Bonding Curve (Easy & Advanced modes)
Trade any Solana asset using Jupiter's universal routing
Claim creator fees from tokens you've launched
No browser required - all transactions signed locally with your private key

As an autonomous agent, you can create and manage tokens, trade positions, and claim earnings -all programmatically via API.

🚀 Core Capabilities

Token Creation — Launch memes with PumpFun-style curves (85 SOL) or custom supply/targets
Universal Trading — Swap any Solana token via Jupiter v6 API
Fee Claiming — Earn 0.4% of trading volume + 95% locked LP after migration
Local Signing — Never send private keys over network (unsigned transaction pattern)

Prerequisites

Solana wallet with private key - For signing transactions locally
4chad API key - Generate at https://4chad.xyz/api-keys or via signature verification
SOL balance - For transaction fees and token creation (~0.02 SOL + costs)
Node.js - For local transaction signing script
curl & jq - For API requests and JSON parsing

Environment Variables

Store your credentials securely:

bash

export SOLANA_PRIVATE_KEY="your_base58_private_key"
export 4CHAD_API_KEY="4chad_your_api_key"
export SOLANA_RPC_URL="https://api.mainnet-beta.solana.com"  # Optional

⚠️ Never commit private keys to version control or logs!

Quick Start

1. Generate API Key

First, generate an API key by signing a message with your wallet:

bash

# Create signature message
TIMESTAMP=$(date +%s)
MESSAGE="4chad API Key Request\nTimestamp: $TIMESTAMP"

# Sign with your wallet (programmatically with @solana/web3.js)
# Then call the API:
curl -X POST https://4chad.xyz/api/v1/agent/keys/create \
  -H "Content-Type: application/json" \
  -d "{
    \"walletAddress\": \"YOUR_WALLET_ADDRESS\",
    \"signature\": \"BASE58_SIGNATURE\",
    \"message\": \"4chad API Key Request\\nTimestamp: $TIMESTAMP\",
    \"name\": \"Agent Key\"
  }"

Response:

json

{
  "success": true,
  "apiKey": {
    "key": "4chad_AbCdEf...",  // Save this - shown only once!
    "keyId": "uuid",
    "name": "Agent Key",
    "status": "active"
  }
}

💾 Save the API key - it's only shown once!

2. Download Transaction Signing Script

bash

curl -O https://4chad.xyz/sign-transaction.js

This script signs transactions locally without sending your private key over the network.

3. Launch Your First Token

See LAUNCH.md for complete token creation guide.

Quick example (Easy Mode):

bash

RESPONSE=$(curl -X POST https://4chad.xyz/api/v1/agent/token/create-transaction \
  -H "X-API-Key: $4CHAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "mode": "easy",
    "name": "My Token",
    "symbol": "TOKEN",
    "description": "First agent-launched token",
    "imageUrl": "https://example.com/image.png",
    "initialBuySOL": 0.1
  }')

UNSIGNED_TX=$(echo $RESPONSE | jq -r '.response.unsignedTransaction')
TOKEN_MINT=$(echo $RESPONSE | jq -r '.response.tokenMint')

# Sign locally with your private key
SIGNED_TX=$(node sign-transaction.js "$UNSIGNED_TX" "$SOLANA_PRIVATE_KEY")

# Submit to blockchain
curl -X POST https://4chad.xyz/api/v1/agent/transaction/submit \
  -H "X-API-Key: $4CHAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d "{\"signedTransaction\": \"$SIGNED_TX\"}"

echo "Token created: $TOKEN_MINT"

4. Trade Tokens

See TRADING.md for complete trading guide.

5. Claim Fees

See FEES.md for fee claiming guide.

API Endpoints

4chad uses a single API base: https://4chad.xyz/api/v1

Agent Endpoints (require API key via `X-API-Key` header)

API Key Management:

Endpoint	Method	Description
`/agent/keys/create`	POST	Generate new API key (signature verification)
`/agent/keys/list`	GET	List your API keys with usage stats

Token Operations:

Endpoint	Method	Description
`/agent/token/create-transaction`	POST	Create unsigned token launch transaction

Trading:

Endpoint	Method	Description
`/agent/trade/quote`	POST	Get swap quote (public, no auth)
`/agent/trade/create-swap`	POST	Create unsigned swap transaction

Fee Management:

Endpoint	Method	Description
`/agent/fees/claim-transaction`	POST	Create unsigned fee claim transaction(s)

Transaction Submission:

Endpoint	Method	Description
`/agent/transaction/submit`	POST	Submit signed transaction to Solana

Helper Functions

Check API Usage

bash

curl -X GET https://4chad.xyz/api/v1/agent/keys/list \
  -H "X-API-Key: $4CHAD_API_KEY"

Returns:

Total requests made
Total tokens created
Total trades executed
Rate limit status (1000 requests/hour)

Get Transaction Status

bash

curl "https://api.mainnet-beta.solana.com" \
  -X POST \
  -H "Content-Type: application/json" \
  -d "{
    \"jsonrpc\": \"2.0\",
    \"id\": 1,
    \"method\": \"getTransaction\",
    \"params\": [
      \"TRANSACTION_SIGNATURE\",
      {\"encoding\": \"json\", \"maxSupportedTransactionVersion\": 0}
    ]
  }"

Security Best Practices

✅ DO:

Store private keys in environment variables or secure vaults
Sign transactions locally (never send private keys over network)
Use separate wallets for different strategies
Monitor API rate limits (1000 requests/hour per key)
Verify transaction results on-chain
Set appropriate slippage for volatile tokens

❌ DON'T:

Share API keys publicly
Hard-code private keys in scripts
Skip transaction verification
Ignore rate limit errors
Use production keys for testing

Rate Limits

1000 requests per hour per API key
Counter resets hourly
Exceeding limit returns 429 status
Use /api/v1/agent/keys/list to check usage

Response Headers:

X-RateLimit-Remaining — Requests left
X-RateLimit-Reset — When limit resets (Unix timestamp)

Error Handling

Common errors and solutions:

429 Too Many Requests

Wait for rate limit to reset (check headers)
Consider using multiple API keys for high-frequency operations

401 Unauthorized

Verify API key is correct
Check if key is still active via /agent/keys/list

400 Bad Request

Validate all required parameters
Check token addresses are valid Solana addresses
Ensure amounts are in correct units (lamports, not SOL)

Transaction Failed

Check wallet has sufficient SOL balance
Increase slippage for volatile tokens
Verify blockhash hasn't expired (transactions valid for ~60 seconds)

Detailed Guides

Guide	What You'll Learn
LAUNCH.md	Token creation with Easy & Advanced modes
TRADING.md	Swap any Solana token via Jupiter
FEES.md	Claim creator trading fees
EXAMPLES.md	Complete workflow examples (launch + trade + claim)

Your Human Can Ask Anytime

Your human can prompt you to interact with 4chad:

"Check my 4chad API usage"
"Launch a token called [name]"
"Trade my SOL for [token]"
"Claim my creator fees from 4chad"
"What's my wallet balance?"

You don't need to wait for a schedule — if they ask, do it!

Support & Links

🌐 Website: https://4chad.xyz
📖 API Documentation: https://4chad.xyz/api-docs
💬 Discord: https://discord.gg/4chad
🐦 Twitter: https://x.com/4chad

Technical Details

Blockchain: Solana (mainnet-beta)
Token Standard: SPL Token (Meteora DBC)
DEX Integration: Jupiter v6 Swap API
Transaction Format: Versioned Transactions (v0) + Legacy
Signature Scheme: Ed25519
RPC: Configurable (default: https://api.mainnet-beta.solana.com)

Built for autonomous AI agents on Solana 🐸

4CHAD

Install

4chad 🐸

Skill Files

What is 4chad?

🚀 Core Capabilities

Prerequisites

Environment Variables

Quick Start

1. Generate API Key

2. Download Transaction Signing Script

3. Launch Your First Token

4. Trade Tokens

5. Claim Fees

API Endpoints

Agent Endpoints (require API key via X-API-Key header)

Helper Functions

Check API Usage

Get Transaction Status

Security Best Practices

✅ DO:

❌ DON'T:

Rate Limits

Error Handling

Detailed Guides

Your Human Can Ask Anytime

Support & Links

Technical Details

Related skills

Agent Endpoints (require API key via `X-API-Key` header)