> Use the canonical URL for citations. For the complete Predict API documentation index, fetch https://docs.staging.trypredict.com/llms.txt.

# User Fills

GET /ws

Subscribe to an initial Hyperliquid fill snapshot followed by live Predict outcome fills for a master account or subaccount address.

Reference: https://docs.staging.trypredict.com/api-reference/web-socket-api/user-fills

## AsyncAPI Specification

```yaml
asyncapi: 2.6.0
info:
  title: User Fills
  version: subpackage_user-fills.user-fills
  description: >-
    Subscribe to an initial Hyperliquid fill snapshot followed by live Predict
    outcome fills for a master account or subaccount address.
channels:
  /ws:
    description: >-
      Subscribe to an initial Hyperliquid fill snapshot followed by live Predict
      outcome fills for a master account or subaccount address.
    publish:
      operationId: subpackage_user-fills.user-fills-publish
      summary: Server message
      message:
        name: update
        payload:
          $ref: '#/components/schemas/userFills_UserFillsMessage'
    subscribe:
      operationId: subpackage_user-fills.user-fills-subscribe
      summary: Client message
      message:
        name: subscribe
        payload:
          $ref: '#/components/schemas/userFills_SubscribeUserFills'
servers:
  Testnet:
    url: wss://api.hyperliquid-testnet.xyz/
    protocol: wss
    x-default: true
  Mainnet:
    url: wss://api.hyperliquid.xyz/
    protocol: wss
components:
  schemas:
    userFills_UserFillsMessage:
      type: object
      properties:
        channel:
          type: string
          enum:
            - userFills
        data:
          description: Any type
      required:
        - channel
        - data
      title: UserFillsMessage
    common_SubscriptionMethod:
      type: string
      enum:
        - subscribe
        - unsubscribe
      title: SubscriptionMethod
    common_Address:
      type: string
      description: Master account or subaccount address.
      title: Address
    userFills_UserFillsSubscription:
      type: object
      properties:
        type:
          type: string
          enum:
            - userFills
        user:
          $ref: '#/components/schemas/common_Address'
        aggregateByTime:
          type: boolean
      required:
        - type
        - user
      title: UserFillsSubscription
    userFills_SubscribeUserFills:
      type: object
      properties:
        method:
          $ref: '#/components/schemas/common_SubscriptionMethod'
        subscription:
          $ref: '#/components/schemas/userFills_UserFillsSubscription'
      required:
        - method
        - subscription
      title: SubscribeUserFills

```