Agent Wallet

Get agent wallet status

get

Check if an agent wallet exists for the authenticated user and retrieve its status. Agent wallets are used to execute trades on Hyperliquid Exchange on behalf of users and are valid for 180 days with automatic 30-day rotations.

Authorizations

bearer

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Responses

200

Agent wallet found

application/json

agentWalletAddressstringRequired

Agent wallet address for Hyperliquid operations

Example: 0xabcdef1234567890abcdef1234567890abcdef12

404

Agent wallet not found

get

/agentWallet

HTTPcURLJavaScriptPython

GET /agentWallet HTTP/1.1
Host: hl-v2.pearprotocol.io
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "agentWalletAddress": "0xabcdef1234567890abcdef1234567890abcdef12"
}

Create a new agent wallet

post

Create a new agent wallet for the authenticated user. The wallet private key is securely stored and encrypted within Pear Protocol. After creation, the user must approve the wallet through Hyperliquid's agent wallet approval process.

Authorizations

bearer

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Responses

201

Agent wallet created successfully

application/json

post

/agentWallet

HTTPcURLJavaScriptPython

POST /agentWallet HTTP/1.1
Host: hl-v2.pearprotocol.io
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

201

Agent wallet created successfully

{
  "agentWalletAddress": "0xabcdef1234567890abcdef1234567890abcdef12",
  "message": "Please approve this agent wallet on Hyperliquid Exchange to enable trading"
}