Skip to content

Futures position reduced

SEND Server to Client on wss://api.valr.com/ws/account

Sent when a futures position has been partially or fully closed. On a partial close, you will receive both REDUCE_POSITION and OPEN_POSITION_UPDATE events. On a full close, you will receive both REDUCE_POSITION and POSITION_CLOSED events. The quantity field specifies the amount by which the position was reduced.

Authentication

This operation requires API key authentication (HMAC-SHA512 via query parameters or in-band AUTHENTICATE message).

Message

Event type: REDUCE_POSITION

Payload Schema

PropertyTypeRequiredDescription
currencyPairstringYes-
orderSidestringYes-
quantitystringYes-
averageEntryPricestringYes-
closePricestringYes-
realisedPnlstringYes-
closeTypestringYes-
createdAtstringYes-
feesstringYes-
positionIdstringYes-
initialMarginFractionAtClosestringYes-

Example

json
"{\n    \"type\": \"REDUCE_POSITION\",\n    \"data\": {\n        \"currencyPair\": \"USDTZARPERP\",\n        \"orderSide\": \"buy\",\n        \"quantity\": \"140.576\",\n        \"averageEntryPrice\": \"18.0002\",\n        \"closePrice\": \"18\",\n        \"realisedPnl\": \"-3.5706498\",\n        \"closeType\": \"Trade\",\n        \"createdAt\": \"2025-05-30T11:13:08.898Z\",\n        \"fees\": \"3.5425346\",\n        \"positionId\": \"27b1f2f1-a500-8dea-28a9-03190309a944\",\n        \"initialMarginFractionAtClose\": \"0.1\"\n    }\n}"

Channel

Channel: account Address: wss://api.valr.com/ws/account