获取订单信息

描述

通过orderId或者clientOid获取订单详情

HTTP请求

• GET /api/v3/trade/order-info
• 限频规则: 20次/秒/UID
• 需要统一账户交易只读/读写权限

请求示例

curl "https://api.bitget.com/api/v3/trade/order-info?orderId=1233965375251996672" \
  -H "ACCESS-KEY:your apiKey" \
  -H "ACCESS-SIGN:*" \
  -H "ACCESS-PASSPHRASE:*" \
  -H "ACCESS-TIMESTAMP:1659076670000" \
  -H "locale:zh-CN" \
  -H "Content-Type: application/json" 

请求参数

参数名	参数类型	是否必须	描述
orderId	String	否	订单号 clientOid和orderId必传其一。如同时传参，则orderId优先级更高
clientOid	String	否	自定义订单号 clientOid和orderId必传其一。如同时传参，则orderId优先级更高

返回示例

{
  "code": "00000",
  "msg": "success",
  "requestTime": 1730369201783,
  "data": {
    "orderId": "111111111111111111",
    "clientOid": "111111111111111111",
    "category": "SPOT",
    "symbol": "ETHUSDT",
    "orderType": "market",
    "side": "buy",
    "price": "0",
    "qty": "0",
    "amount": "100",
    "cumExecQty": "0.0372",
    "cumExecValue": "99.853356",
    "avgPrice": "2684.23",
    "timeInForce": "gtc",
    "orderStatus": "filled",
    "posSide": "",
    "tradeSide": "open",
    "holdMode": "",
    "reduceOnly": "NO",
    "feeDetail": [
      {
        "feeCoin": "ETH",
        "fee": "0.00000744"
      }
    ],
    "cancelReason": "",
    "execType": "",
    "createdTime": "1730295766596",
    "updatedTime": "1730295766691"
  }
}

返回参数

返回字段	参数类型	字段说明
orderId	String	订单ID
clientOid	String	自定义订单ID
category	String	产品类型 SPOT 现货交易 MARGIN 杠杆交易 USDT-FUTURES U本位合约 COIN-FUTURES 币本位合约 USDC-FUTURES USDC合约
symbol	String	交易对名称
price	String	委托价格
qty	String	委托数量 单位为base coin
amount	String	委托金额 单位为quote coin
orderType	String	订单类型 limit: 限价 market: 市价
cumExecQty	String	累计成交数量 单位为base coin
cumExecValue	String	累计成交价值 单位为quote coin
avgPrice	String	平均成交价
orderStatus	String	订单状态 live: 订单已创建 new: 订单已进入撮合 partially_filled: 部分成交 filled: 全部成交 cancelled: 已撤销
side	String	开单方向 buy: 买 sell: 卖
timeInForce	String	订单执行策略 ioc: 无法立即成交的部分就撤销 fok: 无法全部立即成交就撤 gtc: 普通订单, 订单会一直有效，直到被成交或者取消 post_only: 只做maker
posSide	String	仓位方向 long: 开 short: 平 只适用合约订单
tradeSide	String	交易方向 open: 开 close : 平 详细枚举可以在 枚举 页面获取
holdMode	String	持仓模式 one_way_mode: 单向持仓 hedge_mode: 双向持仓 只适用合约订单
stpMode	String	STP模式（自成交预防） none：不设置STP（默认值） cancel_taker：取消taker单 cancel_maker：取消maker单 cancel_both：两者都取消
reduceOnly	String	是否减仓单 YES: 是 NO: 否 只适用合约订单
feeDetail	Array	手续费明细
> feeCoin	String	手续费币种
> fee	String	总计手续费
cancelReason	String	撤销原因 normal_cancel: 常规取消 详细枚举可以在 枚举 页面获取
execType	String	执行类型 normal: 常规成交 offset: 轧差订单 reduce: 强制减仓单 liquidation: 爆仓单 delivery: 交割订单
createdTime	String	订单创建时间 Unix时间戳，毫秒
updatedTime	String	订单更新时间 Unix时间戳，毫秒