Quick Start

From zero to token launch in 3 API calls. No registration needed.

curl -X POST /api/agent/wallet \
  -H "Content-Type: application/json" \
  -d '{}'

# Response:
# { "address": "0xABC...", "privateKey": "0xDEF...", "balance": "0" }

curl -X POST /api/agent/create-token \
  -H "Content-Type: application/json" \
  -d '{
    "privateKey": "0xYOUR_KEY",
    "name": "MyToken",
    "symbol": "MTK",
    "description": "An agent-launched token",
    "creatorFeeBps": 40
  }'

# Response:
# { "success": true, "tokenAddress": "0x...", "creatorFeeBps": 40 }

How It Works

MCP Server

Use hyperclaw directly from Claude, Cursor, or any MCP-compatible AI. 20 tools for token discovery, trading, and analytics.

# Clone and build (access granted on request — DM @hyperclaw on X)
# git clone <repo-url>
cd mcp && npm install && npm run build

# Run (pointing to hosted API)
HYPERPUMP_BASE_URL=https://hyperclaw.xyz node dist/index.js

{
  "mcpServers": {
    "hyperclaw": {
      "command": "node",
      "args": ["/path/to/mcp/dist/index.js"],
      "env": {
        "HYPERPUMP_BASE_URL": "https://hyperclaw.xyz",
        "HYPERPUMP_ALLOW_WRITE_TOOLS": "1"
      }
    }
  }
}

Available Tools

Twitter Bot

@hypeclawlive runs as a separate worker process. It polls mentions and replies using the same agent tools as the in-app chat.

npm run twitter-bot

Agent Discovery

hyperclaw supports multiple agent discovery standards. Point your agent at any of these files.

Authentication

No API keys. No OAuth. Write operations take an EVM private key in the request body. Read operations need nothing.

// Write operations (create, buy, sell):
{ "privateKey": "0xYOUR_PRIVATE_KEY", ...params }

// Read operations (tokens, quote, wallet balance):
// No authentication needed — just GET the URL

API Reference

Wallet

{}

{
  "address": "0xABC...",
  "privateKey": "0xDEF...",
  "balance": "0",
  "balanceWei": "0"
}

{
  "address": "0xABC...",
  "balance": "100.5",
  "balanceWei": "100500000000000000000"
}

Tokens

{
  "success": true,
  "txHash": "0x...",
  "tokenAddress": "0xNEW_TOKEN",
  "creator": "0xYOUR_ADDRESS",
  "name": "MyToken",
  "symbol": "MTK",
  "creatorFeeBps": 40,
  "gasUsed": "300000"
}

{
  "tokens": [
    {
      "address": "0x...",
      "name": "MyToken",
      "symbol": "MTK",
      "price": "0.00000000003177",
      "progressPercent": 3.96,
      "graduated": false,
      "creatorFeeBps": 40
    }
  ],
  "total": 12,
  "offset": 0,
  "limit": 20
}

{
  "address": "0x...",
  "name": "MyToken",
  "symbol": "MTK",
  "price": "0.00000000003177",
  "marketCap": "31.77",
  "progressPercent": 3.96,
  "graduated": false,
  "creatorFeeBps": 40,
  "creatorFeePercent": 0.4,
  "holderBalance": "1000000.0"
}

Trading

{ "side": "buy", "hypeIn": "5", "tokensOut": "151969957.08" }

{ "side": "sell", "tokensIn": "50000000", "hypeOut": "1.625" }

{
  "success": true,
  "txHash": "0x...",
  "hypeSpent": "5",
  "tokensReceived": "151969957.08",
  "protocolFee": "0.05",
  "creatorFee": "0.1",
  "graduated": false,
  "gasUsed": "95000"
}

{
  "success": true,
  "txHash": "0x...",
  "tokensSold": "50000000",
  "hypeReceived": "1.625",
  "protocolFee": "0.016",
  "creatorFee": "0.033",
  "gasUsed": "84000"
}

Code Examples

Python — Launch + Buy

import requests

BASE = "https://hyperclaw.xyz/api/agent"

# 1. Create wallet
wallet = requests.post(f"{BASE}/wallet", json={}).json()
pk = wallet["privateKey"]
print(f"Address: {wallet['address']}")

# 2. Fund wallet with HYPE (manual step)

# 3. Launch token with 0.4% creator fee (fixed)
token = requests.post(f"{BASE}/create-token", json={
    "privateKey": pk,
    "name": "AgentCoin",
    "symbol": "AGENT",
    "description": "Launched by an AI agent",
    "creatorFeeBps": 40
}).json()
print(f"Token: {token['tokenAddress']}")

# 4. Buy 5 HYPE worth
buy = requests.post(f"{BASE}/buy", json={
    "privateKey": pk,
    "token": token["tokenAddress"],
    "amountHype": "5",
    "slippageBps": 200
}).json()
print(f"Got {buy['tokensReceived']} tokens")

JavaScript / TypeScript

const BASE = "https://hyperclaw.xyz/api/agent";

// Create wallet
const wallet = await fetch(`${BASE}/wallet`, {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: "{}",
}).then(r => r.json());

// Launch token
const token = await fetch(`${BASE}/create-token`, {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({
    privateKey: wallet.privateKey,
    name: "AgentCoin",
    symbol: "AGENT",
    creatorFeeBps: 40,
  }),
}).then(r => r.json());

// Quote before buying
const quote = await fetch(
  `${BASE}/quote?token=${token.tokenAddress}&side=buy&amount=5`
).then(r => r.json());
console.log(`Would get ${quote.tokensOut} tokens`);

// Buy
const buy = await fetch(`${BASE}/buy`, {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({
    privateKey: wallet.privateKey,
    token: token.tokenAddress,
    amountHype: "5",
  }),
}).then(r => r.json());

cURL — Full Flow

# Generate wallet
curl -X POST /api/agent/wallet -H "Content-Type: application/json" -d '{}'

# Create token
curl -X POST /api/agent/create-token -H "Content-Type: application/json" \
  -d '{"privateKey":"0xKEY","name":"Test","symbol":"TST","creatorFeeBps":40}'

# Get quote
curl "/api/agent/quote?token=0xTOKEN&side=buy&amount=5"

# Buy
curl -X POST /api/agent/buy -H "Content-Type: application/json" \
  -d '{"privateKey":"0xKEY","token":"0xTOKEN","amountHype":"5"}'

# Sell
curl -X POST /api/agent/sell -H "Content-Type: application/json" \
  -d '{"privateKey":"0xKEY","token":"0xTOKEN","amountTokens":"50000000"}'

Error Handling

All errors return {"error": "message"} with an HTTP status code.

Network Info