Skip to Content
📈 Futures APITrading APIQuery Account Order History

Query Account Order History

Request URL

GET /ftapi/v1/orderHis

Request Parameters

NameTypeRequiredDescription
symbolIdSTRINGNOTrading pair
orderIdLONGNOOrder ID
startTimeLONGNOStart time (milliseconds)
endTimeLONGNOEnd time (milliseconds)
limitINTNONumber of results, max 1000

Response Parameters

NameTypeDescription
codeSTRINGResponse Code
msgSTRINGResponse Message
successBOOLEANSuccess Flag
data[].amountSTRING
data[].avgPriceSTRING
data[].cancelAmountSTRING
data[].cancelQuantitySTRING
data[].cancelReasonINTEGER
data[].conditionOrderIdSTRING
data[].feeAmountSTRING
data[].feeAssetIdSTRING
data[].feeRateMakerSTRING
data[].feeRateTakerSTRING
data[].idSTRING
data[].leverageINTEGER
data[].liquidationFeeRateSTRING
data[].lockAssetIdSTRING
data[].lockedSTRING
data[].marginModeSTRING
data[].mtimeINTEGER
data[].orderTimeINTEGER
data[].positionIdSTRING
data[].positionModeSTRING
data[].postOnlyINTEGER
data[].priceSTRING
data[].profitSTRING
data[].quantitySTRING
data[].reduceOnlyINTEGER
data[].releasedLockSTRING
data[].reverseOrderINTEGER
data[].sideSTRING
data[].slPriceSTRING
data[].slTypeSTRING
data[].sourceINTEGER
data[].statusSTRING
data[].symbolIdSTRING
data[].timeInForceSTRING
data[].totalAmountSTRING
data[].totalQuantitySTRING
data[].tpPriceSTRING
data[].tpTypeSTRING
data[].tradeAmountSTRING
data[].tradeQuantitySTRING
data[].typeSTRING
data[].uidSTRING

Request Example

https://openapi.bittap.com/ftapi/v1/orderHis?symbol=BTC-USDT-M

Response Example

{
  "code": "0",
  "data": [
    {
      "amount": "0",                      // Remaining amount (unfilled portion amount)
      "avgPrice": null,                   // Average fill price
      "cancelAmount": "11270.64068",      // Cancel amount
      "cancelQuantity": "0.1084",         // Cancel quantity
      "cancelReason": 1,                  // Cancel reason: 1=user initiated, 2=system, etc.
      "conditionOrderId": "",             // Conditional order ID (empty if not conditional order)
      "feeAmount": "0",                   // Actual fee generated
      "feeAssetId": "USDT",               // Fee currency code
      "feeRateMaker": "0.0003",           // Maker fee rate (maker fill)
      "feeRateTaker": "0.0005",           // Taker fee rate (taker fill)
      "id": "111469309137522688",         // Order unique ID (long converted to string)
      "leverage": 20,                     // Leverage (e.g., 20x)
      "liquidationFeeRate": null,         // Liquidation fee rate (empty if not liquidation order)
      "lockAssetId": "USDT",              // Locked margin currency
      "locked": "563.532034",             // Locked margin amount
      "marginMode": "CROSSED",            // Margin mode: CROSSED=cross margin, ISOLATED=isolated margin
      "mtime": 1762237162020,             // Last update time (millisecond timestamp)
      "orderTime": 1762237154298,         // Order time (millisecond timestamp)
      "positionId": "0",                  // Position ID (0 if no position)
      "positionMode": "HEDGE",            // Position mode: HEDGE=hedge mode, ONEWAY=one-way mode
      "postOnly": 0,                      // Post only: 1=yes, 0=no
      "price": "103972.7",                // Order price
      "profit": "0",                      // PnL (only valid for closed orders)
      "quantity": "0",                    // Remaining unfilled quantity
      "reduceOnly": 0,                    // Reduce only: 1=yes, 0=no
      "releasedLock": "563.532034",       // Released margin amount
      "reverseOrder": 0,                  // Reverse order: 1=yes, 0=no
      "side": "BUY",                      // Buy/sell direction: BUY=buy/long, SELL=sell/short
      "slPrice": null,                    // Stop loss price
      "slType": null,                     // Stop loss type (e.g., 1=limit stop loss, 2=market stop loss)
      "source": 0,                        // Source: 0=user, 2=system liquidation, 10=reverse order
      "status": "CANCELED",               // Status: NEW=new, FILLED=filled, CANCELED=canceled
      "symbolId": "BTC-USDT-M",           // Trading pair identifier (e.g., BTC-USDT contract)
      "timeInForce": "GTC",               // Time in force strategy: GTC=good till canceled, IOC=immediate or cancel
      "totalAmount": "11270.64068",       // Total order amount (price * totalQuantity)
      "totalQuantity": "0.1084",          // Total order quantity
      "tpPrice": null,                    // Take profit price
      "tpType": null,                     // Take profit type (1=limit take profit, 2=market take profit)
      "tradeAmount": "0",                 // Filled amount
      "tradeQuantity": "0",               // Filled quantity
      "type": "LIMIT",                    // Order type: LIMIT=limit, MARKET=market
      "uid": "76957286"                   // User ID
    }
  ],
  "msg": "Request successful",
    "success": true
}

Error Codes

Error CodeDescription
500Server Error

Code Example

Last updated on:
Cancel All OrdersQuery Open Orders