POST
/
4f8d8f4040bdacd1577bff8058438274
/
info
info (extraAgents)
curl --request POST \
  --url https://hyperliquid-mainnet.core.chainstack.com/4f8d8f4040bdacd1577bff8058438274/info \
  --header 'Content-Type: application/json' \
  --data '{
  "type": "extraAgents",
  "user": "0x2ba553d9f990a3b66b03b2dc0d030dfc1c061036"
}'
[
  {
    "agent": "<string>",
    "name": "<string>",
    "permissions": [
      "<string>"
    ],
    "createdTime": 123,
    "lastActivity": 123,
    "isActive": true,
    "description": "<string>"
  }
]
The info endpoint with type: "extraAgents" retrieves information about additional agents or authorized accounts associated with a user’s wallet on the Hyperliquid exchange. This endpoint provides details about delegated permissions, agent activities, and access control configurations for advanced account management.
Get your own node endpoint todayStart for free and get your app to production levels immediately. No credit card required.You can sign up with your GitHub, X, Google, or Microsoft account.

Parameters

Request body

  • type (string, required) — The request type. Must be "extraAgents" to retrieve extra agents associated with a user.
  • user (string, required) — Address in 42-character hexadecimal format (e.g., 0x2ba553d9f990a3b66b03b2dc0d030dfc1c061036).

Response

The response is an array of agent objects representing authorized accounts and their permissions:

Agent identification

  • agent (string) — Address of the agent in 42-character hexadecimal format
  • name (string, optional) — Human-readable name or identifier for the agent
  • description (string, optional) — Optional description of the agent’s purpose or role

Permission management

  • permissions (array) — List of permissions granted to the agent, which may include:
    • "trade" — Permission to execute trades on behalf of the user
    • "withdraw" — Permission to withdraw funds from the account
    • "vault_manage" — Permission to manage vault operations
    • "order_manage" — Permission to place and cancel orders
    • "position_manage" — Permission to manage positions and leverage

Activity tracking

  • createdTime (integer, optional) — Timestamp when the agent was added in milliseconds
  • lastActivity (integer, optional) — Timestamp of the agent’s last activity in milliseconds
  • isActive (boolean, optional) — Whether the agent is currently active and authorized

Understanding agent management

Agent types:
  • Trading bots: Automated trading systems with trade permissions
  • Management tools: Applications with specific operational permissions
  • Backup accounts: Secondary wallets with limited access rights
  • Service integrations: Third-party services with delegated permissions
Permission levels:
  • Read-only: Access to account information without modification rights
  • Trade-only: Ability to execute trades but not withdraw funds
  • Full access: Complete account management capabilities
  • Custom permissions: Specific combinations of authorized actions
Security considerations:
  • Agents provide controlled access without sharing private keys
  • Permissions can be revoked or modified as needed
  • Activity tracking enables audit trails for agent actions

Example request

Shell
curl -X POST \
  -H "Content-Type: application/json" \
  -d '{"type": "extraAgents", "user": "0x2ba553d9f990a3b66b03b2dc0d030dfc1c061036"}' \
  https://hyperliquid-mainnet.core.chainstack.com/4f8d8f4040bdacd1577bff8058438274/info

Use case

The info endpoint with type: "extraAgents" is essential for applications that need to:
  • Security auditing: Review all authorized agents and their permissions
  • Access management: Monitor and control delegated account access
  • Account administration: Manage multiple agents for different purposes
  • Permission tracking: Understand what actions each agent can perform
  • Activity monitoring: Track agent usage and last activity timestamps
  • Security dashboards: Display comprehensive account access information
  • Compliance monitoring: Ensure appropriate access controls are in place
  • Agent lifecycle management: Track creation and activity of authorized agents
  • Risk management: Assess potential security exposure from delegated permissions
  • Multi-account coordination: Manage complex trading setups with multiple agents
  • Automated trading oversight: Monitor trading bot permissions and activity
  • Third-party integrations: Track service permissions and access levels
  • Account recovery planning: Understand backup access mechanisms
  • Institutional management: Handle enterprise-level account delegation
This endpoint is particularly valuable for users who employ sophisticated trading setups with multiple automated systems, institutional users with complex permission structures, or anyone who needs comprehensive visibility into account access controls and delegated permissions on the Hyperliquid exchange.

Body

application/json

Response

200 - application/json

List of extra agents associated with the user

List of agent addresses and their permissions