Futures · Trading

Search your futures orders

Changed on

Filter by pair, account, date range and status. This is also where OPEN orders come from: ask for status 10 (Created) to get limit orders that have not filled yet — the positions endpoint cannot return them, as it only ever reports open (50) or closed (20) positions. The response is a page { items, currentPage, pageSize, totalCount, totalPages, hasPreviousPage, hasNextPage }.

get/api/futures/trade/orders-history

Request

  • Base URL
    https://api.binibit.com
  • URL
    https://api.binibit.com/api/futures/trade/orders-history
  • 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

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

DateFromstring date-time

Include only orders created at or after this moment (UTC).

DateTostring date-time

Include only orders created at or before this moment (UTC).

StatusesFuturesOrderStatus[]

Lifecycle stages to include; repeat the parameter for several. 10 alone returns the resting orders that have not filled yet.

FuturesAccountIdstring uuid

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

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