userFills

Subscribe to userFills

post

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

/

Subscription to user fill events for a specific user.

Body

application/json

Subscription to user fill 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]+$

aggregateByTimebooleanOptional

If true, partial fills are aggregated when a crossing order fills multiple resting orders.

Responses

200

Event of user trade fill.

application/json

post

/

HTTPcURLJavaScriptPython

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

{
  "type": "userFills",
  "user": "text",
  "aggregateByTime": true
}

200

Event of user trade fill.

{
  "user": "text",
  "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
    }
  ],
  "isSnapshot": true
}