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

# user.isolated.trades.(instrument_name).(interval) 

> Lets a **main** account observe trade executions across all of its **isolated-margin subaccounts** for a specific instrument, without subscribing to each subaccount individually.

Delivers real-time trade execution notifications for isolated-margin subaccounts bound to the specified instrument. Requires the `trade:read` scope on an API key belonging to the **main account**.




## AsyncAPI

````yaml api-reference/coinbase-deribit-app-api/adv-starbase-asyncapi.json user.isolated.trades.(instrument_name).(interval)
id: user.isolated.trades.(instrument_name).(interval)
title: 'user.isolated.trades.(instrument_name).(interval) '
description: >
  Lets a **main** account observe trade executions across all of its
  **isolated-margin subaccounts** for a specific instrument, without subscribing
  to each subaccount individually.


  Delivers real-time trade execution notifications for isolated-margin
  subaccounts bound to the specified instrument. Requires the `trade:read` scope
  on an API key belonging to the **main account**.
servers:
  - id: private
    protocol: wss
    host: drb.coinbase.com/ws/api/v2
    bindings: []
    variables: []
address: user.isolated.trades.{instrument_name}.{interval}
parameters:
  - id: instrument_name
    jsonSchema:
      type: string
      description: |-
        Instrument name

        **Example:** `SOL_USDC-PERPETUAL`
    description: |-
      Instrument name

      **Example:** `SOL_USDC-PERPETUAL`
    type: string
    required: true
    deprecated: false
  - id: interval
    jsonSchema:
      type: string
      description: |-
        Frequency of notifications.

        **Allowed values:** `raw`, `100ms`, `agg2`
      enum:
        - 100ms
        - agg2
        - raw
    description: |-
      Frequency of notifications.

      **Allowed values:** `raw`, `100ms`, `agg2`
    type: string
    required: true
    deprecated: false
bindings: []
operations:
  - &ref_1
    id: receive_user_isolated_trades_instrument_name_interval_updates
    title: Receive isolated trade updates by instrument
    description: Client receives isolated trade update notifications by instrument
    type: receive
    messages:
      - &ref_3
        id: subscribe_request
        contentType: application/json
        payload:
          - name: Subscription Request
            description: >-
              Client sends subscription request to subscribe to notification
              channel.
            type: object
            properties:
              - name: id
                type: integer
                description: Client request id, echoed in the response.
                required: true
              - name: jsonrpc
                type: string
                description: JSON-RPC version. Always `2.0`.
                required: true
              - name: method
                type: string
                description: >-
                  `private/subscribe` on the private WebSocket, after
                  `public/auth`.
                enumValues:
                  - private/subscribe
                required: true
              - name: params
                type: object
                required: true
                properties:
                  - name: channels
                    type: array
                    description: >-
                      Stream names to subscribe to, for example
                      `quote.BTC-PERPETUAL`.
                    required: true
                    properties:
                      - name: item
                        type: string
                        required: false
        headers: []
        jsonPayloadSchema:
          additionalProperties: false
          properties:
            id:
              default: 42
              description: Client request id, echoed in the response.
              type: integer
              x-parser-schema-id: <anonymous-schema-975>
            jsonrpc:
              default: '2.0'
              description: JSON-RPC version. Always `2.0`.
              type: string
              x-parser-schema-id: <anonymous-schema-976>
            method:
              default: private/subscribe
              description: >-
                `private/subscribe` on the private WebSocket, after
                `public/auth`.
              enum:
                - private/subscribe
              type: string
              x-parser-schema-id: <anonymous-schema-977>
            params:
              additionalProperties: false
              properties:
                channels:
                  default:
                    - user.isolated.trades.SOL_USDC-PERPETUAL.100ms
                  description: >-
                    Stream names to subscribe to, for example
                    `quote.BTC-PERPETUAL`.
                  items:
                    type: string
                    x-parser-schema-id: <anonymous-schema-980>
                  type: array
                  x-parser-schema-id: <anonymous-schema-979>
              required:
                - channels
              type: object
              x-parser-schema-id: <anonymous-schema-978>
          required:
            - id
            - jsonrpc
            - method
            - params
          type: object
          x-parser-schema-id: <anonymous-schema-974>
        title: Subscription Request
        description: >-
          Client sends subscription request to subscribe to notification
          channel.
        example: |-
          {
            "id": 42,
            "jsonrpc": "2.0",
            "method": "private/subscribe",
            "params": {
              "channels": [
                "user.isolated.trades.SOL_USDC-PERPETUAL.100ms"
              ]
            }
          }
        bindings: []
        extensions:
          - id: x-parser-unique-object-id
            value: subscribe_request
    bindings: []
    extensions: &ref_0
      - id: x-parser-unique-object-id
        value: user.isolated.trades.(instrument_name).(interval)
  - &ref_2
    id: send_subscribe_user_isolated_trades_instrument_name_interval
    title: Send subscribe request for isolated trades by instrument
    description: Client sends subscription request for isolated trade updates by instrument
    type: send
    messages:
      - &ref_4
        id: subscription_message
        contentType: application/json
        payload:
          - name: Subscription Notification Data
            description: Server sends subscription notification data
            type: object
            properties:
              - name: data
                type: array
                description: List of trade execution records
                required: true
                properties:
                  - name: amount
                    type: number
                    description: Trade amount in base currency
                    required: true
                  - name: direction
                    type: string
                    description: 'Trade direction: buy or sell'
                    required: true
                  - name: fee
                    type: number
                    description: Fee amount
                    required: false
                  - name: instrument_name
                    type: string
                    description: Instrument name
                    required: true
                  - name: isolated
                    type: boolean
                    description: Always true for isolated trade events
                    required: true
                  - name: main_uid
                    type: integer
                    description: Owning main account user ID
                    required: true
                  - name: order_id
                    type: string
                    description: Order identifier
                    required: true
                  - name: price
                    type: number
                    description: Trade price
                    required: true
                  - name: timestamp
                    type: integer
                    description: Trade timestamp in ms
                    required: false
                  - name: trade_id
                    type: string
                    description: Unique trade identifier
                    required: true
                  - name: user_id
                    type: integer
                    description: Subaccount slot ID owning the trade
                    required: true
        headers: []
        jsonPayloadSchema:
          additionalProperties: false
          description: Response containing notification data
          properties:
            data:
              description: List of trade execution records
              items:
                properties:
                  amount:
                    description: Trade amount in base currency
                    type: number
                    x-parser-schema-id: <anonymous-schema-984>
                  direction:
                    description: 'Trade direction: buy or sell'
                    type: string
                    x-parser-schema-id: <anonymous-schema-985>
                  fee:
                    description: Fee amount
                    type: number
                    x-parser-schema-id: <anonymous-schema-986>
                  instrument_name:
                    description: Instrument name
                    type: string
                    x-parser-schema-id: <anonymous-schema-987>
                  isolated:
                    description: Always true for isolated trade events
                    type: boolean
                    x-parser-schema-id: <anonymous-schema-988>
                  main_uid:
                    description: Owning main account user ID
                    type: integer
                    x-parser-schema-id: <anonymous-schema-989>
                  order_id:
                    description: Order identifier
                    type: string
                    x-parser-schema-id: <anonymous-schema-990>
                  price:
                    description: Trade price
                    type: number
                    x-parser-schema-id: <anonymous-schema-991>
                  timestamp:
                    description: Trade timestamp in ms
                    type: integer
                    x-parser-schema-id: <anonymous-schema-992>
                  trade_id:
                    description: Unique trade identifier
                    type: string
                    x-parser-schema-id: <anonymous-schema-993>
                  user_id:
                    description: Subaccount slot ID owning the trade
                    type: integer
                    x-parser-schema-id: <anonymous-schema-994>
                required:
                  - amount
                  - direction
                  - instrument_name
                  - isolated
                  - main_uid
                  - order_id
                  - price
                  - trade_id
                  - user_id
                type: object
                x-parser-schema-id: <anonymous-schema-983>
              type: array
              x-parser-schema-id: <anonymous-schema-982>
          required:
            - data
          type: object
          x-parser-schema-id: <anonymous-schema-981>
        title: Subscription Notification Data
        description: Server sends subscription notification data
        example: |-
          {
            "jsonrpc": "2.0",
            "method": "subscription",
            "params": {
              "channel": "user.isolated.trades.SOL_USDC-PERPETUAL.100ms",
              "data": [
                {
                  "amount": 10,
                  "direction": "buy",
                  "fee": 0.05,
                  "instrument_name": "SOL_USDC-PERPETUAL",
                  "isolated": true,
                  "main_uid": 1000,
                  "order_id": "12345678",
                  "price": 100,
                  "timestamp": 1787109600000,
                  "trade_id": "T-998811",
                  "user_id": 123456
                }
              ]
            }
          }
        bindings: []
        extensions:
          - id: x-parser-unique-object-id
            value: subscription_message
    bindings: []
    extensions: *ref_0
sendOperations:
  - *ref_1
receiveOperations:
  - *ref_2
sendMessages:
  - *ref_3
receiveMessages:
  - *ref_4
extensions:
  - id: x-parser-unique-object-id
    value: user.isolated.trades.(instrument_name).(interval)
securitySchemes: []

````