# RPC WebSocket

This endpoint upgrades the connection to a WebSocket rather than answering with a body.

_Source: https://beta.taostats.io/docs/api-reference/rpc-live/get-rpc-ws-target_

_Last reviewed: 2026-10-12_

```http
GET wss://api.taostats.io/api/v1/rpc/ws/{target}
```

Requires an API key in the `authorization` query parameter.

> [!WARNING]
> **This API is retired on November 9, 2026**
>
> Every endpoint in this reference — every path that starts with `/api/` — stops working on **November 9, 2026**. The [new Taostats API](https://beta.taostats.io/docs/new) replaces it: same key, new paths under `https://api.taostats.io/v1/`. Move your integration to the [new API reference](https://beta.taostats.io/docs/new) before then.

This endpoint upgrades the connection to a WebSocket rather than answering with a body. The `target` path parameter selects the node, and the API key goes in the `authorization` query parameter.

- RPC light node: `wss://api.taostats.io/api/v1/rpc/ws/finney_lite?authorization=API_KEY`
- RPC archive: `wss://api.taostats.io/api/v1/rpc/ws/finney_archive?authorization=API_KEY`

## Parameters

| Name | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `target` | path | `string` | Yes | One of `finney_lite`, `finney_archive`. |

## Responses

_This endpoint has no documented responses._

Every connection needs your API key in the `authorization` query parameter — see [Getting started with the Taostats API](https://beta.taostats.io/docs/start-here/getting-started-with-taostats-api).