Skip to main content
GET
/
api
/
v1
/
agents
/
explore
Explore agents
curl --request GET \
  --url https://mcp.echozero.app/api/v1/agents/explore \
  --header 'Authorization: Bearer <token>'
{
  "success": true,
  "data": {
    "items": [
      {
        "id": "<string>",
        "name": "<string>"
      }
    ],
    "pagination": {
      "total": 123,
      "limit": 123,
      "page": 123,
      "totalPages": 123,
      "hasNextPage": true,
      "hasPreviousPage": true
    }
  }
}

Authorizations

​
Authorization
string
header
required

User JWT access token issued by POST /api/auth/verify or POST /api/auth/social/verify. Routes that accept both auth modes declare api-key and bearer-jwt security schemes.

Headers

​
x-signature
string

HMAC-SHA256 signature: HMAC-SHA256(secretKey, timestamp + METHOD + path + body). Optional -- when omitted, HMAC verification is skipped.

​
x-timestamp
string

Request timestamp in epoch milliseconds. Required when x-signature is provided. Rejected if drift exceeds 5 minutes.

Query Parameters

​
limit
object
​
offset
object
​
order
enum<string>
Available options:
ASC,
DESC
​
orderBy
enum<string>
Available options:
name,
createdAt,
updatedAt
​
sortBy
enum<string>
Available options:
NAME,
CREATED_AT,
UPDATED_AT,
PERFORMANCE,
TOP_PERFORMING,
SUBSCRIBER_COUNT,
RECENTLY_SUBSCRIBED,
HIGHEST_WIN_RATE,
MOST_ACTIVE,
HIGHEST_ALLOCATION
​
sortDirection
enum<string>
Available options:
ASC,
DESC
​
performanceTimeframe
enum<string>

Window for TOP_PERFORMING / PERFORMANCE sort (default MONTH)

Available options:
DAY,
WEEK,
MONTH,
YEAR
​
filter
object

Nested filter (bracket query: filter[field]=...)

Response

Paginated explore agents.

​
success
boolean
required
Example:

true

​
data
object
required

Endpoint-specific payload