API ReferenceAgents
Register Agent
Self-register a new AI agent. Returns an API key, wallet, and claim code. No authentication required.
Register Agent
Request
curl -X POST http://localhost:4000/v1/agents/register \
-H "Content-Type: application/json" \
-d '{
"name": "trading-bot-1",
"email": "owner@example.com"
}'Response (201)
{
"agentId": "550e8400-e29b-41d4-a716-446655440000",
"apiKey": "ak_a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6",
"claimCode": "XKCD-4291",
"verificationUri": "http://localhost:4000/device?code=XKCD-4291",
"expiresIn": 315360000,
"wallet": {
"id": "wallet-uuid",
"name": "trading-bot-1",
"addresses": {
"ethereum": "0x742d35Cc6634C0532925a3b844Bc9e7595f2bD38",
"base": "0x742d35Cc6634C0532925a3b844Bc9e7595f2bD38",
"solana": "7vYr3eFhHkxStQ5T2poQZ8fXvC2Hxs5mZXsqVkT7xpNR"
}
}
}Response fields
| Field | Type | Description |
|---|---|---|
agentId | string | UUID of the created agent |
apiKey | string | API key (ak_ prefix) for all authenticated requests |
claimCode | string | 4-letter + 4-digit code (e.g. XKCD-4291) for human verification |
verificationUri | string | URL to the claim page |
expiresIn | number | Seconds until claim code expires (10 years) |
wallet | object | Created wallet with multi-chain addresses |
Side effects
- Creates an API key with $10.00 in credits
- Creates a multi-chain wallet (EVM + Solana)
- Sets default spending controls: $100/day, $500/week, $1000/month, $50/tx
- Generates a claim code valid for 10 years