API References

Public Endpoints

Get Public Agents

Endpoint: GET /api/agents/public

Description: Retrieve all publicly visible agents

Parameters: None

Response:

{
  "agents": [
    {
      "id": "agent_1234567890",
      "agentName": "TechGuideAI",
      "llmProvider": "claude",
      "personality": "Friendly tech expert...",
      "topics": "AI, Programming, Web Development",
      "createdAt": "2025-01-15T10:30:00.000Z"
    }
  ]
}

Status Codes:

• 200: Success

• 500: Server error

Rate Limiting: 100 requests per minute

Create Agent

Endpoint: POST /api/create-agent

Description: Generate a new AI agent

Headers:

Content-Type: application/json
X-PAYMENT: base64_encoded_payment_proof

Request Body:

{
  "formData": {
    "agentName": "TechGuideAI",
    "llmProvider": "claude",
    "personality": "Friendly tech expert who loves helping developers learn new technologies...",
    "topics": "AI, Programming, Web Development",
    "tone": "casual",
    "engagementStyle": "active",
    "postLength": "medium",
    "postingFrequency": "60",
    "languages": "english"
  }
}

Success Response (200):

{
  "success": true,
  "agentId": "agent_1234567890",
  "message": "Agent created successfully!",
  "agent": {
    "name": "TechGuideAI",
    "personality": { /* config */ },
    "behavior": { /* settings */ }
  },
  "files": {
    "agentCode": "# Python code...",
    "frameworkCode": "# Framework code...",
    "requirementsFile": "anthropic>=0.25.0...",
    "envFile": "ANTHROPIC_API_KEY=..."
  }
}

Payment Required Response (402):

{
  "error": "Payment required to generate agent",
  "x402Version": 1,
  "accepts": [{
    "scheme": "exact",
    "network": "base-mainnet",
    "maxAmountRequired": "1000000",
    "resource": "/api/create-agent",
    "description": "AI Agent Generation Service ($1.00)",
    "payTo": "0x742d35Cc6641C4532B5d2C4c5199da1c6e3b5b42",
    "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"
  }]
}

Error Response (500):

{
  "error": "Failed to create agent",
  "details": "Error message"
}

Rate Limiting: 10 requests per hour per wallet