---
title: "Get Position Info"
method: GET
path: "/api/v1/position/list"
tags: ["Position"]
---

# Get Position Info

`GET /api/v1/position/list`

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

## Query parameters

- `sub_account_address` string, required
- `symbol` string
- `limit` integer, nullable
- `cursor` string, nullable

## Response `200`

Positions

- GetPositionInfoResponse — Position info response.
  - `list` Position[], required
    - `adl_rank_indicator` 'Zero' | 'One' | 'Two' | 'Three' | 'Four' | 'Five', required — Auto-deleverage rank indicator.
    - `avg_price` string, required — Average entry price.
    - `bust_price` string, required — Bankruptcy price
    - `created_time` string, date-time, required — Timestamp of the first time a position was created on this symbol (ms)
    - `cum_funding` string, required — Net realized funding PnL accumulated for this position (receive positive, pay negative).
    - `is_reduce_only` boolean, required
    - `leverage` string, required — Position leverage
    - `leverage_sys_updated_time` string, date-time, nullable
    - `liq_price` string, required — Position liquidation price
    - `margin_mode` 'Cross' | 'Isolated', required
    - `mark_price` string, required — Mark price
    - `mmr_sys_update_time` string, date-time, nullable
    - `position_balance` string, required — Position margin
    - `position_im` string, required — Initial margin
    - `position_im_by_mp` string, required — Initial margin calculated by mark price
    - `position_mm` string, required — Maintenance margin
    - `position_mm_by_mp` string, required — Maintenance margin calculated by mark price
    - `position_status` 'Normal' | 'Liq' | 'Adl', required
    - `position_value` string, required — Position value
    - `realized_pnl_cum` string, required — Sum of all historical Current Realized PnLs (and the latest one).
    - `realized_pnl_cur` string, required — Sum of Fill Realized PnL for position of this symbol/side since this position was created last time
    - `risk_id` integer, required — Risk tier ID
    - `risk_limit_value` string, required — Risk limit value
    - `seq` integer, required — Cross sequence, used to associate each fill and each position update * Different symbols may have the same seq, please use seq + symbol to check unique
    - `side` 'Sell' | 'Buy', required — Order side: buy or sell.
    - `size` string, required — Position size, always positive
    - `stop_loss` string, nullable — Stop loss price
    - `sub_account_address` string, required
    - `symbol` string, required
    - `take_profit` string, nullable — Take profit price
    - `trailing_stop` string, nullable — Trailing stop (The distance from market price)
    - `unrealized_funding` string, required — Net unsettled funding PnL for this position (receive positive, pay negative).
    - `unrealized_pnl` string, required — How much USDC an account will receive (or pay if negative) if the position is closed at the current MarkPrice
    - `updated_time` string, date-time, required — Position data updated timestamp (ms)
  - `next_page_cursor` string, required — Cursor. Use the next_page_cursor token from the response to retrieve the next page of the data set

---

[API](https://skmtc.net/ekidenfi/apis/ekiden-gateway.md) · [All operations](https://skmtc.net/ekidenfi/apis/ekiden-gateway/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/ekidenfi/ekiden-gateway/revisions/75ffe546b73a/schema)