---
title: "Get an order by exchange id"
method: GET
path: "/api/futures/trade/orders/{orderId}"
tags: ["Futures · Trading"]
---

# Get an order by exchange id

`GET /api/futures/trade/orders/{orderId}`

## Request

- Base URL: `https://api.binibit.com`
- URL: `https://api.binibit.com/api/futures/trade/orders/{orderId}`
- Auth: none declared

Returns any status (10/20/30/40/50), including orders that never became positions.

## Path parameters

- `orderId` string, required

## Response `200`

OK

- FuturesOrderDto: A futures order and, once it fills, the position it became. The same object carries both: an order resting at PublicApi.Models.Futures.FuturesOrderStatus.Created has no position figures yet, and one at PublicApi.Models.Futures.FuturesOrderStatus.InPosition has them live.
  - `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.

## Other responses

- `404`: Not Found

## Changes

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

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