aibank
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

ParameterTypeDescription
idstringAgent 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

StatusCodeDescription
404NOT_FOUNDAgent not found

On this page