查看账户订单历史

请求地址

GET /ftapi/v1/orderHis

请求参数

名称	类型	是否必须	描述
symbolId	STRING	NO	交易对
orderId	LONG	NO	订单ID
startTime	LONG	NO	开始时间（毫秒）
endTime	LONG	NO	结束时间（毫秒）
limit	INT	NO	返回条数限制，最大值1000

响应参数

参数名	类型	描述
code	string	响应代码
msg	string	响应消息
success	boolean	是否成功
data	array	订单列表
data.amount	string	剩余金额（未成交部分金额）
data.avgPrice	string	平均成交价
data.cancelAmount	string	撤单金额
data.cancelQuantity	string	撤单数量
data.cancelReason	integer	撤单原因：1=用户主动，2=系统等
data.conditionOrderId	string	条件单ID（若非条件单为空）
data.feeAmount	string	实际产生的手续费
data.feeAssetId	string	手续费币种代码
data.feeRateMaker	string	Maker 手续费率（挂单成交）
data.feeRateTaker	string	Taker 手续费率（吃单成交）
data.id	string	订单唯一ID（long转字符串）
data.leverage	integer	杠杆倍数（如 20x）
data.liquidationFeeRate	string	强平手续费率（若非强平单为空）
data.lockAssetId	string	冻结保证金币种
data.locked	string	冻结保证金数量
data.marginMode	string	保证金模式：CROSSED=全仓，ISOLATED=逐仓
data.mtime	long	最后更新时间（毫秒时间戳）
data.orderTime	long	下单时间（毫秒时间戳）
data.positionId	string	持仓ID（无持仓为0）
data.positionMode	string	持仓模式：HEDGE=双向持仓，ONEWAY=单向
data.postOnly	integer	是否 Post Only：1=是，0=否
data.price	string	委托价格
data.profit	string	盈亏（仅平仓订单有效）
data.quantity	string	剩余未成交数量
data.reduceOnly	integer	是否只减仓：1=是，0=否
data.releasedLock	string	已释放的保证金数量
data.reverseOrder	integer	是否反手单：1=是，0=否
data.side	string	买卖方向：BUY=买入/做多，SELL=卖出/做空
data.slPrice	string	止损价格
data.slType	string	止损类型（如1=限价止损，2=市价止损）
data.source	integer	来源：0=用户，2=系统强平，10=反手单
data.status	string	状态：NEW=新建，FILLED=已成交，CANCELED=已撤单
data.symbolId	string	交易对标识（例如 BTC-USDT 合约）
data.timeInForce	string	有效时间策略：GTC=一直有效，IOC=立即成交或取消
data.totalAmount	string	订单总金额（price * totalQuantity）
data.totalQuantity	string	订单总数量
data.tpPrice	string	止盈价格
data.tpType	string	止盈类型（1=限价止盈，2=市价止盈）
data.tradeAmount	string	已成交金额
data.tradeQuantity	string	已成交数量
data.type	string	订单类型：LIMIT=限价，MARKET=市价
data.uid	string	用户ID

请求示例


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

响应示例


{
  "code": "0",
  "data": [
    {
      "amount": "0",                      // 剩余金额（未成交部分金额）
      "avgPrice": null,                   // 平均成交价
      "cancelAmount": "11270.64068",      // 撤单金额
      "cancelQuantity": "0.1084",         // 撤单数量
      "cancelReason": 1,                  // 撤单原因：1=用户主动，2=系统等
      "conditionOrderId": "",             // 条件单ID（若非条件单为空）
      "feeAmount": "0",                   // 实际产生的手续费
      "feeAssetId": "USDT",               // 手续费币种代码
      "feeRateMaker": "0.0003",           // Maker 手续费率（挂单成交）
      "feeRateTaker": "0.0005",           // Taker 手续费率（吃单成交）
      "id": "111469309137522688",         // 订单唯一ID（long转字符串）
      "leverage": 20,                     // 杠杆倍数（如 20x）
      "liquidationFeeRate": null,         // 强平手续费率（若非强平单为空）
      "lockAssetId": "USDT",              // 冻结保证金币种
      "locked": "563.532034",             // 冻结保证金数量
      "marginMode": "CROSSED",            // 保证金模式：CROSSED=全仓，ISOLATED=逐仓
      "mtime": 1762237162020,             // 最后更新时间（毫秒时间戳）
      "orderTime": 1762237154298,         // 下单时间（毫秒时间戳）
      "positionId": "0",                  // 持仓ID（无持仓为0）
      "positionMode": "HEDGE",            // 持仓模式：HEDGE=双向持仓，ONEWAY=单向
      "postOnly": 0,                      // 是否 Post Only：1=是，0=否
      "price": "103972.7",                // 委托价格
      "profit": "0",                      // 盈亏（仅平仓订单有效）
      "quantity": "0",                    // 剩余未成交数量
      "reduceOnly": 0,                    // 是否只减仓：1=是，0=否
      "releasedLock": "563.532034",       // 已释放的保证金数量
      "reverseOrder": 0,                  // 是否反手单：1=是，0=否
      "side": "BUY",                      // 买卖方向：BUY=买入/做多，SELL=卖出/做空
      "slPrice": null,                    // 止损价格
      "slType": null,                     // 止损类型（如1=限价止损，2=市价止损）
      "source": 0,                        // 来源：0=用户，2=系统强平，10=反手单
      "status": "CANCELED",               // 状态：NEW=新建，FILLED=已成交，CANCELED=已撤单
      "symbolId": "BTC-USDT-M",           // 交易对标识（例如 BTC-USDT 合约）
      "timeInForce": "GTC",               // 有效时间策略：GTC=一直有效，IOC=立即成交或取消
      "totalAmount": "11270.64068",       // 订单总金额（price * totalQuantity）
      "totalQuantity": "0.1084",          // 订单总数量
      "tpPrice": null,                    // 止盈价格
      "tpType": null,                     // 止盈类型（1=限价止盈，2=市价止盈）
      "tradeAmount": "0",                 // 已成交金额
      "tradeQuantity": "0",               // 已成交数量
      "type": "LIMIT",                    // 订单类型：LIMIT=限价，MARKET=市价
      "uid": "76957286"                   // 用户ID
    }
  ],
  "msg": "Request successful",
  "success": true
}

错误码解释

代码	描述
500	系统内部错误

查看账户订单历史

请求地址

请求参数

响应参数

请求示例

响应示例

错误码解释

代码示例