v13

latestOpenAPI 3.1.0raw.githubusercontent.com2026-04-0815390371.2 KB

Trading

Get Positions

Get current positions across all or filtered perpetual connectors.

This endpoint fetches real-time position data directly from the connectors, including unrealized PnL, leverage, funding fees, and margin information.

Args: filter_request: JSON payload with filtering criteria

Returns: Paginated response with position data and pagination metadata

Raises: HTTPException: 500 if there's an error fetching positions

post/trading/positions

limitinteger

Number of items per page

cursorstring nullable

Cursor for next page

account_namesstring[] nullable

List of account names to filter by

connector_namesstring[] nullable

List of connector names to filter by

Successful Response

dataobject[] required

paginationobject required

{
  "data": [],
  "pagination": {
    "has_more": true,
    "limit": 100,
    "next_cursor": "2024-01-10T12:00:00",
    "total_count": 500
  }
}