Position

Description

After an order is successfully placed, cancelled, or executed, a push notification will be sent to update the corresponding trading pair's position (including scenarios such as ADL that cause changes in position size).

Push frequency: Real-time

Account & Trade Type Support

UTA accounts: Supports Futures trade types.

Note:
The UTA API is currently in beta testing and should not be used in production trading environments.

//All position updates for all symbols.
{
  "id": "1545910660739",
  "action": "SUBSCRIBE",    // or UNSUBSCRIBE
  "channel":"positionAll",
  "tradeType": "FUTURES"    // UNIFIED
}

//All position updates for your symbol.
{
  "id": "1545910660739",
  "action": "SUBSCRIBE",    // or UNSUBSCRIBE
  "channel":"position",
  "tradeType": "FUTURES",   // UNIFIED
  "symbol":"XBTUSDTM"
}

Note:
If you are trading in UTA mode, set tradeType to UNIFIED.
This WebSocket subscription will deliver position updates for all supported trade types under the UTA account.

Response

Data Schema

positionAll

Example

UTA - FUTURES

{
    "P": 1770117071746459555,
    "T": "positionAll.UNIFIED",
    "d": {
        "O": 1768876206493000000,
        "U": 1770117071740000000,
        "l": "2",
        "q": "-46",
        "s": "TRUMPUSDTM",
        "bP": "5.3580141244",
        "eP": "4.8855208333333333333",
        "iM": "9.7198",
        "lP": "5.2913432001",
        "mM": "CROSS",
        "mP": "4.226",
        "pV": "19.4396",
        "pi": "70000000000000010",
        "mmr": "0.012",
        "mtM": "0.2332752",
        "rPL": "-0.20267048333333333332",
        "uPL": "3.03379583333333333332",
        "r": "0.2001",
        "adl":"0.46"
    }
}

Subscribe Message#

Response#

Request

Subscribe Message

Response