> ## Documentation Index
> Fetch the complete documentation index at: https://docs.joyride.exchange/llms.txt
> Use this file to discover all available pages before exploring further.

# User trade notifications

> Real-time fill notifications for the authenticated user.
Global channel -- covers all instruments. Requires authentication.




## AsyncAPI

````yaml _generated/asyncapi.yaml userTradesChannel
id: userTradesChannel
title: User trade notifications
description: |
  Real-time fill notifications for the authenticated user.
  Global channel -- covers all instruments. Requires authentication.
servers:
  - id: production
    protocol: wss
    host: joyride.exchange
    bindings: []
    variables: []
address: user.trades
parameters: []
bindings: []
operations:
  - &ref_0
    id: receiveUserTradeNotification
    title: Receive user trade notification
    description: Receive authenticated-user fill notifications.
    type: receive
    messages:
      - &ref_1
        id: UserTradeNotification
        contentType: application/json
        payload:
          - name: User fill notification
            description: Flat trade object — not nested.
            type: object
            properties:
              - name: trade_id
                type: integer
                required: true
              - name: instrument_id
                type: string
                required: true
              - name: price
                type: integer
                description: USDC micros
                required: true
              - name: size
                type: integer
                description: Millicontracts
                required: true
              - name: taker_wallet
                type: string
                description: Wallet address of the taker (Solana base58).
                required: true
              - name: maker_wallet
                type: string
                description: Wallet address of the maker (Solana base58).
                required: true
              - name: maker_order_id
                type: integer
                description: >
                  ID of the maker side of this trade. Use this to cross-validate

                  fill notifications against orders you placed (the gateway
                  emits

                  the same channel for every fill the wallet was party to, so

                  clients track their own order IDs and match on this field).
                required: true
              - name: taker_order_id
                type: integer
                description: |
                  ID of the taker side of this trade. See `maker_order_id` for
                  cross-validation guidance.
                required: true
              - name: taker_side
                type: string
                enumValues:
                  - bid
                  - ask
                required: true
              - name: timestamp
                type: integer
                description: Unix microseconds
                required: true
        headers: []
        jsonPayloadSchema:
          type: object
          properties:
            trade_id:
              type: integer
              x-parser-schema-id: <anonymous-schema-183>
            instrument_id:
              type: string
              x-parser-schema-id: <anonymous-schema-184>
            price:
              type: integer
              description: USDC micros
              x-parser-schema-id: <anonymous-schema-185>
            size:
              type: integer
              description: Millicontracts
              x-parser-schema-id: <anonymous-schema-186>
            taker_wallet:
              type: string
              description: Wallet address of the taker (Solana base58).
              x-parser-schema-id: <anonymous-schema-187>
            maker_wallet:
              type: string
              description: Wallet address of the maker (Solana base58).
              x-parser-schema-id: <anonymous-schema-188>
            maker_order_id:
              type: integer
              description: |
                ID of the maker side of this trade. Use this to cross-validate
                fill notifications against orders you placed (the gateway emits
                the same channel for every fill the wallet was party to, so
                clients track their own order IDs and match on this field).
              x-parser-schema-id: <anonymous-schema-189>
            taker_order_id:
              type: integer
              description: |
                ID of the taker side of this trade. See `maker_order_id` for
                cross-validation guidance.
              x-parser-schema-id: <anonymous-schema-190>
            taker_side:
              type: string
              enum:
                - bid
                - ask
              x-parser-schema-id: <anonymous-schema-191>
            timestamp:
              type: integer
              description: Unix microseconds
              x-parser-schema-id: <anonymous-schema-192>
          required:
            - trade_id
            - instrument_id
            - price
            - size
            - taker_wallet
            - maker_wallet
            - maker_order_id
            - taker_order_id
            - taker_side
            - timestamp
          x-parser-schema-id: <anonymous-schema-182>
        title: User fill notification
        description: Flat trade object — not nested.
        example: |-
          {
            "trade_id": 123,
            "instrument_id": "<string>",
            "price": 123,
            "size": 123,
            "taker_wallet": "<string>",
            "maker_wallet": "<string>",
            "maker_order_id": 123,
            "taker_order_id": 123,
            "taker_side": "<string>",
            "timestamp": 123
          }
        bindings: []
        extensions:
          - id: x-parser-unique-object-id
            value: UserTradeNotification
    bindings: []
    extensions:
      - id: x-parser-unique-object-id
        value: userTradesChannel
sendOperations:
  - *ref_0
receiveOperations: []
sendMessages:
  - *ref_1
receiveMessages: []
extensions:
  - id: x-parser-unique-object-id
    value: userTradesChannel
securitySchemes: []

````