API ReferencePlatform
List Agents (Platform)
List all agents with pagination.
List Agents (Platform)
Returns a paginated list of all agents in the system.
Authentication
Requires X-Master-Key header.
Query parameters
| Parameter | Type | Default | Description |
|---|---|---|---|
limit | number | 50 | Max results (max 200) |
offset | number | 0 | Pagination offset |
Request
curl "http://localhost:4000/v1/platform/agents?limit=10" \
-H "X-Master-Key: mk_your_key"Response (200)
{
"agents": [
{
"id": "agent-uuid",
"apiKey": "ak_...",
"email": "research-bot@agent.local",
"credits_usd": 50.0,
"wallet": {
"id": "wallet-uuid",
"name": "research-bot",
"addresses": {
"ethereum": "0x...",
"base": "0x...",
"solana": "..."
}
},
"created_at": "2026-03-26T12:00:00.000Z"
}
],
"pagination": {
"total": 25,
"limit": 10,
"offset": 0,
"has_more": true
}
}