> ## Documentation Index > Fetch the complete documentation index at: https://v3.docs.derive.xyz/llms.txt > Use this file to discover all available pages before exploring further. # Auctions watch > Channel name: `auctions.watch`. Public channel that streams the live state of all ongoing liquidation and insolvency auctions across the exchange. Takes no parameters. ## AsyncAPI ````yaml subscriptions.asyncapi.json auctionsWatch id: auctionsWatch title: Auctions watch description: >- Channel name: `auctions.watch`. Public channel that streams the live state of all ongoing liquidation and insolvency auctions across the exchange. Takes no parameters. servers: - id: production protocol: wss host: api.derive.xyz bindings: [] variables: [] - id: testnet protocol: wss host: testnet.api.derive.xyz bindings: [] variables: [] address: /v3/ws parameters: [] bindings: [] operations: - &ref_7 id: receive_auctionsWatch title: Receive_auctions watch type: send messages: - &ref_10 id: auctionsWatchNotification payload: - name: auctionsWatchNotification description: Pushed as a JSON array; each element has the fields below. type: object properties: - name: details type: object required: false properties: - name: currency type: &ref_0 - string - 'null' required: false - name: estimated_bid_price type: string required: true - name: estimated_discount_pnl type: string required: true - name: estimated_mtm type: string required: true - name: estimated_percent_bid type: string required: true - name: last_seen_trade_id type: integer required: true - name: margin_type type: string required: true - name: min_cash_transfer type: string required: true - name: min_price_limit type: string required: true - name: subaccount_balances type: string required: true - name: state type: string enumValues: - ongoing - ended required: true - name: subaccount_id type: integer required: true - name: timestamp type: integer required: true headers: [] jsonPayloadSchema: description: Payload for `auctions.watch`. type: object required: - state - subaccount_id - timestamp properties: details: anyOf: - type: object required: - estimated_bid_price - estimated_discount_pnl - estimated_mtm - estimated_percent_bid - last_seen_trade_id - margin_type - min_cash_transfer - min_price_limit - subaccount_balances properties: currency: type: *ref_0 x-parser-schema-id: estimated_bid_price: type: string x-parser-schema-id: estimated_discount_pnl: type: string x-parser-schema-id: estimated_mtm: type: string x-parser-schema-id: estimated_percent_bid: type: string x-parser-schema-id: last_seen_trade_id: type: integer format: int64 x-parser-schema-id: margin_type: type: string x-parser-schema-id: min_cash_transfer: type: string x-parser-schema-id: min_price_limit: type: string x-parser-schema-id: subaccount_balances: type: string x-parser-schema-id: x-parser-schema-id: AuctionDetails - type: 'null' x-parser-schema-id: x-parser-schema-id: state: type: string enum: - ongoing - ended x-parser-schema-id: AuctionStateType subaccount_id: type: integer format: int64 x-parser-schema-id: timestamp: type: integer format: int64 x-parser-schema-id: x-parser-schema-id: AuctionResult title: Auctions watch notification description: Pushed as a JSON array; each element has the fields below. example: |- { "details": { "estimated_bid_price": "", "estimated_discount_pnl": "", "estimated_mtm": "", "estimated_percent_bid": "", "last_seen_trade_id": 123, "margin_type": "", "min_cash_transfer": "", "min_price_limit": "", "subaccount_balances": "" }, "state": "", "subaccount_id": 123, "timestamp": 123 } bindings: [] extensions: - id: x-parser-unique-object-id value: auctionsWatchNotification bindings: [] extensions: &ref_5 - id: x-parser-unique-object-id value: auctionsWatch - &ref_6 id: send_subscribe_auctionsWatch title: Send_subscribe_auctions watch type: receive messages: - &ref_8 id: subscribeRequest payload: - name: subscribeRequest description: >- Send to subscribe: list this channel's address (with the {param} segments filled, e.g. orderbook.ETH-PERP.10.20) in params.channels. type: object properties: - name: headers type: &ref_1 - object - 'null' description: Non-standard; used by `auth/login`. required: false - name: id type: anyOf required: true - name: method type: string description: subscribe required: true - name: params type: object description: >- Params for `subscribe`. `channels` is the required list of channel names to subscribe to. required: true properties: - name: channels type: array required: true properties: - name: item type: string required: false headers: [] jsonPayloadSchema: type: object required: - id - method - params properties: headers: description: Non-standard; used by `auth/login`. type: *ref_1 additionalProperties: true x-parser-schema-id: id: &ref_3 anyOf: - type: string x-parser-schema-id: - type: number x-parser-schema-id: - type: 'null' x-parser-schema-id: x-parser-schema-id: JsonRpcId method: type: string const: subscribe x-parser-schema-id: params: description: >- Params for `subscribe`. `channels` is the required list of channel names to subscribe to. type: object required: - channels properties: channels: type: array items: type: string x-parser-schema-id: x-parser-schema-id: x-parser-schema-id: SubscribeParams x-parser-schema-id: title: Subscribe request description: >- Send to subscribe: list this channel's address (with the {param} segments filled, e.g. orderbook.ETH-PERP.10.20) in params.channels. example: |- { "id": 1, "method": "subscribe", "params": { "channels": [ "orderbook.ETH-PERP.10.20" ] } } bindings: [] extensions: - id: x-parser-unique-object-id value: subscribeRequest - &ref_9 id: unsubscribeRequest payload: - name: unsubscribeRequest description: >- Send to unsubscribe: list the channel addresses to drop in params.channels, or omit it to unsubscribe from everything. type: object properties: - name: headers type: &ref_2 - object - 'null' description: Non-standard; used by `auth/login`. required: false - name: id type: anyOf required: true - name: method type: string description: unsubscribe required: true - name: params type: object description: >- Params for `unsubscribe`. `channels` is optional. When omitted (or null) the connection unsubscribes from all channels. required: true properties: - name: channels type: &ref_4 - array - 'null' required: false headers: [] jsonPayloadSchema: type: object required: - id - method - params properties: headers: description: Non-standard; used by `auth/login`. type: *ref_2 additionalProperties: true x-parser-schema-id: id: *ref_3 method: type: string const: unsubscribe x-parser-schema-id: params: description: >- Params for `unsubscribe`. `channels` is optional. When omitted (or null) the connection unsubscribes from all channels. type: object properties: channels: default: null type: *ref_4 items: type: string x-parser-schema-id: x-parser-schema-id: x-parser-schema-id: UnsubscribeParams x-parser-schema-id: title: Unsubscribe request description: >- Send to unsubscribe: list the channel addresses to drop in params.channels, or omit it to unsubscribe from everything. example: |- { "method": "", "params": {} } bindings: [] extensions: - id: x-parser-unique-object-id value: unsubscribeRequest bindings: [] extensions: *ref_5 sendOperations: - *ref_6 receiveOperations: - *ref_7 sendMessages: - *ref_8 - *ref_9 receiveMessages: - *ref_10 extensions: - id: x-parser-unique-object-id value: auctionsWatch securitySchemes: [] ```` ## Related topics - [Subscriptions](/subscriptions.md) - [Margin watch](/api-reference/channels/marginwatch.md) - [Error Codes](/error-codes.md)