---
title: "Your futures positions"
method: GET
path: "/api/futures/trade/positions"
tags: ["Futures · Trading"]
---

# Your futures positions

`GET /api/futures/trade/positions`

## Request

- Base URL: `https://api.binibit.com`
- URL: `https://api.binibit.com/api/futures/trade/positions`
- Auth: none declared

Open positions by default; pass `isActive=false` for closed ones. Unfilled orders never
            appear here whatever the filters say — search the orders history with status `10` for those. The
            response is a page { items, currentPage, pageSize, totalCount, totalPages, hasPreviousPage, hasNextPage }.

## Query parameters

- `CurrencyPair` string
- `Page` integer
- `PageSize` integer
- `DateFrom` string, date-time
- `DateTo` string, date-time
- `FuturesAccountId` string, uuid
- `IsActive` boolean

## Response `200`

OK

- FuturesOrderDtoPagedList
  - `items` FuturesOrderDto[], nullable
    - `id` string, nullable: Order identifier assigned by the exchange. Pass it to the close/cancel and stop-loss endpoints.
    - `clientOrderId` string, nullable: The identifier you supplied on creation, echoed back. Null when none was sent.
    - `createTimestamp` string, date-time: When the order was accepted (UTC).
    - `updateTimestamp` string, date-time: When the order last changed — a fill, a stop move, a close (UTC).
    - `price` number, double, nullable: Limit price for a limit order; for a filled position, the entry price. Null on a market order that has not filled yet.
    - `amount` number, double: Order size in the pair's base asset.
    - `currencyPairCode` string, nullable: Pair this order belongs to, e.g. `BTC_USDT`.
    - `takeProfit` number, double, nullable: Take-profit trigger price attached to this order, or null if none is set. This is a level ON the order — it never appears as a separate order in the history.
    - `stopLoss` number, double, nullable: Stop-loss trigger price attached to this order, or null if none is set. Like take-profit, a level on the order rather than an order of its own.
    - `realizedPnl` number, double: Profit or loss already booked on this position, in the settlement currency. Grows as the position is closed in parts; final once the status is PublicApi.Models.Futures.FuturesOrderStatus.PositionClosed.
    - `leverage` number, double: Leverage the position was opened with.
    - `isLong` boolean: True for a long (buy) position, false for a short (sell) one.
    - `isMarket` boolean: True if the order was submitted at market, false if it carries a limit PublicApi.Models.Futures.FuturesOrderDto.Price.
    - `liquidationPrice` number, double: Price at which this position would be liquidated. Moves as margin is added or PnL accrues.
    - `filled` number, double: How much of PublicApi.Models.Futures.FuturesOrderDto.Amount has been executed so far. Zero while the order is resting.
    - `fee` number, double: Trading fee charged on this order so far, in PublicApi.Models.Futures.FuturesOrderDto.FeeAsset. Funding is reported separately in PublicApi.Models.Futures.FuturesOrderDto.FundingFee.
    - `feeAsset` string, nullable: Asset the PublicApi.Models.Futures.FuturesOrderDto.Fee was charged in. Null if nothing has been charged yet.
    - `amountInPosition` number, double: Size currently held open, in the base asset. Falls below PublicApi.Models.Futures.FuturesOrderDto.Amount as the position is closed in parts, and reaches zero when it is fully closed.
    - `futuresOrderStatus` 10 | 20 | 30 | 40 | 50: Where a futures order is in its life. This says nothing about what KIND of order it is — limit versus market is `isMarket`, and buy versus sell is `isLong`.
    - `fundingFee` number, double: Total funding paid (positive) or received (negative) while this position has been open.
    - `initialMargin` number, double: Margin committed when the position opened. The denominator of both percentage figures below.
    - `currentMargin` number, double: Margin backing the position right now, after PnL and any margin changes.
    - `unRealizedPnl` number, double: Profit or loss on the still-open part of the position at the current mark price.
    - `unRealizedPnlPercentage` number, double: Unrealized PnL as a percentage of PublicApi.Models.Futures.FuturesOrderDto.InitialMargin. Zero when the initial margin is zero rather than an error.
    - `totalPnlPercentage` number, double: Realized plus unrealized PnL as a percentage of PublicApi.Models.Futures.FuturesOrderDto.InitialMargin — the whole result of the position so far, where PublicApi.Models.Futures.FuturesOrderDto.UnRealizedPnlPercentage covers only the open part.
    - `roe` number, double: Reserved: the exchange currently reports 0 here for every order. Use PublicApi.Models.Futures.FuturesOrderDto.TotalPnlPercentage for return on margin.
  - `currentPage` integer
  - `pageSize` integer
  - `totalCount` integer
  - `totalPages` integer
  - `hasPreviousPage` boolean
  - `hasNextPage` boolean

## Changes

- **2026-10-13** `13dbac1613c4`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/binibit/apis/webapp/changes/api/futures/trade/positions/get.md)

---

[API](https://skmtc.dev/binibit/apis/webapp.md) - [All operations](https://skmtc.dev/binibit/apis/webapp/llms.txt) - [OpenAPI document](https://skmtc.dev/binibit/apis/webapp/revisions/13dbac1613c4?raw)