# Price

`GET` `https://api.unusualwhales.com/api/socket/price`

**NOTE:**
This is the documentation for websocket channels `price` and `price:<TICKER>`.
Websocket access for personal use is only available through the[Advanced plan](https://unusualwhales.com/pricing?product=api).

You can find fully-functional examples that stream data from many channels here:

- Python: [https://github.com/unusual-whales/api-examples/tree/main/examples/ws-multi-channel-multi-output](https://github.com/unusual-whales/api-examples/tree/main/examples/ws-multi-channel-multi-output)
- Javascript: [https://github.com/unusual-whales/api-examples/tree/main/examples/ws-multi-channel-multi-output-nodejs](https://github.com/unusual-whales/api-examples/tree/main/examples/ws-multi-channel-multi-output-nodejs)



Connect to the websocket URI:

`wss://api.unusualwhales.com/socket?token=<YOUR_API_TOKEN>`

then `join` the channel you wish to stream, for example `price:SPY` for live price updates for SPY or `price` for live price updates for every ticker.

If you are connecting to multiple `price:<TICKER>` channels and just want prices for all tickers, connect only to the global `price` channel.

Payload format:

Format for `price:<TICKER>`:
```
["price:SPY",{"ticker":"SPY","close":"562.82","time":1726670327692,"vol":6015555}]
```

Format for `price`:
```
["price",{"ticker":"SPY","close":"562.82","time":1726670327692,"vol":6015555}]
```

### Field reference

| Field | Type | Description |
|---|---|---|
| `ticker` | string | Ticker symbol. |
| `close` | decimal string | Last trade price. |
| `time` | int (ms) | Trade execution time, unix epoch milliseconds (UTC). |
| `vol` | int | Cumulative session volume on the underlying as of `time`. |



## Authentication

```
Authorization: Bearer YOUR_API_KEY
```



## Example

### curl

```bash
curl -X GET "https://api.unusualwhales.com/api/socket/price" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Accept: application/json"
```

### Python

```python
import http.client

conn = http.client.HTTPSConnection("api.unusualwhales.com")
headers = {"Authorization": "Bearer YOUR_API_KEY", "Accept": "application/json"}
conn.request("GET", "/api/socket/price", headers=headers)
response = conn.getresponse()
print(response.read().decode("utf-8"))
```

## Response Example

```json
{
  "data": []
}
```