BIbinibit
Futures · Trading

Your futures positions

Changed on

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 }.

get/api/futures/trade/positions

Request

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

Query parameters

CurrencyPairstring

Restrict to one pair, e.g. BTC_USDT. Omit for every pair.

Pageinteger

1-based page number; values below 1 fall back to 1.

PageSizeinteger

Positions per page; values below 1 fall back to 100; capped at 1000.

DateFromstring date-time

Include only positions opened at or after this moment (UTC).

DateTostring date-time

Include only positions opened at or before this moment (UTC).

FuturesAccountIdstring uuid

Restrict to one Unified Trading Account. Omit to search across all of the caller's accounts.

IsActiveboolean

True returns currently open positions, false returns closed ones. There is no "both": the two are separate states, so ask twice if you need each.

Headers

Your API key, verbatim. Create one at https://azbit.com/dashboard/settings/api-settings.

Signature of THIS request — lower-case hex of HMAC-SHA256 over publicKey + fullUrl + body, keyed with your private key. It changes with every request, so it cannot be set once and reused. Full algorithm and code samples are at the top of this page.

Response

OK

currentPageinteger
pageSizeinteger
totalCountinteger
totalPagesinteger
hasPreviousPageboolean
hasNextPageboolean

Changes