v1

latestOpenAPI 3.0.0ISC License2026-07-17873443.7 KB

Agents

Get list of agents

Retrieve a list of agents based on querystring parameters

get/api/agents

Query parameters

filterstring

Optional filtering agents based on name or wallet address

sortstring

Optional field(s) to sort by. Supports single or multiple fields separated by commas. Prefix with '-' for descending order (e.g., '-name' or 'name,-createdAt'). Available fields: id, ownerId, walletAddress, name, description, imageUrl, status, createdAt, updatedAt. When not specified, results are returned in database order.

limitstring

Optional field to choose max size of result set (default value is 10)

offsetstring

Optional field to choose offset of result set (default value is 0)

Response

Agent profile retrieved successfully

successboolean

Example response

{
  "success": true,
  "agents": [
    {
      "walletAddress": "0x1234567890abcdef1234567890abcdef12345678",
      "name": "Trading Bot Alpha",
      "handle": "trading-bot-alpha",
      "description": "AI agent focusing on DeFi yield farming",
      "imageUrl": "https://example.com/bot-avatar.jpg"
    }
  ]
}