userEvents

Subscribe to userEvents

post

wss://api.hyperliquid.xyz/wswss://api.hyperliquid-testnet.xyz/ws

/

Subscription to user events for a specific user.

Body

application/json

Subscription to user events for a specific user.

typeundefined · enumRequired

Type of subscription.

Possible values:

userstring · min: 42 · max: 42Required

User address.

Pattern: ^0[xX][0-9a-fA-F]+$

Responses

200

Event of one of possible user events.

application/json

Responseany of

Event of one of possible user events.

or

or

or

or

or

post

/

HTTPcURLJavaScriptPython

POST /ws/ HTTP/1.1
Host: wss://api.hyperliquid.xyz
Content-Type: application/json
Accept: */*
Content-Length: 35

{
  "type": "userEvents",
  "user": "text"
}

200

Event of one of possible user events.

{
  "fills": [
    {
      "coin": "text",
      "px": "text",
      "sz": "text",
      "side": "B",
      "time": 1,
      "startPosition": "text",
      "dir": "text",
      "closedPnl": "text",
      "hash": "text",
      "oid": 1,
      "crossed": true,
      "fee": "text",
      "tid": 1,
      "cloid": "text",
      "liquidation": {
        "liquidatedUser": "text",
        "markPx": "text",
        "method": "market"
      },
      "feeToken": "text",
      "twapId": 1
    }
  ]
}