# WebSocket Tools

Real-time blockchain monitoring via persistent WebSocket connections.

### WebSocket Connection(**`zetrix_ws_connect`)**

Connect and register to WebSocket for real-time updates.

**Purpose:** Establish persistent bidirectional connection to Zetrix node.

**Returns:**

* Connection status
* Blockchain version
* Node information

**Connection Details:**

* Mainnet: `ws://node-ws.zetrix.com`
* Testnet: `ws://test-node-ws.zetrix.com`

**Automatic Handling:**

* Reconnects on disconnect
* Queues messages during reconnection

***

### Transaction via WebSocket(**`zetrix_ws_submit_transaction`)**

Submit transaction via WebSocket with real-time status.

**Purpose:** Send transaction and receive instant status updates as it processes.

**Advantages over HTTP:**

* Real-time status updates
* Instant confirmation notifications
* No polling required

**Timeout:** 30 seconds for confirmation, then falls back to polling.

***

### Transaction Events(**`zetrix_ws_subscribe_tx`)**

Subscribe to transaction notifications for addresses.

**Purpose:** Monitor specific addresses and get notified of any transactions.

**Parameters:**

* `addresses` (array): List of addresses to monitor

**Notifications:**

* Incoming transactions
* Outgoing transactions
* Transaction details

**Limits:** Maximum 100 subscriptions per connection

**Use Cases:**

* Payment processing
* Wallet notifications
* Exchange deposit monitoring

***

### Transaction Events(**`zetrix_ws_disconnect`)**

Disconnect from WebSocket.

**Purpose:** Properly close WebSocket connection and clean up resources.

**Note:** Can reconnect after disconnect by calling `ws_connect` again.

***

### WebSocket Connection Status(**`zetrix_ws_status`)**

Check WebSocket connection status.

**Purpose:** Verify connection state and health.

**Returns:**

* Connection state (connected/disconnected)
* Message count
* Errors
* Reconnection attempts
* Latency

***


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.zetrix.com/en/developer-resources/zetrix-mcp-server/tools-reference/websocket-tools.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.