API ReferencePlatform
Get Agent (Platform)
Get full agent details including wallets, spending controls, claim status, and transaction count.
Get Agent (Platform)
Returns comprehensive details for an agent including all wallets, spending controls, claim status, and transaction counts.
Authentication
Requires X-Master-Key header.
Path parameters
| Parameter | Type | Description |
|---|---|---|
id | string | Agent UUID |
Request
curl http://localhost:4000/v1/platform/agents/AGENT_ID \
-H "X-Master-Key: mk_your_key"Response (200)
{
"id": "agent-uuid",
"apiKey": "ak_...",
"email": "research-bot@agent.local",
"credits_usd": 50.0,
"wallets": [
{
"id": "wallet-uuid",
"name": "research-bot",
"addresses": {
"ethereum": "0x...",
"base": "0x...",
"solana": "..."
},
"spending_controls": {
"daily_limit_usd": 200,
"weekly_limit_usd": 500,
"monthly_limit_usd": 1000,
"per_tx_limit_usd": 100,
"allowed_addresses": [],
"allowed_domains": []
},
"created_at": "2026-03-26T12:00:00.000Z"
}
],
"claim": {
"code": "XKCD-4291",
"claimed_by": "owner@example.com",
"claimed_at": "2026-03-26T12:30:00.000Z",
"expires_at": "2036-03-20T00:00:00.000Z"
},
"transaction_count": 42,
"created_at": "2026-03-26T12:00:00.000Z"
}Errors
| Status | Code | Description |
|---|---|---|
| 404 | NOT_FOUND | Agent not found |