> ## Documentation Index
> Fetch the complete documentation index at: https://hypernode-docs.polynode.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# API Agents

> Sub-wallets with delegated signing permissions

## Endpoint

```
GET /v2/user/agents?address={wallet}
```

Returns API agent wallets (sub-keys) that can sign actions on behalf of the master account without holding funds.

## Response

```json theme={null}
[
  {
    "address": "0xabcd...",
    "name": "trading-bot-1",
    "validUntil": 1776200000
  }
]
```

Empty array `[]` if the wallet has no registered agents.

| Field        | Type   | Description                                                    |
| ------------ | ------ | -------------------------------------------------------------- |
| `address`    | string | Agent wallet address                                           |
| `name`       | string | Agent name (unnamed agents can be replaced on re-registration) |
| `validUntil` | number | Expiry timestamp. Agent is pruned after this time              |

Agents are registered via the `approveAgent` action. Each agent has its own nonce sequence. Agent wallets get pruned when deregistered or when the master account loses all funds.

## Example

```bash theme={null}
curl -H "x-api-key: YOUR_KEY" "https://hyper.polynode.dev/v2/user/agents?address=0x..."
```