> ## 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.trades.(kind).(currency).(interval) > User trade notifications across all instruments for a given kind and currency. Receive a consolidated stream of your private trades across all instruments matching the specified `kind` and `currency`. The `interval` controls aggregation frequency. **Block RFQ trades:** Trades resulting from Block RFQ execution are included in this channel. See `user.trades.{instrument_name}.{interval}` for the complete list of Block RFQ-specific fields. ## AsyncAPI ````yaml api-reference/coinbase-deribit-app-api/adv-starbase-asyncapi.json user.trades.(kind).(currency).(interval) id: user.trades.(kind).(currency).(interval) title: 'user.trades.(kind).(currency).(interval) ' description: > User trade notifications across all instruments for a given kind and currency. Receive a consolidated stream of your private trades across all instruments matching the specified `kind` and `currency`. The `interval` controls aggregation frequency. **Block RFQ trades:** Trades resulting from Block RFQ execution are included in this channel. See `user.trades.{instrument_name}.{interval}` for the complete list of Block RFQ-specific fields. servers: - id: private protocol: wss host: drb.coinbase.com/ws/api/v2 bindings: [] variables: [] address: user.trades.{kind}.{currency}.{interval} parameters: - id: currency jsonSchema: type: string description: |- Currency code or `any` for all **Allowed values:** `BTC`, `ETH`, `USDC`, `USDT`, `EURR`, `any` enum: - BTC - ETH - EURR - USDC - USDT - any description: |- Currency code or `any` for all **Allowed values:** `BTC`, `ETH`, `USDC`, `USDT`, `EURR`, `any` type: string required: true deprecated: false - id: interval jsonSchema: type: string description: >- Frequency of notifications. Events will be aggregated over this interval. The value `raw` selects the finest granularity - events are aggregated over a 1 millisecond interval **(Please note that `raw` interval is only available to authorized users)** **Allowed values:** `raw`, `100ms`, `agg2` enum: - 100ms - agg2 - raw description: >- Frequency of notifications. Events will be aggregated over this interval. The value `raw` selects the finest granularity - events are aggregated over a 1 millisecond interval **(Please note that `raw` interval is only available to authorized users)** **Allowed values:** `raw`, `100ms`, `agg2` type: string required: true deprecated: false - id: kind jsonSchema: type: string description: >- Instrument kind **Allowed values:** `future`, `option`, `spot`, `future_combo`, `option_combo` enum: - future - future_combo - option - option_combo - spot description: >- Instrument kind **Allowed values:** `future`, `option`, `spot`, `future_combo`, `option_combo` type: string required: true deprecated: false bindings: [] operations: - &ref_1 id: receive_user_trades_kind_currency_interval_updates title: Receive user updates description: Client receives user update notifications 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. Please refer to [Notification page](https://deribit.mintlify.app/articles/notifications) for more information. 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: jsonrpc: default: '2.0' description: JSON-RPC version. Always `2.0`. type: string x-parser-schema-id: method: default: private/subscribe description: >- `private/subscribe` on the private WebSocket, after `public/auth`. enum: - private/subscribe type: string x-parser-schema-id: params: additionalProperties: false properties: channels: default: - user.trades.future.USDC.100ms description: >- Stream names to subscribe to, for example `quote.BTC-PERPETUAL`. items: type: string x-parser-schema-id: type: array x-parser-schema-id: required: - channels type: object x-parser-schema-id: required: - id - jsonrpc - method - params type: object x-parser-schema-id: title: Subscription Request description: >- Client sends subscription request to subscribe to notification channel. Please refer to [Notification page](https://deribit.mintlify.app/articles/notifications) for more information. example: |- { "id": 42, "jsonrpc": "2.0", "method": "private/subscribe", "params": { "channels": [ "user.trades.future.USDC.100ms" ] } } bindings: [] extensions: - id: x-parser-unique-object-id value: subscribe_request bindings: [] extensions: &ref_0 - id: x-parser-unique-object-id value: user.trades.(kind).(currency).(interval) - &ref_2 id: send_subscribe_user_trades_kind_currency_interval title: Send subscribe request for user description: Client sends subscription request for user updates 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: object required: true properties: - name: advanced type: string description: >- Advanced type of user order: `"usd"` or `"implv"` (only for options; omitted if not applicable) enumValues: - implv - usd required: false - name: amount type: number description: >- Trade amount. For perpetual and inverse futures the amount is in USD units. For options and linear futures it is the underlying base currency coin. required: true - name: api type: boolean description: '`true` if user order was created with API' required: false - name: block_rfq_id type: integer description: ID of the Block RFQ - when trade was part of the Block RFQ required: false - name: block_rfq_quote_id type: integer description: >- ID of the Block RFQ quote - when trade was part of the Block RFQ required: false - name: block_trade_id type: string description: Block trade id - when trade was part of a block trade required: false - name: block_trade_leg_count type: integer description: >- Block trade leg count - when trade was part of a block trade required: false - name: combo_id type: string description: >- Optional field containing combo instrument name if the trade is a combo trade required: false - name: combo_trade_id type: string description: >- Optional field containing combo trade identifier if the trade is a combo trade required: false - name: contracts type: number description: >- Trade size in contract units (optional, may be absent in historical trades) required: false - name: direction type: string description: 'Direction: `buy`, or `sell`' enumValues: - buy - sell required: true - name: fee type: number description: User's fee in units of the specified `fee_currency` required: true - name: fee_currency type: string description: Currency, i.e `"BTC"`, `"ETH"`, `"USDC"` enumValues: - BTC - ETH - EURR - USDC - USDT required: true - name: index_price type: number description: Index Price at the moment of trade required: true - name: instrument_name type: string description: Unique instrument identifier required: true - name: iv type: number description: Option implied volatility for the price (Option only) required: false - name: label type: string description: >- User defined label (presented only when previously set for order by user) required: false - name: legs type: array description: >- Optional field containing leg trades if trade is a combo trade (present when querying for **only** combo trades and in `combo_trades` events). Each leg trade has the same fields as a top-level user trade, including `starbase_match_id`, `starbase_order_id`, and `starbase_timestamp` when matched in Starbase, and `starbase_client_order_id` for orders submitted via [Starbase](https://docs.deribit.com/starbase/overview) direct access. required: false - name: liquidation type: string description: >- Optional field (only for trades caused by liquidation): `"M"` when maker side of trade was under liquidation, `"T"` when taker side was under liquidation, `"MT"` when both sides of trade were under liquidation enumValues: - M - MT - T required: false - name: liquidity type: string description: >- Describes what was role of users order: `"M"` when it was maker order, `"T"` when it was taker order enumValues: - M - T required: false - name: mark_price type: number description: Mark Price at the moment of trade required: true - name: matching_id type: string description: Always `null` required: true - name: mmp type: boolean description: '`true` if user order is MMP' required: false - name: order_id type: string description: >- Id of the user order (maker or taker), i.e. subscriber's order id that took part in the trade required: true - name: order_type type: string description: 'Order type: `"limit"`, `"market"`, or `"liquidation"`' enumValues: - limit - liquidation - market required: false - name: original_order_type type: string description: >- Original API order type when an order is represented internally as a limit order. For example, Starbase market orders use `"limit"` as `order_type` with `"market"` in this optional field. enumValues: - market - market_limit required: false - name: post_only type: string description: '`true` if user order is post-only' required: false - name: price type: number description: Price in base currency required: true - name: profit_loss type: number description: Profit and loss in base currency. required: false - name: quote_id type: string description: >- QuoteID of the user order (optional, present only for orders placed with `private/mass_quote`) required: false - name: quote_set_id type: string description: >- QuoteSet of the user order (optional, present only for orders placed with `private/mass_quote`) required: false - name: reduce_only type: string description: '`true` if user order is reduce-only' required: false - name: risk_reducing type: boolean description: >- `true` if user order is marked by the platform as a risk reducing order (can apply only to orders placed by PM users) required: false - name: starbase_client_order_id type: string description: >- Client order id of the user's own order (maker or taker side) submitted directly to [Starbase](https://docs.deribit.com/starbase/overview) via direct access; not returned for orders placed through the Deribit API; for self-trades this is the taker order's client order id required: false - name: starbase_match_id type: integer description: >- Optional field containing the Starbase match identifier (present only for trades matched via Starbase) required: false - name: starbase_order_id type: integer description: >- Raw Starbase order id of the user's order, in Starbase's own (non currency-prefixed) id namespace (present only for trades matched in Starbase) required: false - name: starbase_timestamp type: integer description: >- The Starbase causal timestamp of the trade (nanoseconds since the Unix epoch) required: false - name: state type: string description: >- Order state: `"open"`, `"filled"`, `"rejected"`, `"cancelled"`, `"untriggered"` or `"archive"` (if order was archived) enumValues: - archive - cancelled - filled - open - rejected - untriggered required: true - name: tick_direction type: integer description: >- Direction of the "tick" (`0` = Plus Tick, `1` = Zero-Plus Tick, `2` = Minus Tick, `3` = Zero-Minus Tick). enumValues: - 0 - 1 - 2 - 3 required: true - name: timestamp type: integer description: >- The timestamp of the trade (milliseconds since the UNIX epoch) required: true - name: trade_allocations type: object description: >- List of allocations for Block RFQ pre-allocation. Each allocation specifies `user_id`, `amount`, and `fee` for the allocated part of the trade. For broker client allocations, a `client_info` object will be included. required: false properties: - name: amount type: number description: Amount allocated to this user. required: true - name: client_info type: object description: Optional client allocation info for brokers. required: false properties: - name: client_id type: integer description: >- ID of a client; available to broker. Represents a group of users under a common name. required: false - name: client_link_id type: integer description: >- ID assigned to a single user in a client; available to broker. required: false - name: name type: string description: >- Name of the linked user within the client; available to broker. required: false - name: fee type: number description: Fee for the allocated part of the trade. required: true - name: user_id type: integer description: >- User ID to which part of the trade is allocated. For brokers the User ID is obstructed. required: false - name: trade_id type: string description: Unique (per currency) trade identifier required: true - name: trade_seq type: integer description: The sequence number of the trade within instrument required: true - name: underlying_price type: number description: >- Underlying price for implied volatility calculations (Options only) required: false headers: [] jsonPayloadSchema: additionalProperties: false description: Response containing notification data properties: data: additionalProperties: false description: '' properties: advanced: description: >- Advanced type of user order: `"usd"` or `"implv"` (only for options; omitted if not applicable) enum: - implv - usd type: string x-parser-schema-id: amount: description: >- Trade amount. For perpetual and inverse futures the amount is in USD units. For options and linear futures it is the underlying base currency coin. type: number x-parser-schema-id: api: description: '`true` if user order was created with API' type: boolean x-parser-schema-id: block_rfq_id: description: ID of the Block RFQ - when trade was part of the Block RFQ type: integer x-parser-schema-id: block_rfq_quote_id: description: >- ID of the Block RFQ quote - when trade was part of the Block RFQ type: integer x-parser-schema-id: block_trade_id: description: Block trade id - when trade was part of a block trade example: '154' type: string x-parser-schema-id: block_trade_leg_count: description: Block trade leg count - when trade was part of a block trade example: 3 type: integer x-parser-schema-id: combo_id: description: >- Optional field containing combo instrument name if the trade is a combo trade type: string x-parser-schema-id: combo_trade_id: description: >- Optional field containing combo trade identifier if the trade is a combo trade type: string x-parser-schema-id: contracts: description: >- Trade size in contract units (optional, may be absent in historical trades) type: number x-parser-schema-id: direction: description: 'Direction: `buy`, or `sell`' enum: - buy - sell type: string x-parser-schema-id: fee: description: User's fee in units of the specified `fee_currency` type: number x-parser-schema-id: fee_currency: description: Currency, i.e `"BTC"`, `"ETH"`, `"USDC"` enum: - BTC - ETH - EURR - USDC - USDT type: string x-parser-schema-id: index_price: description: Index Price at the moment of trade type: number x-parser-schema-id: instrument_name: description: Unique instrument identifier example: BTC-PERPETUAL type: string x-parser-schema-id: iv: description: Option implied volatility for the price (Option only) type: number x-parser-schema-id: label: description: >- User defined label (presented only when previously set for order by user) type: string x-parser-schema-id: legs: description: >- Optional field containing leg trades if trade is a combo trade (present when querying for **only** combo trades and in `combo_trades` events). Each leg trade has the same fields as a top-level user trade, including `starbase_match_id`, `starbase_order_id`, and `starbase_timestamp` when matched in Starbase, and `starbase_client_order_id` for orders submitted via [Starbase](https://docs.deribit.com/starbase/overview) direct access. type: array x-parser-schema-id: liquidation: description: >- Optional field (only for trades caused by liquidation): `"M"` when maker side of trade was under liquidation, `"T"` when taker side was under liquidation, `"MT"` when both sides of trade were under liquidation enum: - M - MT - T type: string x-parser-schema-id: liquidity: description: >- Describes what was role of users order: `"M"` when it was maker order, `"T"` when it was taker order enum: - M - T type: string x-parser-schema-id: mark_price: description: Mark Price at the moment of trade type: number x-parser-schema-id: matching_id: description: Always `null` type: string x-parser-schema-id: mmp: description: '`true` if user order is MMP' type: boolean x-parser-schema-id: order_id: description: >- Id of the user order (maker or taker), i.e. subscriber's order id that took part in the trade type: string x-parser-schema-id: order_type: description: 'Order type: `"limit"`, `"market"`, or `"liquidation"`' enum: - limit - liquidation - market type: string x-parser-schema-id: original_order_type: description: >- Original API order type when an order is represented internally as a limit order. For example, Starbase market orders use `"limit"` as `order_type` with `"market"` in this optional field. enum: - market - market_limit type: string x-parser-schema-id: post_only: description: '`true` if user order is post-only' type: string x-parser-schema-id: price: description: Price in base currency type: number x-parser-schema-id: profit_loss: description: Profit and loss in base currency. type: number x-parser-schema-id: quote_id: description: >- QuoteID of the user order (optional, present only for orders placed with `private/mass_quote`) type: string x-parser-schema-id: quote_set_id: description: >- QuoteSet of the user order (optional, present only for orders placed with `private/mass_quote`) type: string x-parser-schema-id: reduce_only: description: '`true` if user order is reduce-only' type: string x-parser-schema-id: risk_reducing: description: >- `true` if user order is marked by the platform as a risk reducing order (can apply only to orders placed by PM users) type: boolean x-parser-schema-id: starbase_client_order_id: description: >- Client order id of the user's own order (maker or taker side) submitted directly to [Starbase](https://docs.deribit.com/starbase/overview) via direct access; not returned for orders placed through the Deribit API; for self-trades this is the taker order's client order id type: string x-parser-schema-id: starbase_match_id: description: >- Optional field containing the Starbase match identifier (present only for trades matched via Starbase) type: integer x-parser-schema-id: starbase_order_id: description: >- Raw Starbase order id of the user's order, in Starbase's own (non currency-prefixed) id namespace (present only for trades matched in Starbase) example: 103148386170 type: integer x-parser-schema-id: starbase_timestamp: description: >- The Starbase causal timestamp of the trade (nanoseconds since the Unix epoch) example: 1536569522277000000 type: integer x-parser-schema-id: state: description: >- Order state: `"open"`, `"filled"`, `"rejected"`, `"cancelled"`, `"untriggered"` or `"archive"` (if order was archived) enum: - archive - cancelled - filled - open - rejected - untriggered type: string x-parser-schema-id: tick_direction: description: >- Direction of the "tick" (`0` = Plus Tick, `1` = Zero-Plus Tick, `2` = Minus Tick, `3` = Zero-Minus Tick). enum: - 0 - 1 - 2 - 3 type: integer x-parser-schema-id: timestamp: description: >- The timestamp of the trade (milliseconds since the UNIX epoch) example: 1517329113791 type: integer x-parser-schema-id: trade_allocations: additionalProperties: false description: >- List of allocations for Block RFQ pre-allocation. Each allocation specifies `user_id`, `amount`, and `fee` for the allocated part of the trade. For broker client allocations, a `client_info` object will be included. properties: amount: description: Amount allocated to this user. type: number x-parser-schema-id: client_info: description: Optional client allocation info for brokers. properties: client_id: description: >- ID of a client; available to broker. Represents a group of users under a common name. type: integer x-parser-schema-id: client_link_id: description: >- ID assigned to a single user in a client; available to broker. type: integer x-parser-schema-id: name: description: >- Name of the linked user within the client; available to broker. type: string x-parser-schema-id: type: object x-parser-schema-id: fee: description: Fee for the allocated part of the trade. type: number x-parser-schema-id: user_id: description: >- User ID to which part of the trade is allocated. For brokers the User ID is obstructed. type: integer x-parser-schema-id: required: - amount - fee type: object x-parser-schema-id: trade_id: description: Unique (per currency) trade identifier type: string x-parser-schema-id: trade_seq: description: The sequence number of the trade within instrument type: integer x-parser-schema-id: underlying_price: description: >- Underlying price for implied volatility calculations (Options only) type: number x-parser-schema-id: required: - amount - direction - fee - fee_currency - index_price - instrument_name - mark_price - matching_id - order_id - price - state - tick_direction - timestamp - trade_id - trade_seq type: object x-parser-schema-id: required: - data type: object x-parser-schema-id: title: Subscription Notification Data description: Server sends subscription notification data example: |- { "data": [ { "amount": 8940, "direction": "sell", "fee": 0.00049961, "fee_currency": "BTC", "index_price": 8953.53, "instrument_name": "BTC-25SEP20", "liquidity": "T", "mark_price": 8970.03, "matching_id": null, "order_id": "4008978075", "order_type": "limit", "post_only": false, "price": 8947, "reduce_only": false, "state": "filled", "tick_direction": 2, "timestamp": 1590484255886, "trade_id": "48079262", "trade_seq": 74405 } ] } 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.trades.(kind).(currency).(interval) securitySchemes: [] ````