REQUEST

HEADER PARAMS


msg_type string required Message type: `get_positions`
id number required The ID of the request. This is returned in the response header.
version integer required Version number: `1`

BODY PARAMS


account_id string required The account for which to get open positions.
instrument_id string The instrument for which to receive open positions.

Example

[
  {
    "msg_type":"get_positions",
    "id": 1002,
    "version": 1
  },
  {
    "account_id": "0x9f58498b98348b9BFbE53F0E18AA818a4Be0aE49",
    "instrument_id": "ETH-PERPETUAL"
  }
]

RESPONSE

array of objects

object
instrument_id string The instrument of the position.
size string The size of the position.
total_cost string The total cost of the position.
mark_price string The mark price of the position.

Example

[
  {
    "msg_type":"get_positions_response",
    "id": 1002,
    "version": 1
  },
  [
    {
      "instrument_id": "SOL-PERPETUAL",
      "size": "130.9",
      "total_cost": "19932.002",
      "mark_price": "152.73"
    }
  ]
]