Sign in

v21

latestOpenAPI 3.1.0raw.githubusercontent.com2026-05-2856132182.6 KB
Position

Get Position Info

Query real-time position data, such as position size, cumulative realized PNL, etc.

get/api/v1/position/list

Query parameters

sub_account_addressstring required

Trading vault address (subaccount) to query against.

symbolstring
Example:BTCUSDC
limitinteger nullable
cursorstring nullable

Response

Positions

next_page_cursorstring required

Cursor. Use the next_page_cursor token from the response to retrieve the next page of the data set

Example response

{
  "list": [
    {
      "created_time": "1672531200000",
      "leverage_sys_updated_time": "1672531200000",
      "mmr_sys_update_time": "1672531200000",
      "symbol": "BTCUSDC",
      "updated_time": "1672531200000"
    }
  ]
}