合约 · 交易

经典账户 — 合约 · 交易

下单

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：

Code
- 单向持仓时，不可以传tradeSide参数。

- 双向持仓时，tradeSide必填。

    - 反手当前的多仓,开空仓：side=buy，tradeSide=open。

    - 反手当前的空仓，开多仓：Side =sell，tradeSide=open。

size:代表反手数量。

Code
- 单向持仓时：忽略该参数，会将整个仓位数量反向开仓。

- 双向持仓时：

    - 若传入数量小于当前仓位数量：当前仓位数量会按传入数量减持，并按传入数量反向开仓。

      例如当前存在多仓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

size

string · required

下单数量

side

string · required

下单方向

buy：买

sell：卖

orderType

string · required

订单类型

limit: 限价单，

market: 市价单

price

string

下单价格。

orderType为limit时必填

tradeSide

string

交易方向

开平仓双向持仓模式下必填，单向持仓时不要填，否则会报错

open: 开

close: 平

force

string

订单有效期

orderType为limit时必填，若省略则默认为gtc

ioc: 无法立即成交的部分就撤销

fok: 无法全部立即成交就撤销

gtc: 普通订单, 订单会一直有效，直到被成交或者取消

post_only: 只做maker

clientOid

string

自定义订单id

reduceOnly

string

是否只减仓

YES，NO

默认为NO

仅适用于单向持仓模式。

presetStopSurplusPrice

string

止盈值

为空则默认不设止盈。

presetStopLossPrice

string

止损值

为空则默认不设止损。

stpMode

string

STP模式， default none

none 不设置STP

cancel_taker 取消taker单

cancel_maker 取消maker单

cancel_both 两者都取消

批量下单 › Response Parameters

200

Successful response

code

string

msg

string

requestTime

integer

object

object[]

成功单集合

orderId

string

订单id

clientOid

string

自定义订单id

object[]

失败单集合

orderId

string

订单id

clientOid

string

自定义订单id

errorMsg

string

失败原因

errorCode

string

错误码

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对齐

orderId

string

订单id

orderId和clientOid必须两者传一个，同传时以orderId为准。

clientOid

string

自定义订单id

orderId和clientOid必须两者传一个，同传时以orderId为准。

symbol

string

交易对如:ethusdt

当传入orderIdList参数时，此参数为必传

marginCoin

string

保证金币种必须大写

批量撤单 › Response Parameters

200

Successful response

code

string

msg

string

requestTime

integer

object

object[]

所撤成功单集合。

orderId

string

订单id

clientOid

string

自定义订单id

object[]

所撤失败单集合。

orderId

string

订单id

clientOid

string

自定义订单id

errorMsg

string

失败原因

errorCode

string

错误码

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[]

平仓成功单集合。

orderId

string

订单id

clientOid

string

自定义订单id

symbol

string

交易对

object[]

平仓失败单集合

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

orderId

string

订单id

clientOid

string

自定义订单id

symbol

string

交易对

errorMsg

string

失败原因

errorCode

string

错误码

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[]

成交明细集合

tradeId

string

成交id

symbol

string

交易对名称

orderId

string

订单号

price

string

成交价格

baseVolume

string

交易币成交数量

object[]

手续费

deduction

string

是否扣除(抵扣劵）

feeCoin

string

币种代码

totalDeductionFee

string

手续费折扣总额

totalFee

string

总计手续费

side

string

成交类型

buy 买

sell 卖

quoteVolume

string

计价币交易额

profit

string

利润

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减仓卖

posMode

string

持仓模式

one_way_mode 单向持仓

hedge_mode 双向持仓

tradeScope

string

Trader tag

taker: Taker

maker: Maker

cTime

string

成交时间

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[]

成交明细集合

symbol

string

交易对名称

marginCoin

string

保证金币种

tradeId

string

成交ID

orderId

string

订单id

price

string

成交价格

baseVolume

string

交易币成交数量

object[]

手续费

deduction

string

是否扣除(抵扣劵）

feeCoin

string

币种代码

totalDeductionFee

string

手续费折扣总额

totalFee

string

总计手续费

side

string

开单方向

buy 买，sell 卖

quoteVolume

string

计价币成交数量

profit

string

利润

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减仓卖

posMode

string

持仓模式

one_way_mode 单向持仓

hedge_mode 双向持仓

tradeScope

string

买卖方标识

taker 吃单方

maker 挂单方

cTime

string

创建时间

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[]

委托集合

symbol

string

交易对名称

size

string

委托数量

orderId

string

订单id

clientOid

string

自定义id

baseVolume

string

交易币成交数量

fee

string

手续费

price

string

委托价格

priceAvg

string

平均成交价格

status为live时为空

status

string

订单状态

live: 等待成交（尚未有任何成交）

partially_filled: 部分成交

side

string

开单方向

buy 买，sell 卖

force

string

订单有效期

ioc 无法立即成交的部分就撤销

fok 无法全部立即成交就撤销

gtc 普通订单, 订单会一直有效，直到被成交或者取消

post_only 只做maker

totalProfits

string

总盈亏

status为live时为空。

posSide

string

持仓方向

long 双向持仓多头

short 双向持仓空头

net 单向持仓

marginCoin

string

保证金币种

quoteVolume

string

计价币成交数量

leverage

string

杠杆倍数

marginMode

string

保证金模式

isolated 逐仓

crossed 全仓

reduceOnly

string

是否只减仓

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减仓卖

posMode

string

持仓模式

one_way_mode 单向持仓

hedge_mode 双向持仓

orderType

string

订单类型

limit 限价单

market 市价单

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 策略-中性网格

off_close 下架平仓

cTime

string

创建时间

uTime

string

获取历史委托

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[]

委托集合

symbol

string

交易对名称

size

string

委托数量

orderId

string

订单id

clientOid

string

自定义id

baseVolume

string

交易币成交数量

fee

string

手续费

price

string

委托价格

priceAvg

string

平均成交价格

status

string

订单状态

filled 全部成交

canceled 已撤销

side

string

开单方向

buy 买，sell 卖

force

string

订单有效期

(确认是否支持maker）

ioc 无法立即成交的部分就撤销

fok 无法全部立即成交就撤销

gtc 普通订单, 订单会一直有效，直到被成交或者取消

post_only 只做maker

totalProfits

string

总盈亏

posSide

string

持仓方向

long 双向持仓多头

short 双向持仓空头

net 单向持仓

marginCoin

string

保证金币种

quoteVolume

string

计价币成交数量

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减仓卖

posMode

string

持仓模式

one_way_mode 单向持仓

hedge_mode 双向持仓

orderType

string

订单类型

limit 限价单

market 市价单

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 策略-中性网格

off_close 下架平仓

liqPrice

string

强平价格

cTime

string

创建时间, 时间戳，毫秒

uTime

string

最近更新时间，时间戳，毫秒

presetStopSurplusPrice

string

预设止盈值

presetStopLossPrice

string

预设止损值

posAvg

string

持仓均价

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[]

所撤成功单集合。

orderId

string

订单id

clientOid

string

自定义订单id

object[]

所撤失败单集合。

orderId

string

订单id

clientOid

string

自定义订单id

errorMsg

string

失败原因

errorCode

string

错误码

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