---
title: "Get Positions"
method: POST
path: "/trading/positions"
tags: ["Trading"]
---

# Get Positions

`POST /trading/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

## Request body

- PositionFilterRequest — Request model for filtering positions
  - `limit` integer — Number of items per page
  - `cursor` string, nullable — Cursor for next page
  - `account_names` string[], nullable — List of account names to filter by
  - `connector_names` string[], nullable — List of connector names to filter by

## Response `200`

Successful Response

- PaginatedResponse — Generic paginated response.
  - `data` object[], required
  - `pagination` object, required

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/hummingbot/apis/hummingbot-api.md) · [All operations](https://skmtc.net/hummingbot/apis/hummingbot-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/hummingbot/hummingbot-api/versions/5347fe79537f/schema)