Get positions

This endpoint allows users to get current positions.

GET /api/v1/positions

Query Parameters

Field	Type	Need	Description	Example
"account"	string	required	Connected wallet address	42trU9A5...

/api/v1/positions?account=42trU9A5...

Response

• Status 200: Successfully retrieved account information

  {
  "success": true,
  "data": [
    {
      "symbol": "AAVE",
      "side": "ask",
      "amount": "223.72",
      "entry_price": "279.283134",
      "margin": "0", // only shown for isolated margin
      "funding": "13.159593",
      "isolated": false,
      "liquidation_price": null,
      "created_at": 1754928414996,
      "updated_at": 1759223365538
    }
  ],
  "error": null,
  "code": null,
  "last_order_id": 1557431179
}

Field	Type	Description
"symbol"	string	Trading pair symbol
"side"	string	Position side: bid (long) or ask (short)
"amount"	decimal string	Position size in the asset's base unit
"entry_price"	decimal string	Entry price of the position. Takes VWAP if position was opened by multiple trades executed at different prices.
"margin"	decimal string	Amount of margin allocated to an isolated position (only shown when isolated)
"funding"	decimal string	Funding paid by this position since open
"isolated"	boolean	If the position is opened in isolated margin mode
"liquidation_price"	decimal string or null	Estimated liquidation price for the position. null if not applicable
"created_at"	integer	Timestamp in milliseconds when the position was opened
"updated_at"	integer	Timestamp in milliseconds when these settings were last updated
"last_order_id"	integer	Exchange-wide nonce. Used to reliably determine exchange event ordering. Sequential and not subject to clock drift.

• Status 400: Invalid request parameters

• Status 401: Unauthorized access

• Status 500: Internal server error

Code Example (Python)

import requests

response = requests.get(
    "/api/v1/positions?account=42trU9A5...",
    headers={"Accept": "*/*"},
)

data = response.json()