合约 · 交易

经典账户 — 合约 · 交易

下单

POST

https://api.bitget.com

/api/v2/mix/order/place-order

普通用户:限速10次/秒，根据uid限频

单向持仓时，必须省略tradeSide参数；单向持仓时，如果新的reduceOnly单size和现存的reduceOnly单size总和大于仓位size的情况下，会按当前reduceOnly单的创建顺序依次取消挂单，直至新的reduceOnly的size和现存的reduceOnly单的size总和小于等于仓位size。并且最新的reduceOnly单的请求响应不会包含orderId，可以通过在请求中添加clientOid查询订单详情或者获取当前委托接口查看orderId。双向持仓时，开多规则为：side=buy,tradeSide=open；开空规则为：side=sell,tradeSide=open；平多规则为：side=buy,tradeSide=close；平空规则为：side=sell,tradeSide=close 双向持仓时，如果有限价平仓单占用仓位，此时再下的市价平仓单的数量与限价单平仓的数量超过仓位数量时，不会报仓位不足错误，也不会取消已占用仓位的限价单，而是会直接把限价单平仓的数量保留，平掉仓位数量减去限价单平仓的数量后的数量。例如：仓位数量100，限价单占用70，此时再下50数量的市价单平仓时不会报错仓位不足，也不会取消占用仓位的限价单执行市价单，而是会直接平掉30数量。双向持仓时，若已有数量等于持仓的限价平仓单，新增平仓单会自动取消已占用仓位的限价单。为确保带单操作顺利进行，使用新版交易专家的带单 API Key 下单时，请严格按照交易专家可以带单的币对及参数中的币对范围执行。超出公告列表的币对不支持带单下单

API Broker返佣标识:

需在HTTP Header请求头中添加如下代码块

"X-CHANNEL-API-CODE":"your-channel-api-code"

下单 › Request Parameters

symbol

string · required

交易对名称如:"ETHUSDT"

productType

string · required

产品类型 USDT-FUTURES U本位合约 COIN-FUTURES 币本位合约 USDC-FUTURES USDC合约

marginMode

string · required

仓位模式 isolated: 逐仓 crossed: 全仓

marginCoin

string · required

保证金币种(大写), 如:USDT

size

string · required

下单数量(基础币) 数量小数位可以通过获取合约信息接口获取

side

string · required

交易方向 buy: 单向持仓时代表买入，双向持仓时代表多头方向 sell: 单向持仓时代表卖出，双向持仓时代表空头方向

orderType

string · required

订单类型 limit: 限价单， market: 市价单

price

string

下单价格。 orderType为limit时必填价格小数位可以通过获取合约信息接口获取

tradeSide

string

交易类型(仅限双向持仓) 双向持仓模式下必填，单向持仓时不要填，否则会报错 open: 开仓 close: 平仓

force

string

订单有效期 ioc: 无法立即成交的部分就撤销 fok: 无法全部立即成交就撤销 gtc: 普通订单, 订单会一直有效，直到被成交或者取消 post_only: 只做maker "orderType"为limit限价单时必填，若省略则默认为gtc

clientOid

string

自定义订单id

reduceOnly

string

只减仓(仅适用单向持仓模式下) YES NO(默认)

presetStopSurplusPrice

string

预设止盈值为空则默认不设止盈。

presetStopLossPrice

string

预设止损值为空则默认不设止损。

presetStopSurplusExecutePrice

string

预设止盈执行价格

presetStopLossExecutePrice

string

预设止损执行价格

stpMode

string

STP模式（自成交预防） none：不设置STP（默认值） cancel_taker：取消taker单 cancel_maker：取消maker单 cancel_both：两者都取消

下单 › Response Parameters

200

Successful response

code

string

msg

string

requestTime

integer

object

orderId

string

订单id

clientOid

string

自定义订单id

POST/api/v2/mix/order/place-order

curl https://api.bitget.com/api/v2/mix/order/place-order \
  --request POST \
  --header 'Content-Type: application/json' \
  --data '{
  "symbol": "symbol",
  "productType": "productType",
  "marginMode": "marginMode",
  "marginCoin": "marginCoin",
  "size": "size",
  "price": "price",
  "side": "side",
  "tradeSide": "tradeSide",
  "orderType": "orderType",
  "force": "force",
  "clientOid": "clientOid",
  "reduceOnly": "reduceOnly",
  "presetStopSurplusPrice": "presetStopSurplusPrice",
  "presetStopLossPrice": "presetStopLossPrice",
  "presetStopSurplusExecutePrice": "presetStopSurplusExecutePrice",
  "presetStopLossExecutePrice": "presetStopLossExecutePrice",
  "stpMode": "stpMode"
}'

Example Request Body

{
  "symbol": "symbol",
  "productType": "productType",
  "marginMode": "marginMode",
  "marginCoin": "marginCoin",
  "size": "size",
  "price": "price",
  "side": "side",
  "tradeSide": "tradeSide",
  "orderType": "orderType",
  "force": "force",
  "clientOid": "clientOid",
  "reduceOnly": "reduceOnly",
  "presetStopSurplusPrice": "presetStopSurplusPrice",
  "presetStopLossPrice": "presetStopLossPrice",
  "presetStopSurplusExecutePrice": "presetStopSurplusExecutePrice",
  "presetStopLossExecutePrice": "presetStopLossExecutePrice",
  "stpMode": "stpMode"
}

json

Example Responses

{
  "code": "00000",
  "msg": "success",
  "requestTime": 1695806875837,
  "data": {
    "clientOid": "121211212122",
    "orderId": "121211212122"
  }
}

json

application/json

一键反手

POST

https://api.bitget.com

/api/v2/mix/order/click-backhand

普通用户限速10次/S 根据uid限频交易员限速1次/S 根据uid限频

side和tradeSide： - 单向持仓时，不可以传tradeSide参数。 - 双向持仓时，tradeSide必填。 - 反手当前的多仓,开空仓：side=buy，tradeSide=open。 - 反手当前的空仓，开多仓：Side =sell，tradeSide=open。 size:代表反手数量。 - 单向持仓时：忽略该参数，会将整个仓位数量反向开仓。 - 双向持仓时： - 若传入数量小于当前仓位数量：当前仓位数量会按传入数量减持，并按传入数量反向开仓。例如当前存在多仓ETHUSDT仓位，持仓数为20，传入数为3，那么当前多仓会减持3个ETH成为17 个，并反向3个数量的空仓。 - 若传入数量大于或等于当前仓位数量：会直接按当前仓位持仓数反向持仓。例如当前存在多仓ETHUSDT仓位，持仓数为10，传入数为11或10，那么当前仓位会反向开10个数量的空仓。

API Broker返佣标识:

需在HTTP Header请求头中添加如下代码块

"X-CHANNEL-API-CODE":"your-channel-api-code"

一键反手 › Request Parameters

symbol

string · required

交易币对如:ethusdt

marginCoin

string · required

保证金币种

productType

string · required

产品类型 USDT-FUTURES U本位合约 COIN-FUTURES 币本位合约 USDC-FUTURES USDC合约

side

string · required

下单方向 buy 买 sell 卖

size

string

下单数量。 1.若不传，则按当前持仓数量反向开仓； 2.若传，单向持仓时：会先市价平仓掉当前仓位后按仓位数量市价买入。双向持仓时：若数量小于当前持仓数量，则会先按当前仓位持仓数减去传入数量，再去按传入数量反向市价开仓；若大于当前持仓数量，则只会按当前持仓数反向开仓。 3.单向持仓时为空，若传则无效。默认当前持仓数量反向持仓。

tradeSide

string

交易方向开平仓(双向持仓)模式下必填。双向持仓：反手当前的多仓，开空仓： Side 填写buy，tradeSide填写open。反手当前的空仓，开多仓： Side 填写sell，tradeSide填写open。单向持仓：单向持仓不填此参数

clientOid

string

自定义订单id

一键反手 › Response Parameters

200

Successful response

code

string

msg

string

requestTime

integer

object

orderId

string

订单id

clientOid

string

自定义订单id

批量下单

POST

https://api.bitget.com

/api/v2/mix/order/batch-place-order

普通用户:限速5次/秒，根据uid限频跟单交易员:限速1次/秒，根据uid限频

用于合约批量下单

单向持仓时，必须省略tradeSide参数；双向持仓时，开多规则为：side=buy,tradeSide=open；开空规则为：side=sell,tradeSide=open；平多规则为：side=buy,tradeSide=close；平空规则为：side=sell,tradeSide=close API Broker返佣标识:

需在HTTP Header请求头中添加如下代码块

"X-CHANNEL-API-CODE":"your-channel-api-code"

批量下单 › Request Parameters

symbol

string · required

交易对

productType

string · required

产品类型 USDT-FUTURES U本位合约 COIN-FUTURES 币本位合约 USDC-FUTURES USDC合约

marginCoin

string · required

保证金币种必须大写

marginMode

string · required

仓位模式 isolated：逐仓 crossed：全仓

object[] · required

下单集合。最大订单数(列表长度)：50

批量下单 › Response Parameters

200

Successful response

code

string

msg

string

requestTime

integer

object

object[]

成功单集合

object[]

失败单集合

result

boolean

是否全部成功。true：全部成功；false：至少有一笔失败

POST/api/v2/mix/order/batch-place-order

curl https://api.bitget.com/api/v2/mix/order/batch-place-order \
  --request POST \
  --header 'Content-Type: application/json' \
  --data '{
  "symbol": "symbol",
  "productType": "productType",
  "marginCoin": "marginCoin",
  "marginMode": "marginMode",
  "orderList": [
    {
      "size": "size",
      "price": "price",
      "side": "side",
      "tradeSide": "tradeSide",
      "orderType": "orderType",
      "force": "force",
      "clientOid": "clientOid",
      "reduceOnly": "reduceOnly",
      "presetStopSurplusPrice": "presetStopSurplusPrice",
      "presetStopLossPrice": "presetStopLossPrice",
      "stpMode": "stpMode"
    }
  ]
}'

Example Request Body

{
  "symbol": "symbol",
  "productType": "productType",
  "marginCoin": "marginCoin",
  "marginMode": "marginMode",
  "orderList": [
    {
      "size": "size",
      "price": "price",
      "side": "side",
      "tradeSide": "tradeSide",
      "orderType": "orderType",
      "force": "force",
      "clientOid": "clientOid",
      "reduceOnly": "reduceOnly",
      "presetStopSurplusPrice": "presetStopSurplusPrice",
      "presetStopLossPrice": "presetStopLossPrice",
      "stpMode": "stpMode"
    }
  ]
}

json

Example Responses

{
  "code": "00000",
  "data": {
    "successList": [
      {
        "orderId": "121211212122",
        "clientOid": "BITGET#121211212122"
      }
    ],
    "failureList": [],
    "result": true
  },
  "msg": "success",
  "requestTime": 1627293504612
}

json

application/json

修改订单

POST

https://api.bitget.com

/api/v2/mix/order/modify-order

普通用户10次/S 根据uid限频

修改订单接口，对于处于委托状态的订单进行修改，支持修改止盈止损及其size/price。

修改 size 和 price 会取消之前的订单，异步生成一个新订单, 修改预设止盈止损不会取消之前的订单。修改 size 和 price 时请一同传入，不能只传其中一个根据 orderId 或者 clientOId 修改订单价格，数量和预设止盈止损只允许修改未成交的限价单(部分成交亦不可修改)，如果修改订单的价格和数量则会取消之前订单重新生成一笔订单，如果 size 和 price 和预设止盈止损同时传入，则预设止盈止损不生效 修改限价单 price 和 size 请务必传入 newClientOid 因为新订单 orderId 无法同步返回, 因此需要根据 newClientOid 来帮助您查询订单信息修改订单数量需要满足最小下单数量如果只修改预设止盈止损，请不要传入 price 和 size ，只传止损或止盈则另外一个会被取消

修改订单 › Request Parameters

symbol

string · required

交易币对如:ethusdt

productType

string · required

产品类型 USDT-FUTURES U本位合约 COIN-FUTURES 币本位合约 USDC-FUTURES USDC合约

newClientOid

string · required

改单后的新自定义订单id

orderId

string

订单id 与clientOid两者必传其一，如果两个都传则以orderId 为主

clientOid

string

自定义订单id 与orderId两者必传其一，如果两个都传则以orderId 为主

newSize

string

修改的新交易数量为空不改变。

newPrice

string

修改的新下单价格。 1.已有订单类型为限价单(limit)时，若不传则保持原有价格。 2.订单类型为市价单（market)时，则不传。

newPresetStopSurplusPrice

string

修改的新止盈值 1.若为空，原有订单已设止盈则保持原有值 2.若不为空，原有订单已设止盈则更新止盈值；原有订单未设止盈则新增止盈项。若原先已有，传0则代表删除止盈。

newPresetStopLossPrice

string

修改的新止损值 1.若为空，原有订单已设止损则保持原有值 2.若不为空，原有订单已设止损则更新止盈值；原有订单未设止损则新增止损项。若原先已有，传0则代表删除止损。

修改订单 › Response Parameters

200

Successful response

code

string

msg

string

requestTime

integer

object

orderId

string

订单id

clientOid

string

自定义订单id

POST/api/v2/mix/order/modify-order

curl https://api.bitget.com/api/v2/mix/order/modify-order \
  --request POST \
  --header 'Content-Type: application/json' \
  --data '{
  "orderId": "orderId",
  "clientOid": "clientOid",
  "symbol": "symbol",
  "productType": "productType",
  "newClientOid": "newClientOid",
  "newSize": "newSize",
  "newPrice": "newPrice",
  "newPresetStopSurplusPrice": "newPresetStopSurplusPrice",
  "newPresetStopLossPrice": "newPresetStopLossPrice"
}'

Example Request Body

{
  "orderId": "orderId",
  "clientOid": "clientOid",
  "symbol": "symbol",
  "productType": "productType",
  "newClientOid": "newClientOid",
  "newSize": "newSize",
  "newPrice": "newPrice",
  "newPresetStopSurplusPrice": "newPresetStopSurplusPrice",
  "newPresetStopLossPrice": "newPresetStopLossPrice"
}

json

Example Responses

{
  "code": "00000",
  "data": {
    "orderId": "121212121212",
    "clientOid": "BITGET#1627293504612"
  },
  "msg": "success",
  "requestTime": 1627293504612
}

json

application/json

撤单

POST

https://api.bitget.com

/api/v2/mix/order/cancel-order

限速规则: 10次/1s

撤单 › Request Parameters

symbol

string · required

交易对

productType

string · required

产品类型 USDT-FUTURES U本位合约 COIN-FUTURES 币本位合约 USDC-FUTURES USDC合约

marginCoin

string

保证金币种必须大写

orderId

string

订单id orderId和clientOid必需提供一个。若都存在则以orderId为准。

clientOid

string

自定义订单id orderId和clientOid必需提供一个。若都存在则以orderId为准。

撤单 › Response Parameters

200

Successful response

code

string

msg

string

requestTime

integer

object

orderId

string

订单Id

clientOid

string

客户端自定义Id

批量撤单

POST

https://api.bitget.com

/api/v2/mix/order/batch-cancel-orders

普通用户10次/S 根据uid限频

撤单接口，可按产品类型、交易对名称进行撤单。

批量撤单 › Request Parameters

productType

string · required

产品类型 USDT-FUTURES U本位合约 COIN-FUTURES 币本位合约 USDC-FUTURES USDC合约

object[]

订单id集合。最大长度：50 若传递，symbol不可为空，且需与symbol/productType对齐

symbol

string

交易对如:ethusdt 当传入orderIdList参数时，此参数为必传

marginCoin

string

保证金币种必须大写

批量撤单 › Response Parameters

200

Successful response

code

string

msg

string

requestTime

integer

object

object[]

所撤成功单集合。

object[]

所撤失败单集合。

POST/api/v2/mix/order/batch-cancel-orders

curl https://api.bitget.com/api/v2/mix/order/batch-cancel-orders \
  --request POST \
  --header 'Content-Type: application/json' \
  --data '{
  "orderIdList": [
    {
      "orderId": "orderId",
      "clientOid": "clientOid"
    }
  ],
  "symbol": "symbol",
  "productType": "productType",
  "marginCoin": "marginCoin"
}'

Example Request Body

{
  "orderIdList": [
    {
      "orderId": "orderId",
      "clientOid": "clientOid"
    }
  ],
  "symbol": "symbol",
  "productType": "productType",
  "marginCoin": "marginCoin"
}

json

Example Responses

{
  "code": "00000",
  "data": {
    "successList": [
      {
        "orderId": "121211212122",
        "clientOid": "BITGET#121211212122"
      }
    ],
    "failureList": [
      {
        "orderId": "232",
        "clientOid": "321342",
        "errorMsg": "notExistend",
        "errorCode": "43001"
      }
    ]
  },
  "msg": "success",
  "requestTime": 1627293504612
}

json

application/json

一键市价平仓

POST

https://api.bitget.com

/api/v2/mix/order/close-positions

限速规则: 1次/1s (uid)

市价平仓

API Broker返佣标识:

需在HTTP Header请求头中添加如下代码块

"X-CHANNEL-API-CODE":"your-channel-api-code"

一键市价平仓 › Request Parameters

productType

string · required

产品类型 USDT-FUTURES U本位合约 COIN-FUTURES 币本位合约 USDC-FUTURES USDC合约

symbol

string

交易对

holdSide

string

持仓方向 1.买卖（单向持仓）模式下：可不填，若填则忽略。 2.开平仓模式（双向持仓）下：若不传，则平全部方向；若传，则平指定方向。 long：多仓，short：空仓

一键市价平仓 › Response Parameters

200

Successful response

code

string

msg

string

requestTime

integer

object

object[]

平仓成功单集合。

object[]

平仓失败单集合交割币对交割中、风控处理中等原因可能会导致平仓失败

POST/api/v2/mix/order/close-positions

curl https://api.bitget.com/api/v2/mix/order/close-positions \
  --request POST \
  --header 'Content-Type: application/json' \
  --data '{
  "symbol": "symbol",
  "holdSide": "holdSide",
  "productType": "productType"
}'

Example Request Body

{
  "symbol": "symbol",
  "holdSide": "holdSide",
  "productType": "productType"
}

json

Example Responses

{
  "code": "00000",
  "data": {
    "successList": [
      {
        "orderId": "123",
        "clientOid": "xxxxx",
        "symbol": "BTCUSDT"
      }
    ],
    "failureList": [
      {
        "orderId": "1234",
        "clientOid": "321",
        "symbol": "BTCUSDT",
        "errorMsg": "xxxxx",
        "errorCode": "xxxx"
      }
    ]
  },
  "msg": "success",
  "requestTime": 1627293504612
}

json

application/json

获取订单详情

GET

https://api.bitget.com

/api/v2/mix/order/detail

限速规则: 10次/1s (uid)

获取订单详情

获取订单详情 › Request Parameters

symbol

string · required

产品ID 必须大写

productType

string · required

产品类型 USDT-FUTURES U本位合约 COIN-FUTURES 币本位合约 USDC-FUTURES USDC合约

orderId

string

订单ID 'orderId' or 'clientOid' 必需提供一个

clientOid

string

自定义订单ID 'orderId' or 'clientOid' 必需提供一个

获取订单详情 › Response Parameters

200

Successful response

code

string

msg

string

requestTime

integer

object

symbol

string

交易对名称

size

string

委托数量

orderId

string

订单ID

clientOid

string

自定义订单id

baseVolume

string

交易币成交数量

priceAvg

string

成交均价

fee

string

手续费

price

string

委托价格

state

string

订单状态 live: 新建订单，orderbook中等待撮合 partially_filled: 部分成交 filled: 全部成交 canceled: 已撤销

side

string

开单方向 buy: 买 sell: 卖

force

string

订单有效期 ioc: 无法立即成交的部分就撤销 fok: 无法全部立即成交就撤 gtc: 普通订单, 订单会一直有效，直到被成交或者取消 post_only: 只做maker

totalProfits

string

总盈亏

posSide

string

持仓方向 long: 双向持仓多头 short: 双向持仓空头 net: 单向持仓

marginCoin

string

保证金币种

presetStopSurplusPrice

string

预设止盈值

presetStopLossPrice

string

预设止损值

quoteVolume

string

计价币成交数量

orderType

string

交易类型 limit: 限价 market: 市价

leverage

string

杠杆倍数

marginMode

string

保证金模式 isolated: 逐仓 crossed: 全仓

reduceOnly

string

是否只减仓 YES: 是 NO: 否

enterPointSource

string

订单来源 WEB: 自Web端创建的订单 API: 自API端创建的订单 SYS: 系统托管订单, 通常由强制平仓逻辑生成 ANDROID: 自Android端创建的订单 IOS: 自IOS端创建的订单

tradeSide

string

交易方向 open 开（开平仓模式） close 平（开平仓模式） reduce_close_long 双向持仓强制减多 reduce_close_short 双向持仓强制减空 offset_close_long 双向持仓轧差强制减多 offset_close_short 双向持仓轧差强制减空 burst_close_long 双向持仓爆仓平多 burst_close_short 双向持仓爆仓平空 delivery_close_long 双向持仓多头交割 delivery_close_short 双向持仓空头交割 dte_sys_adl_close_long 双向持仓ADL减多仓 dte_sys_adl_close_short 双向持仓ADL减空仓 buy_single 单向持仓买 sell_single 单向持仓卖 reduce_buy_single 单向持仓强制减仓买 reduce_sell_single 单向持仓强制减仓卖 burst_buy_single 单向持仓爆仓买 burst_sell_single 单向持仓爆仓卖 delivery_sell_single 单向持仓交割卖 delivery_buy_single 单向持仓交割买 dte_sys_adl_buy_in_single_side_mode 单向持仓ADL减仓买 dte_sys_adl_sell_in_single_side_mode 单向持仓ADL减仓卖

newTradeSide

string

新版交易方向。账户升级后与 tradeSide 一同返回，旧订单可能为 null

posMode

string

持仓模式 one_way_mode 单向持仓 hedge_mode 双向持仓

orderSource

string

订单来源 normal 正常下单 market 市价单 profit_market 市价止盈单 loss_market 市价止损单 Trader_delegate 交易员带单下单 trader_profit 交易员止盈 trader_loss 交易员止损 reverse 反手订单 trader_reverse 交易员带单反手 profit_limit 止盈限价 loss_limit 止损限价 liquidation 爆仓单 delivery_close_long 多仓交割 delivery_close_short 空仓交割 pos_profit_limit 仓位止盈限价 pos_profit_market 仓位止盈市价 pos_loss_limit 仓位止损限价 pos_loss_market 仓位止损市价 profit_chase 止盈追价委托 loss_chase 止损追价委托 follower_delegate 跟单委托 reduce_offset 减仓扎差委托 market_risk 最优价风险处理 plan_limit 限价计划委托 plan_market 最优价计划委托 pos_loss_limit 仓位止损限价 strategy_positive 策略-正向网格 strategy_reverse 策略-反向网格 strategy_unlimited 无限策略 move_limit 限价移动止盈止损 move_market 最优价移动止盈止损 tracking_limit 限价追踪委托 tracking_market 最优价追踪委托 strategy_dca_positive DCA策略-正向 strategy_dca_reverse DCA策略-反向 strategy_oco_limit 策略-OCO限价单 strategy_oco_trigger 策略-OCO触发单 modify_order_limit 限价修改订单 strategy_regular_buy 策略-定投策略买 strategy_grid_middle 策略-中性网格

cancelReason

string

取消原因 normal_cancel：普通取消 stp_cancel：因STP规则取消

cTime

string

创建时间, ms

uTime

string

更新时间, ms

GET/api/v2/mix/order/detail

curl 'https://api.bitget.com/api/v2/mix/order/detail?symbol=<string>&productType=<string>'

Example Responses

{
  "code": "00000",
  "msg": "success",
  "requestTime": 1695823012595,
  "data": {
    "symbol": "ethusdt",
    "size": "2",
    "orderId": "123456",
    "clientOid": "77777",
    "baseVolume": "2",
    "priceAvg": "1900",
    "fee": "",
    "price": "1900",
    "state": "filled",
    "side": "buy",
    "force": "gtc",
    "totalProfits": "2112",
    "posSide": "long",
    "marginCoin": "usdt",
    "presetStopSurplusPrice": "1910",
    "presetStopLossPrice": "1890",
    "quoteVolume": "1900",
    "orderType": "limit",
    "leverage": "20",
    "marginMode": "cross",
    "reduceOnly": "yes",
    "enterPointSource": "api",
    "tradeSide": "",
    "newTradeSide": null,
    "posMode": "one_way_mode",
    "orderSource": "normal",
    "cancelReason": "",
    "cTime": "1627300098776",
    "uTime": "1627300098776"
  }
}

json

application/json

获取成交明细

GET

https://api.bitget.com

/api/v2/mix/order/fills

普通用户10次/S 根据uid限频

获取合约成交明细记录

获取成交明细 › Request Parameters

productType

string · required

产品类型 USDT-FUTURES U本位合约 COIN-FUTURES 币本位合约 USDC-FUTURES USDC合约

orderId

string

订单id

symbol

string

交易对如:ethusdt

idLessThan

string

请求此tradeId之前（更旧的数据）的分页内容。

startTime

string

开始时间（时间戳毫秒） (托管子账户访问时，StartTime 时间不能早于绑定开始的时间)

endTime

string

结束时间（时间戳毫秒）

limit

string

查询条数默认100，最大100

获取成交明细 › Response Parameters

200

Successful response

code

string

msg

string

requestTime

integer

object

object[]

成交明细集合

endId

string

最后的成交id。指定idLessThan/idGreaterThan作为范围查询时以此为准。

GET/api/v2/mix/order/fills

curl 'https://api.bitget.com/api/v2/mix/order/fills?productType=<string>'

Example Responses

{
  "code": "00000",
  "data": {
    "fillList": [
      {
        "tradeId": "123",
        "symbol": "ethusdt",
        "orderId": "121212",
        "price": "1900",
        "baseVolume": "1",
        "feeDetail": [
          {
            "deduction": "yes",
            "feeCoin": "BGB",
            "totalDeductionFee": "-0.017118519726",
            "totalFee": "-0.017118519726"
          }
        ],
        "side": "buy",
        "quoteVolume": "1902",
        "profit": "102",
        "enterPointSource": "api",
        "tradeSide": "close",
        "posMode": "hedge_mode",
        "tradeScope": "taker",
        "cTime": "1627293509612"
      }
    ],
    "endId": "123"
  },
  "msg": "success",
  "requestTime": 1627293504612
}

json

application/json

获取历史成交明细

GET

https://api.bitget.com

/api/v2/mix/order/fill-history

普通用户10次/S 根据uid限频

获取历史成交明细 › Request Parameters

productType

string · required

产品类型 USDT-FUTURES U本位合约 COIN-FUTURES 币本位合约 USDC-FUTURES USDC合约不支持模拟盘数据查询

orderId

string

订单id

symbol

string

交易对如:ethusdt

startTime

string

开始时间戳 Unix时间戳的毫秒数格式，如 1597026383085 （时间跨度最大支持一周，若不传结束时间，则默认结束时间为一周。） (托管子账户访问时，StartTime 时间不能早于绑定开始的时间)

endTime

string

结束时间戳 Unix时间戳的毫秒数格式，如 1597026383085 （时间跨度最大支持一周，若不传结束时间，则默认结束时间为一周。）

idLessThan

string

请求此ID之前（更旧的数据）的分页内容，传的值为对应接口的 endId。

limit

string

查询条数最大100，默认100

获取历史成交明细 › Response Parameters

200

Successful response

code

string

msg

string

requestTime

integer

object

endId

string

上次查询结束订单ID

object[]

成交明细集合

GET/api/v2/mix/order/fill-history

curl 'https://api.bitget.com/api/v2/mix/order/fill-history?productType=<string>'

Example Responses

{
  "code": "00000",
  "msg": "success",
  "requestTime": 1699267238892,
  "data": {
    "fillList": [
      {
        "tradeId": "xxxx",
        "symbol": "ETHUSDT",
        "marginCoin": "USDT",
        "orderId": "xxxx",
        "price": "1801.33",
        "baseVolume": "0.02",
        "feeDetail": [
          {
            "deduction": "no",
            "feeCoin": "USDT",
            "totalDeductionFee": "0",
            "totalFee": "-0.02161596"
          }
        ],
        "side": "sell",
        "quoteVolume": "36.0266",
        "profit": "0.0252",
        "enterPointSource": "ios",
        "tradeSide": "sell_single",
        "posMode": "one_way_mode",
        "tradeScope": "taker",
        "cTime": "1698730804882"
      }
    ],
    "endId": "123456789"
  }
}

json

application/json

查询当前委托

GET

https://api.bitget.com

/api/v2/mix/order/orders-pending

普通用户10次/S 根据uid限频

可查询当前的所有委托（普通单）委托信息。

查询当前委托 › Request Parameters

productType

string · required

产品类型 USDT-FUTURES U本位合约 COIN-FUTURES 币本位合约 USDC-FUTURES USDC合约

orderId

string

订单id orderId和clientOid同传时以orderId为准。

clientOid

string

自定义订单id orderId和clientOid同传时以orderId为准。

symbol

string

交易对如:ethusdt

status

string

订单状态若未指定，将查询所有状态live 等待成交（尚未有任何成交） live: 未成交；partially_filled：部分成交

idLessThan

string

请求此ID之前（更旧的数据）的分页内容，传的值为对应接口的 endId。

startTime

string

开始时间戳 Unix时间戳的毫秒数格式，如 1597026383085

endTime

string

结束时间戳 Unix时间戳的毫秒数格式，如 1597026383085

limit

string

查询条数最大100，默认100

查询当前委托 › Response Parameters

200

Successful response

code

string

msg

string

requestTime

integer

object

object[]

委托集合

endId

string

上次查询结束订单ID

GET/api/v2/mix/order/orders-pending

curl 'https://api.bitget.com/api/v2/mix/order/orders-pending?productType=<string>'

Example Responses

{
  "code": "00000",
  "data": {
    "entrustedList": [
      {
        "symbol": "ethusdt",
        "size": "100",
        "orderId": "123",
        "clientOid": "12321",
        "baseVolume": "12.1",
        "fee": "",
        "price": "1900",
        "priceAvg": "1903",
        "status": "partially_filled",
        "side": "buy",
        "force": "gtc",
        "totalProfits": "0",
        "posSide": "long",
        "marginCoin": "usdt",
        "quoteVolume": "22001.21",
        "leverage": "20",
        "marginMode": "cross",
        "enterPointSource": "api",
        "tradeSide": "open",
        "posMode": "hedge_mode",
        "orderType": "limit",
        "orderSource": "normal",
        "cTime": "1627293504612",
        "uTime": "1627293505612",
        "presetStopSurplusPrice": "2001",
        "presetStopSurplusTriggerType": "mark_price",
        "presetStopSurplusExecutePrice": "2201",
        "presetStopLossPrice": "1800",
        "presetStopLossTriggerType": "mark_price",
        "presetStopLossExecutePrice": "1900"
      }
    ],
    "endId": "123"
  },
  "msg": "success",
  "requestTime": 1627293504612
}

json

application/json

获取历史委托

GET

https://api.bitget.com

/api/v2/mix/order/orders-history

普通用户10次/S 根据uid限频

获取合约历史委托单(仅支持查询90天内数据，超过90天数据可以在网页端导出）

获取历史委托 › Request Parameters

productType

string · required

产品类型 USDT-FUTURES U本位合约 COIN-FUTURES 币本位合约 USDC-FUTURES USDC合约

orderId

string

订单id orderId和clientOid同传时以orderId为准。

clientOid

string

自定义订单id orderId和clientOid同传时以orderId为准。

symbol

string

交易对如:ETHUSDT

idLessThan

string

请求此ID之前（更旧的数据）的分页内容，传的值为首次查询返回的endId

orderSource

string

订单资源 normal 正常下单 market 市价单 profit_market 市价止盈单 loss_market 市价止损单 Trader_delegate 交易员带单下单 trader_profit 交易员止盈 trader_loss 交易员止损 reverse 反手订单 trader_reverse 交易员带单反手 profit_limit 止盈限价 loss_limit 止损限价 liquidation 爆仓单 delivery_close_long 多仓交割 delivery_close_short 空仓交割 pos_profit_limit 仓位止盈限价 pos_profit_market 仓位止盈市价 pos_loss_limit 仓位止损限价 pos_loss_market 仓位止损市价

endTime

string

结束时间戳 Unix时间戳的毫秒数格式，如 1597026383085

startTime

string

结束时间戳 Unix时间戳的毫秒数格式，如 1597026383085（对于托管子账户，startTime不能早于绑定时间）

limit

string

查询条数最大100，默认100

获取历史委托 › Response Parameters

200

Successful response

code

string

msg

string

requestTime

integer

object

endId

string

上次查询结束订单ID，在使用入参idLessThan作为范围查询时使用

object[]

委托集合

GET/api/v2/mix/order/orders-history

curl 'https://api.bitget.com/api/v2/mix/order/orders-history?productType=<string>'

Example Responses

{
  "code": "00000",
  "data": {
    "entrustedList": [
      {
        "symbol": "ethusdt",
        "size": "100",
        "orderId": "123",
        "clientOid": "12321",
        "baseVolume": "12.1",
        "fee": "-0.00854",
        "price": "1900",
        "priceAvg": "1903",
        "status": "filled",
        "side": "buy",
        "force": "gtc",
        "totalProfits": "0",
        "posSide": "long",
        "marginCoin": "usdt",
        "quoteVolume": "22001.21",
        "leverage": "20",
        "marginMode": "crossed",
        "reduceOnly": "NO",
        "enterPointSource": "api",
        "tradeSide": "open",
        "posMode": "hedge_mode",
        "posAvg": "",
        "orderType": "limit",
        "orderSource": "normal",
        "liqPrice": "",
        "cTime": "1627293504612",
        "uTime": "1627293505612",
        "presetStopSurplusPrice": "2001",
        "presetStopLossPrice": "1800"
      }
    ],
    "endId": "123"
  },
  "msg": "success",
  "requestTime": 1627293504612
}

json

application/json

一键全撤

POST

https://api.bitget.com

/api/v2/mix/order/cancel-all-orders

普通用户1次/S 根据uid限频

一键全撤 › Request Parameters

productType

string · required

产品类型 USDT-FUTURES U本位合约 COIN-FUTURES 币本位合约 USDC-FUTURES USDC合约

marginCoin

string

保证金币种, 必须大写

requestTime

string

请求时间 Unix毫秒时间戳格式

receiveWindow

string

有效窗口期单位毫秒窗口期不超过60s

一键全撤 › Response Parameters

200

Successful response

code

string

msg

string

requestTime

integer

object

object[]

所撤成功单集合。

object[]

所撤失败单集合。

POST/api/v2/mix/order/cancel-all-orders

curl https://api.bitget.com/api/v2/mix/order/cancel-all-orders \
  --request POST \
  --header 'Content-Type: application/json' \
  --data '{
  "productType": "productType",
  "marginCoin": "marginCoin",
  "requestTime": "requestTime",
  "receiveWindow": "receiveWindow"
}'

Example Request Body

{
  "productType": "productType",
  "marginCoin": "marginCoin",
  "requestTime": "requestTime",
  "receiveWindow": "receiveWindow"
}

json

Example Responses

{
  "code": "00000",
  "data": {
    "successList": [
      {
        "orderId": "121211212122",
        "clientOid": "BITGET#121211212122"
      }
    ],
    "failureList": [
      {
        "orderId": "232",
        "clientOid": "321342",
        "errorMsg": "notExistend"
      }
    ]
  },
  "msg": "success",
  "requestTime": 1627293504612
}

json

application/json