> For the complete documentation index, see [llms.txt](https://docs.ama.one/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.ama.one/http-api/web-socket.md).

# Web Socket

WebSocket RPC endpoints for real-time communication

## WebSocket RPC endpoint

> Upgrade HTTP connection to WebSocket for real-time RPC communication

```json
{"openapi":"3.0.3","info":{"title":"Amadeus Blockchain API","version":"1.5.0"},"tags":[{"name":"WebSocket","description":"WebSocket RPC endpoints for real-time communication"}],"servers":[{"url":"https://nodes.amadeus.bot","description":"Mainnet"},{"url":"https://testnet-rpc.ama.one","description":"Testnet"}],"paths":{"/ws/rpc":{"get":{"tags":["WebSocket"],"summary":"WebSocket RPC endpoint","description":"Upgrade HTTP connection to WebSocket for real-time RPC communication","parameters":[{"name":"Upgrade","in":"header","required":true,"schema":{"type":"string","enum":["websocket"]}},{"name":"Connection","in":"header","required":true,"schema":{"type":"string","enum":["Upgrade"]}}],"responses":{"101":{"description":"Switching Protocols - WebSocket connection established"},"400":{"description":"Bad Request - Invalid WebSocket handshake"}}}}}}
```

## WebSocket test page

> Returns an HTML test page for WebSocket RPC functionality

```json
{"openapi":"3.0.3","info":{"title":"Amadeus Blockchain API","version":"1.5.0"},"tags":[{"name":"WebSocket","description":"WebSocket RPC endpoints for real-time communication"}],"servers":[{"url":"https://nodes.amadeus.bot","description":"Mainnet"},{"url":"https://testnet-rpc.ama.one","description":"Testnet"}],"paths":{"/ws/rpc/test":{"get":{"tags":["WebSocket"],"summary":"WebSocket test page","description":"Returns an HTML test page for WebSocket RPC functionality","responses":{"200":{"description":"HTML test page","content":{"text/html":{"schema":{"type":"string"}}}}}}}}}
```
