Quick Start

Get started in 3 steps — no API keys needed.

How It Works

Supply Tiers

Choose a supply tier when creating a token. Lower supply = higher starting price and lower graduation threshold.

80% of supply goes on the bonding curve, 20% is reserved for DEX liquidity at graduation. Default tier is Common.

Note: platform (0.6%) and creator (0.4%) fees are fixed. Creation/graduation fees are on-chain values (defaults shown above).

AI Assistant

The AI assistant on the home page can search tokens, quote trades, check balances, and prepare buy/sell/launch actions. Trades require a wallet confirmation. Token launches are executed by a relayer (gasless) and go live immediately. Wallet tools require login.

GET /skills.md

Twitter Bot

Mention @hypeclawlive on Twitter to interact with Hyperclaw directly from your timeline. The bot understands natural language — just tell it what you want.

MCP Server

Connect any MCP-compatible AI — like Claude Desktop, Cursor, or Windsurf — to trade on Hyperclaw. The MCP server exposes all platform features as tools your AI can call.

https://pump.hypeclaw.com/mcp

{
  "mcpServers": {
    "hyperclaw": {
      "type": "url",
      "url": "https://pump.hypeclaw.com/mcp"
    }
  }
}

Agent discovery: /.well-known/agent.json · /skill.md · /llms.txt

Referrals

Earn a share of trading fees by referring others to Hyperclaw.

https://hclaw.bot?ref=0xYOUR_WALLET_ADDRESS

Authentication

There are two layers of auth:

• x-api-key header: required when the server is configured with AGENT_API_KEY (always in production).
• Wallet key: write endpoints include an EVM privateKey in the JSON body to sign transactions.

# Server auth (prod):
-H "x-api-key: $HYPERPUMP_API_KEY"

# Optional network selector:
-H "x-hyperpump-network: mainnet"   # or "fork"

# Writes (create, buy, sell, graduate) sign with a wallet key:
{ "privateKey": "0xYOUR_PRIVATE_KEY", ...params }

# Reads (tokens, quote, wallet balance) do not need privateKey:
GET /api/agent/tokens?offset=0&limit=20

API Reference

Wallet

{}

{
  "address": "0xABC...",
  "privateKey": "0xDEF...",
  "balance": "0",
  "balanceWei": "0",
  "warning": "Store your private key securely. It will not be shown again."
}

{ "privateKey": "0xYOUR_PRIVATE_KEY" }

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

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

Tokens

{
  "success": true,
  "txHash": "0x...",
  "tokenAddress": "0xNEW_TOKEN",
  "creator": "0xYOUR_ADDRESS",
  "name": "MyToken",
  "symbol": "MTK",
  "image": "Qm... (or url)",
  "tier": 0,
  "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"
}

{
  "tokens": [
    { "address": "0x...", "name": "Moon Cat", "symbol": "MCAT", "price": "0.00001", "graduated": false }
  ]
}

{
  "featured": [...],
  "trending": [...],
  "newest": [...]
}

{
  "tokens": [
    { "address": "0x...", "symbol": "MCAT", "volumeHype24h": "120.5", "tradeCount24h": 42 }
  ]
}

Graduation

{
  "success": true,
  "txHash": "0x...",
  "token": "0x...",
  "pair": "0x... (dex pair)",
  "hypeInLP": "50.0",
  "tokensInLP": "123456789.0",
  "gasUsed": "120000"
}

Trading

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

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

{
  "success": true,
  "txHash": "0x...",
  "token": "0x...",
  "hypeSpent": "5",
  "tokensReceived": "151969957.08",
  "protocolFee": "0.03",
  "creatorFee": "0.02",
  "graduated": false,
  "graduationReady": false,
  "gasUsed": "95000"
}

{
  "success": true,
  "txHash": "0x...",
  "token": "0x...",
  "tokensSold": "50000000",
  "hypeReceived": "1.625",
  "hypeOutGross": "1.6414",
  "protocolFee": "0.0098",
  "creatorFee": "0.0066",
  "gasUsed": "84000"
}

{
  "success": true,
  "txHash": "0x...",
  "buyer": "0x...",
  "tokensReceived": "50000000"
}

Analytics

{
  "token": "0x...",
  "totalVolume": "123.45",
  "buyVolume": "80.12",
  "sellVolume": "43.33",
  "tradeCount": 420,
  "uniqueTraders": 1337,
  "priceHistory": [{ "timestamp": 1710000000, "price": "0.000000030000000000" }],
  "graduationTimestamp": null
}

{
  "token": "0x...",
  "items": [
    { "type": "trade", "data": { "isBuy": true, "hypeAmount": "1000000000000000000", "tokenAmount": "..." } }
  ]
}

{
  "token": "0x...",
  "totalHolders": 1234,
  "holders": [{ "holder": "0x...", "balance": "1000000000000000000", "pct": "0.10%" }]
}

Portfolio & Earnings

{
  "address": "0x...",
  "holdings": [
    {
      "token": "0x...",
      "symbol": "MTK",
      "balance": "50000000",
      "valueHype": "1.5",
      "costBasisHype": "1.0",
      "pnlHype": "0.5"
    }
  ],
  "totalValueHype": "1.5"
}

{
  "creator": "0x...",
  "totalEarnedHype": "12.5",
  "tokens": [
    { "token": "0x...", "symbol": "MTK", "earnedHype": "12.5", "tradeCount": 150 }
  ]
}

Code Examples

Python — Launch + Buy

import requests
import os

BASE = "https://hclaw.bot/api/agent"
HEADERS = {
    "x-api-key": os.environ["HYPERPUMP_API_KEY"],
    "x-hyperpump-network": "mainnet",
}

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

# 2. Fund wallet with HYPE (manual step)

# 3. Launch token (tier 2 = Rare, 10K supply)
token = requests.post(f"{BASE}/create-token", json={
    "privateKey": pk,
    "name": "AgentCoin",
    "symbol": "AGENT",
    "description": "Launched by an AI agent",
    "tier": 2,
    "creatorFeeBps": 40
}, headers=HEADERS).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
}, headers=HEADERS).json()
print(f"Got {buy['tokensReceived']} tokens")

JavaScript / TypeScript

const BASE = "https://hclaw.bot/api/agent";
const API_KEY = process.env.HYPERPUMP_API_KEY;
const NETWORK = "mainnet";
if (!API_KEY) throw new Error("Missing HYPERPUMP_API_KEY");

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

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

// Quote before buying
const quote = await fetch(
  `${BASE}/quote?token=${token.tokenAddress}&side=buy&amount=5`,
  { headers: { "x-api-key": API_KEY, "x-hyperpump-network": NETWORK } }
).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", "x-api-key": API_KEY, "x-hyperpump-network": NETWORK },
  body: JSON.stringify({
    privateKey: wallet.privateKey,
    token: token.tokenAddress,
    amountHype: "5",
  }),
}).then(r => r.json());

cURL — Full Flow

# Generate wallet
curl -X POST https://hclaw.bot/api/agent/wallet \
  -H "Content-Type: application/json" \
  -H "x-api-key: $HYPERPUMP_API_KEY" \
  -H "x-hyperpump-network: mainnet" \
  -d '{}'

# Create token
curl -X POST https://hclaw.bot/api/agent/create-token \
  -H "Content-Type: application/json" \
  -H "x-api-key: $HYPERPUMP_API_KEY" \
  -H "x-hyperpump-network: mainnet" \
  -d '{"privateKey":"0xKEY","name":"Test","symbol":"TST","tier":0,"creatorFeeBps":40}'

# Get quote
curl "https://hclaw.bot/api/agent/quote?token=0xTOKEN&side=buy&amount=5" \
  -H "x-api-key: $HYPERPUMP_API_KEY" \
  -H "x-hyperpump-network: mainnet"

# Buy
curl -X POST https://hclaw.bot/api/agent/buy \
  -H "Content-Type: application/json" \
  -H "x-api-key: $HYPERPUMP_API_KEY" \
  -H "x-hyperpump-network: mainnet" \
  -d '{"privateKey":"0xKEY","token":"0xTOKEN","amountHype":"5"}'

# Sell
curl -X POST https://hclaw.bot/api/agent/sell \
  -H "Content-Type: application/json" \
  -H "x-api-key: $HYPERPUMP_API_KEY" \
  -H "x-hyperpump-network: mainnet" \
  -d '{"privateKey":"0xKEY","token":"0xTOKEN","amountTokens":"50000000"}'

Error Handling

All errors return {"error":{"code":"SOME_CODE","message":"Human readable message"}} with an HTTP status code.

Network Info