Skip to main content

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.

​
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

[
  {
    "address": "0xabcd...",
    "name": "trading-bot-1",
    "validUntil": 1776200000
  }
]
Empty array [] if the wallet has no registered agents.
FieldTypeDescription
addressstringAgent wallet address
namestringAgent name (unnamed agents can be replaced on re-registration)
validUntilnumberExpiry 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

curl -H "x-api-key: YOUR_KEY" "https://hyper.polynode.dev/v2/user/agents?address=0x..."