Skip to main content
GET
/
api
/
v1
/
position
/
list
Get Position Info
curl --request GET \
  --url https://api.ekiden.fi/api/v1/position/list \
  --header 'Authorization: Bearer <token>'
{
  "list": [
    {
      "avg_price": "<string>",
      "bust_price": "<string>",
      "created_time": "1672531200000",
      "cum_funding": "<string>",
      "is_reduce_only": true,
      "leverage": "<string>",
      "liq_price": "<string>",
      "mark_price": "<string>",
      "position_balance": "<string>",
      "position_im": "<string>",
      "position_im_by_mp": "<string>",
      "position_mm": "<string>",
      "position_mm_by_mp": "<string>",
      "position_value": "<string>",
      "realized_pnl_cum": "<string>",
      "realized_pnl_cur": "<string>",
      "risk_id": 1,
      "risk_limit_value": "<string>",
      "seq": 1,
      "size": "<string>",
      "sub_account_address": "<string>",
      "symbol": "BTCUSDC",
      "unrealized_funding": "<string>",
      "unrealized_pnl": "<string>",
      "updated_time": "1672531200000",
      "leverage_sys_updated_time": "1672531200000",
      "mmr_sys_update_time": "1672531200000",
      "stop_loss": "<string>",
      "take_profit": "<string>",
      "trailing_stop": "<string>"
    }
  ],
  "next_page_cursor": "<string>"
}

Documentation Index

Fetch the complete documentation index at: https://docs.ekiden.fi/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

​
sub_account_address
string
required

Trading vault address (subaccount) to query against.

​
symbol
null | string
Example:

"BTCUSDC"

​
limit
integer<int32> | null
Required range: x >= 0
​
cursor
string | null

Response

200 - application/json

Positions

Position info response.

​
list
object[]
required
​
next_page_cursor
string
required

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