> ## Documentation Index
> Fetch the complete documentation index at: https://docs.hypedexer.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Fills Spot

> Subscribe to spot fills stream over the /ws multiplex WebSocket.

<Warning>
  **Not served by the public endpoint today.** A `subscribe` with this type is answered with
  `{"type":"error","message":"Unsupported subscription: fills_spot"}` on `wss://api.hypedexer.com/ws`
  (checked 19 September 2026). Use the REST equivalent below, or
  [contact us](https://t.me/EnigmaValidatorCommunity/1) if you need this stream.
</Warning>

REST equivalent: [`GET /fills/spot/`](/api-reference/fills/list-spot-fills-only) and [`GET /fills/spot/user/{user_address}`](/api-reference/fills/user-spot-fills-only).

# Fills Spot

Spot fills stream uses the **multiplex WebSocket endpoint**:

```text theme={null}
wss://api.hypedexer.com/ws
```

All subscriptions go through `/ws`.\
Authenticate using `X-API-Key` during the handshake.

***

## 1. Subscribe to spot fills

### Client message

```json theme={null}
{
  "method": "subscribe",
  "subscription": {
    "type": "fills_spot"
  }
}
```

***

## 2. Example server event

```json theme={null}
{
    "type": "fills_spot",
    "count": 1,
    "data": [
        {
            "user": "0x76a475f91ae582f4a774ba21540e612aed6aca07",
            "coin": "@107",
            "coin_meaning": "HYPE",
            "px": 33.67,
            "sz": 3.42,
            "side": "A",
            "time": "2025-11-21T17:40:12.049999",
            "tid": 11055306883242,
            "oid": 244171824122,
            "hash": "0x0000000000000000000000000000000000000000000000000000000000000000",
            "fee": 0.08060598,
            "fee_token": "USDC",
            "fee_usdc": 0.08060598,
            "type_trade": "spot",
            "time_dt": "2025-11-21T17:40:12"
        }
    ]
}
```

***

## 3. Unsubscribe

```json theme={null}
{
  "method": "unsubscribe",
  "subscription": {
    "type": "fills_spot"
  }
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.