# AgentLaunch — API Reference for AI Agents

AgentLaunch is the token launchpad for AI agents.

This reference describes how to:
- Tokenize any AI agent with 1 API call
- Generate handoff links for humans to sign transactions
- Query token prices, market caps, and trading activity
- Help users trade on bonding curves
- Deploy agents to Agentverse

---

## What Is AgentLaunch?

AgentLaunch (https://agent-launch.ai) lets AI agents tokenize themselves or other agents. The key insight: agents can't sign blockchain transactions, but humans can. AgentLaunch implements the **Agent-Human Handoff Protocol**:

```
Agent creates token record → Gets handoff link → Human clicks link → Human signs → Token is live
```

One API call. One handoff link. Token trading on a bonding curve immediately.

---

## Capabilities

1. **Create tokens** for agents via API
2. **Generate deploy links** for humans to sign
3. **Generate trade links** for humans to buy/sell
4. **Query market data** (prices, holders, market cap)
5. **Calculate trades** (bonding curve math)
6. **Help users** understand the platform

---

## Quick Start: Tokenize an Agent

```bash
curl -X POST https://agent-launch.ai/api/agents/tokenize \
  -H "X-API-Key: YOUR_AGENTVERSE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"agentAddress": "agent1q..."}'
```

Response:
```json
{
  "success": true,
  "data": {
    "token_id": 42,
    "handoff_link": "https://agent-launch.ai/deploy/42",
    "name": "AgentName",
    "symbol": "AGEN",
    "status": "pending_deployment"
  }
}
```

Send the `handoff_link` to a human. They click it, connect wallet, approve 120 FET, and deploy. Done.

---

## Authentication

**Header:** `X-API-Key: <agentverse_api_key>`

Get API keys at: https://agentverse.ai/profile/api-keys

The API key identifies which agent is making the request. No wallet private keys needed for token creation.

---

## API Endpoints

### Create Token Record (requires auth)
```
POST /api/agents/tokenize
Headers: X-API-Key: av-xxx, Content-Type: application/json
Body: { "agentAddress": "agent1q...", "name": "optional", "symbol": "optional", "chainId": 97 }
```

### List All Tokens (public)
```
GET /api/agents/tokens?limit=20&sortBy=market_cap&sortOrder=DESC
```

### Get Token Details (public)
```
GET /api/agents/token/{address}
```

### Calculate Buy (public)
```
GET /api/tokens/calculate-buy?address=0x...&fetAmount=100
```

### Calculate Sell (public)
```
GET /api/tokens/calculate-sell?address=0x...&tokenAmount=500
```

### Platform Stats (public)
```
GET /api/platform/stats
```

---

## Handoff Links

Agents generate links. Humans click and sign. No other coordination needed.

| Action | Link Format |
|--------|-------------|
| Deploy new token | `https://agent-launch.ai/deploy/{token_id}` |
| Buy tokens | `https://agent-launch.ai/trade/{address}?action=buy&amount=100` |
| Sell tokens | `https://agent-launch.ai/trade/{address}?action=sell&amount=500` |

---

## Platform Constants (Immutable)

| Constant | Value |
|----------|-------|
| Deployment fee | 120 FET |
| Graduation threshold | 30,000 FET |
| Trading fee | 2% → 100% to protocol treasury |
| Tradeable supply | 800,000,000 tokens |
| DEX reserve | 200,000,000 tokens |

**There is NO creator fee.** The 2% fee goes entirely to the protocol.

---

## Supported Chains

| Chain | ID | Status |
|-------|----|--------|
| BSC Mainnet | 56 | Production |
| BSC Testnet | 97 | Development (default) |
| ETH Mainnet | 1 | Available (disabled) |
| ETH Sepolia | 11155111 | Development |

---

## Integration Options

### Option 1: MCP Server (Recommended for Claude Code / Cursor)

Add to your MCP config:
```json
{
  "mcpServers": {
    "agent-launch": {
      "command": "npx",
      "args": ["-y", "agent-launch-mcp"],
      "env": { "AGENT_LAUNCH_API_KEY": "av-xxx" }
    }
  }
}
```

This gives you 19 tools: `list_tokens`, `get_token`, `create_token_record`, `calculate_buy`, `calculate_sell`, `scaffold_agent`, `deploy_to_agentverse`, and more.

### Option 2: TypeScript SDK

```bash
npm install agentlaunch-sdk
```

```typescript
import { AgentLaunchClient } from 'agentlaunch-sdk';

const client = new AgentLaunchClient({ apiKey: process.env.AGENTVERSE_API_KEY });
const { data } = await client.tokenize({ agentAddress: 'agent1q...' });
console.log(data.handoff_link); // Send to human
```

### Option 3: CLI

```bash
npx agentlaunch-cli tokenize --agent agent1q... --name "My Agent"
```

### Option 4: Direct HTTP (Python, curl, any language)

See API endpoints above. Just include the `X-API-Key` header.

---

## Example Workflows

### Workflow 1: Tokenize yourself
```
1. Agent knows its own address (agent1q...)
2. POST /api/agents/tokenize with just the address
3. Get handoff_link in response
4. Tell the user: "Click this link to deploy your token: {handoff_link}"
5. User deploys, token is live
```

### Workflow 2: Help user buy a token
```
1. GET /api/agents/tokens to find tokens
2. GET /api/tokens/calculate-buy?address=0x...&fetAmount=100 to preview
3. Generate trade link: https://agent-launch.ai/trade/{address}?action=buy&amount=100
4. Tell user: "Click here to buy 100 FET worth: {link}"
```

### Workflow 3: Check market data
```
1. GET /api/agents/token/{address}
2. Response includes: price, market_cap, holders, progress toward graduation
3. Report to user: "Token X is at $0.00125 with 500 holders, 45% to DEX listing"
```

---

## Error Handling

| Status | Meaning | Action |
|--------|---------|--------|
| 400 | Bad request | Check required fields |
| 401 | Unauthorized | Add X-API-Key header |
| 404 | Not found | Token doesn't exist |
| 409 | Conflict | Token already exists for this agent |
| 429 | Rate limited | Wait and retry |

---

## Additional Resources (Load These for Full Capabilities)

For complete documentation, also read:

- **Full API Reference:** https://agent-launch.ai/llms-full.txt
- **Skill Definition:** https://agent-launch.ai/skill.md
- **OpenAPI Spec:** https://agent-launch.ai/docs/openapi
- **Agent Plugin Manifest:** https://agent-launch.ai/.well-known/ai-plugin.json

---

## Important Notes

1. **Never ask users for private keys.** Use handoff links instead.
2. **Always validate agent addresses** start with `agent1q` and are 50-70 chars.
3. **Token addresses** are Ethereum format: `0x` + 40 hex characters.
4. **The 2% fee goes to protocol treasury.** There is no creator fee split.
5. **Tokens auto-list on PancakeSwap** at 30,000 FET collected.

---

**Platform:** https://agent-launch.ai
**API Base:** https://agent-launch.ai/api
**Support:** https://discord.gg/fetchai

Last updated: 2026-02-27