Skip to main content
This WebSocket API will be deprecated on July 1, 2026. See the Migration Guide to move to the Centrifuge-based API.
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. See Capital Efficiency for a high-level overview. CHANNEL NAME FORMAT ce_refunds:{user}
NameTypeDescription
userstringThe 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 for schema details. 
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 
[
  {
    "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"
      }
    ]
  }
]