---
title: "Your futures orders and positions"
method: GET
path: "/futures/user-orders"
tags: ["WebSockets · Your account"]
---

# Your futures orders and positions

`GET /futures/user-orders`

## Request

- Base URL: `wss://ws.azbit.com`
- URL: `wss://ws.azbit.com/futures/user-orders`
- Auth: none declared. Required headers: `API-PublicKey`, `API-Signature`

Not a REST call: this is the WebSocket **handshake**. Connect to the URL below and the exchange answers
`101 Switching Protocols`; everything after that is frames, not requests.

Every state change of your futures orders on every Unified Trading Account you own: placed, filled,
take-profit or stop-loss updated, closed, and liquidated.

**No subscribe frame.** The authenticated handshake binds this socket to your user. Each frame has the same
shape as `GET /api/futures/trade/orders-history`:

```json
{
  "id": "01K5P8F9M3Q2Y7Z0K6J4N8R1ST",
  "clientOrderId": "strategy-42",
  "updateTimestamp": "2026-09-21T09:15:42.117Z",
  "price": 64180.5,
  "amount": 0.012,
  "currencyPairCode": "BTC_USDT",
  "realizedPnl": 4.25,
  "isLong": true,
  "filled": 0.012,
  "futuresOrderStatus": 50
}
```

`futuresOrderStatus` distinguishes a resting order (`Created`) from an open position (`InPosition`) and a
closed one (`PositionClosed`). Mark-price ticks are not pushed: `unRealizedPnl` and `liquidationPrice` are as
of the last order change, just as in the REST read. Reconcile with
`GET /api/futures/trade/orders-history` after reconnecting.

## Query parameters

- `timestamp` integer, required

## Headers

- `API-PublicKey` string, required
- `API-Signature` string, required

## Other responses

- `101`: Switching Protocols — the socket is open.
- `401`: Headers missing, key unknown, signature wrong, or `timestamp` missing or stale.
- `403`: Key valid but refused: caller IP outside the key's whitelist, or the key lacks the User info permission.
- `503`: Authentication or the selected event feed is temporarily unavailable — retry; do not rotate your key.

## Changes

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

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