---
title: "Your own futures trades"
method: GET
path: "/api/futures/deals/user"
tags: ["Futures · Market data"]
---

# Your own futures trades

`GET /api/futures/deals/user`

## Request

- Base URL: `https://api.binibit.com`
- URL: `https://api.binibit.com/api/futures/deals/user`
- Auth: none declared

Each fill you were party to, with the fee it cost and the PnL it booked. One order can produce
            several rows — one per fill — and only closing fills carry a non-zero realized PnL.

## Query parameters

- `CurrencyPair` string
- `Page` integer
- `PageSize` integer
- `DateFrom` string, date-time
- `DateTo` string, date-time

## Response `200`

OK

- FuturesUserDealDtoFuturesPagedResult: One page of results plus the size of the whole match.
  - `totalCount` integer: How many rows match the filters in total, across every page — not how many are in PublicApi.Models.Futures.FuturesPagedResult`1.Items. Divide by the page size to know how far you can page.
  - `items` FuturesUserDealDto[], nullable: Rows on the requested page. Empty once you page past the end.
    - `id` integer: Trade identifier.
    - `timestamp` string, date-time: When the trade executed (UTC).
    - `price` number, double: Price this fill executed at, which for a partially filled order differs from the order's price.
    - `amount` number, double: Size of this fill, in the pair's base asset.
    - `currencyPairCode` string, nullable: Pair traded, e.g. `BTC_USDT`.
    - `isLong` boolean: True if the position is long, false if short.
    - `fee` number, double: Fee charged on this fill, in PublicApi.Models.Futures.FuturesUserDealDto.FeeAsset. Funding is not here — it arrives as its own entry in the transaction history.
    - `feeAsset` string, nullable: Asset the fee was charged in.
    - `realizedPnl` number, double: Profit or loss booked by this fill. Non-zero only on fills that CLOSE part of a position — opening fills book nothing.
    - `tradeType` 10 | 20 | 30 | 40 | 50: What caused a trade. The first three close a position; the last two open one.
    - `orderId` string, nullable: Order this fill belongs to. Null when the trade has no order behind it, as with a liquidation.
    - `orderSide` 1 | 2: Direction of a trade. On a closing fill the side is the OPPOSITE of the position's direction — a long is closed by a sell — so read `isLong`, not this, to know which way the position points.

## Changes

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

[Operation history](https://skmtc.dev/binibit/apis/webapp/changes/api/futures/deals/user/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)