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

# CE Refund Events

> Subscribe to real-time capital-efficiency refund events

<Warning>
  This WebSocket API will be deprecated on July 1, 2026. See the [Migration Guide](/api-reference/centrifugo-migration) to move to the Centrifuge-based API.
</Warning>

Subscribe to changes in a particular user's capital-efficient refund events. You receive updates when refunds are generated from reductions in maximum loss (MXL) for the user's market groups.

For field definitions, see [Get portfolio refunds](/api-reference/get-trades-refunds).

See [Capital Efficiency](/developers/capital-efficiency) for a high-level overview.

**CHANNEL NAME FORMAT**

`ce_refunds:{user}`

| Name | Type   | Description              |
| ---- | ------ | ------------------------ |
| user | string | The user to subscribe to |

**MESSAGE PAYLOAD FORMAT**

The message payload matches a single element within the `GET /trades/portfolio/refunds` JSON results. See [Get portfolio refunds](/api-reference/get-trades-refunds) for schema details.

***

```javascript theme={null}
const user = "0xaD6A65315Cb20dD0b9D0Af56213516727a20C66F";
const channel = realtime.channels.get(`ce_refunds:${user}`);
channel.subscribe((message) => {
  console.log(message.data);
});
```

The above command returns JSON structured like this

```json theme={null}
[
  {
    "marketHash": "0x3e012cc2842849b96768547d4c92720d7ee8946e7706323f5114b6451708cf5e",
    "baseToken": "0x1BC6326EA6aF2aB8E4b68c83418044B1923b2956",
    "totalRefunded": 2.346033,
    "events": [
      {
        "maker": false,
        "amount": "2.346033",
        "bettor": "0xaD6A65315Cb20dD0b9D0Af56213516727a20C66F",
        "baseToken": "0x1BC6326EA6aF2aB8E4b68c83418044B1923b2956",
        "createdAt": "2025-10-21T14:29:26.805266+00:00",
        "marketHash": "0x3e012cc2842849b96768547d4c92720d7ee8946e7706323f5114b6451708cf5e",
        "fillOrderHash": "0x7efa8ee211c5cbccebda722318252ee09cfadaa9c910bf4c433086d853784b02"
      }
    ]
  }
]
```