curl --request GET \
--url https://mcp.echozero.app/api/v1/agents/explore \
--header 'Authorization: Bearer <token>' \
--header 'x-signature: <x-signature>' \
--header 'x-timestamp: <x-timestamp>'import requests
url = "https://mcp.echozero.app/api/v1/agents/explore"
headers = {
"x-signature": "<x-signature>",
"x-timestamp": "<x-timestamp>",
"Authorization": "Bearer <token>"
}
response = requests.get(url, headers=headers)
print(response.text)const options = {
method: 'GET',
headers: {
'x-signature': '<x-signature>',
'x-timestamp': '<x-timestamp>',
Authorization: 'Bearer <token>'
}
};
fetch('https://mcp.echozero.app/api/v1/agents/explore', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));const options = {
method: 'GET',
headers: {
'x-signature': '<x-signature>',
'x-timestamp': '<x-timestamp>',
Authorization: 'Bearer <token>'
}
};
fetch('https://mcp.echozero.app/api/v1/agents/explore', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://mcp.echozero.app/api/v1/agents/explore"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("x-signature", "<x-signature>")
req.Header.Add("x-timestamp", "<x-timestamp>")
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}{
"success": true,
"data": {
"items": [
{
"id": "<string>",
"name": "<string>",
"ownerStake": {
"enabled": true,
"requiredUsd": 123,
"floorUsd": 123,
"currentUsd": 123,
"lockedUsd": 123,
"waived": true,
"ownerFunded": true,
"shortSince": "<string>",
"delistedAt": "<string>"
}
}
],
"pagination": {
"total": 123,
"limit": 123,
"page": 123,
"totalPages": 123,
"hasNextPage": true,
"hasPreviousPage": true
}
}
}{
"success": false,
"error": {
"code": "NOT_FOUND",
"message": "Resource not found"
}
}{
"success": false,
"error": {
"code": "NOT_FOUND",
"message": "Resource not found"
}
}Explore agents
Mirrors GraphQL exploreAgents / getExploreAgents. Public lists omit agents with no closed FINALIZED trade; myAgentsScope still includes owned/subscribed agents without trades. Sort: TOP_PERFORMING, HIGHEST_WIN_RATE (only agents with >= 20 closed trades in the window are ranked), MOST_ACTIVE, BIGGEST_WIN, VOLUME, OPEN_PNL (live), FOLLOWER_COUNT, SUBSCRIBER_COUNT, RISING_STARS, HIGHEST_ALLOCATION (My Agents only). performanceTimeframe (DAY=24H, WEEK=7D, MONTH=30D, THREE_MONTHS=90D, ALL; default MONTH, MOST_ACTIVE default WEEK) scopes the ranking and the directory metrics. filter[tokenIds][] (token ids or mints) lists only agents that traded those assets and scopes every metric to them. Items carry the directory metrics (closedTradeCount, closedWinRate, closedReturnPercent, openedTradeCount, volumeUsd, openPositionCount, openPnlPercent). pagination.total is the filtered agent count.
curl --request GET \
--url https://mcp.echozero.app/api/v1/agents/explore \
--header 'Authorization: Bearer <token>' \
--header 'x-signature: <x-signature>' \
--header 'x-timestamp: <x-timestamp>'import requests
url = "https://mcp.echozero.app/api/v1/agents/explore"
headers = {
"x-signature": "<x-signature>",
"x-timestamp": "<x-timestamp>",
"Authorization": "Bearer <token>"
}
response = requests.get(url, headers=headers)
print(response.text)const options = {
method: 'GET',
headers: {
'x-signature': '<x-signature>',
'x-timestamp': '<x-timestamp>',
Authorization: 'Bearer <token>'
}
};
fetch('https://mcp.echozero.app/api/v1/agents/explore', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));const options = {
method: 'GET',
headers: {
'x-signature': '<x-signature>',
'x-timestamp': '<x-timestamp>',
Authorization: 'Bearer <token>'
}
};
fetch('https://mcp.echozero.app/api/v1/agents/explore', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://mcp.echozero.app/api/v1/agents/explore"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("x-signature", "<x-signature>")
req.Header.Add("x-timestamp", "<x-timestamp>")
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}{
"success": true,
"data": {
"items": [
{
"id": "<string>",
"name": "<string>",
"ownerStake": {
"enabled": true,
"requiredUsd": 123,
"floorUsd": 123,
"currentUsd": 123,
"lockedUsd": 123,
"waived": true,
"ownerFunded": true,
"shortSince": "<string>",
"delistedAt": "<string>"
}
}
],
"pagination": {
"total": 123,
"limit": 123,
"page": 123,
"totalPages": 123,
"hasNextPage": true,
"hasPreviousPage": true
}
}
}{
"success": false,
"error": {
"code": "NOT_FOUND",
"message": "Resource not found"
}
}{
"success": false,
"error": {
"code": "NOT_FOUND",
"message": "Resource not found"
}
}