订单管理

下单

POST

https://api.bitget.com

/api/v3/trade/place-order

限频规则: 10次/秒/UID
需要统一账户交易读写权限

该接口现支持 Reality 股票交易对（rtoken，如 rAAPLUSDT）下单。Reality 订单适用独立限频规则：默认 5次/秒/UID，白名单用户 30次/秒/UID。

该接口支持现货、杠杆及合约下单，并可以自定义包括价格、数量和订单类型等参数。

合约交易
合约单向持仓下只减仓订单，如果已经存在减仓单并且减仓单数量已经等于仓位数量，或者你新下的减仓单大于仓位剩余数量，会自动把之前减仓单取消，重新下新的减仓单，此时返回的信息 orderId会为 null，建议一定要传cliendOid
杠杆交易
杠杆下单会自动借贷
订单检查
- 合约：Price下单价格要满足价格乘数priceMultiplier的倍数，并且符合pricePrecision小数位。qty要满足大于minOrderAmount并且满足sizeMultiplier的倍数
- 现货：price要满足小数位。qty下单数量必须要大于minOrderAmount
开仓逻辑
- 双向持仓
  
  开多： side=buy & posSide=long
  
  开空：side=sell & posSide=short
  
  平多：side=sell & posSide=long
  
  平空：side=buy & posSide=short
- 单向持仓
  
  开多 side:buy
  
  开空 side:sell
  
  平多 side:sell reduceOnly:yes
  
  平空 side:buy reduceOnly:yes
订单持有上限:
- 合约: USDT合约/币本位合约/USDC合约所有交易对加起来一共最多支持400个订单
- 现货: 现货/杠杆所有交易对最多支持400订单
请求监控:

将针对您的 API 请求进行统计监控，当单日 (UTC 0点 - UTC 24点) 单账号（母账号和子账号整体运算）订单总数超过一定上限，平台将保留提醒、警告，以及进行必要性限制的权利。使用API的客户预设接收本条款并负有配合调整的义务。
API Broker返佣标识:

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

"X-CHANNEL-API-CODE":"your-channel-api-code"
币本位合约说明:
- 新币本位业务线symbol格式为"XXXUSD_CM"，例如BTCUSD交易对在币本位合约的格式为BTCUSD_CM
- 新币本位暂时不支持修改订单，ADL，策略单，预设止盈止损

注意：操作订单时出现以下错误，请用clientOid查询订单详情，以确认操作的最终结果

{ "code": "40010", "msg": "Request timed out", "requestTime": 1666268894074, "data": null }
{ "code": "40725", "msg": "service return an error", "requestTime": 1666268894071, "data": null }
{ "code": "45001", "msg": "Unknown error", "requestTime": 1666268894071, "data": null }

下单 › Request Parameters

category

string · required

产品类型
SPOT 现货交易
MARGIN 杠杆交易
USDT-FUTURES USDT合约
COIN-FUTURES 币本位合约
USDC-FUTURES USDC合约

symbol

string · required

交易对名称
例如：BTCUSDT

qty

string · required

下单数量
现货/杠杆：
市价买单，单位为 quote coin
限价及市价卖单，单位为 base coin
USDT/USDC合约：
单位为 base coin
币本位合约：
单位为 quote coin

side

string · required

下单方向
buy: 买
sell: 卖

orderType

string · required

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

price

string

下单价格
订单类型为限价单limit时，该字段必填
订单类型为市价单market时，该字段失效

timeInForce

string

订单执行策略
ioc: 无法立即成交的部分就撤销
fok: 无法全部立即成交就撤销
gtc: 普通订单, 订单会一直有效，直到被成交或者取消
post_only: 只做maker
rpi: 零售价格优化订单，为零售订单流提供价格优化的非显示限价单。仅限拥有RPI做市商权限的账户使用。
订单类型为限价单limit时必填，若省略则默认为gtc

posSide

string

仓位方向
双向持仓模式下必填，单向持仓时不要填，否则会报错
long: 多头
short: 空头
只适用于合约交易

clientOid

string

自定义订单ID, ^[0-9A-Za-z_:#\\-+\\s]{1,32}$

reduceOnly

string

是否只减仓:yes,no，默认no;
yes表示确保委托的执行只以平仓为目的，减少仓位
仅适用于单向持仓模式下

stpMode

string

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

tpTriggerBy

string

预设止盈触发类型
market：市场价格
mark：标记价格
如不填写，默认值为market市场价格
该字段仅针对合约业务线usdt-futures，coin-futures及usdc-futures生效

slTriggerBy

string

预设止损触发类型
market市场价格
mark标记价格
如不填写，默认值为market市场价格
该字段仅针对合约业务线usdt-futures，coin-futures及usdc-futures生效

takeProfit

string

预设止盈触发价格

stopLoss

string

预设止损触发价格

tpOrderType

string

止盈触发的策略单类型
limit 限价单
market 市价单

slOrderType

string

止损触发的策略单类型
limit 限价单
market 市价单

tpLimitPrice

string

止盈策略单执行价格
仅限价单tpOrderType=limit时有效，市价单忽略该参数

slLimitPrice

string

止损策略单执行价格
仅限价单slOrderType=limit时有效，市价单忽略该参数

marginMode

string

保证金模式
crossed 全仓
isolated 逐仓
不传默认为全仓
仅适用于合约

autoBorrow

string

自动借币开关
yes 开启
no 关闭（默认）
仅用于现货下单。开启后，若得到币不支持借贷、消耗币支持借贷，则在消耗币可用余额不足时，系统将自动借入消耗币，补足委托所需金额。

下单 › Response Parameters

200

Successful response

code

string

msg

string

requestTime

integer

object

orderId

string

订单id

clientOid

string

自定义订单id

POST/api/v3/trade/place-order

curl https://api.bitget.com/api/v3/trade/place-order \
  --request POST \
  --header 'Content-Type: application/json' \
  --data '{
  "category": "category",
  "symbol": "symbol",
  "qty": "qty",
  "price": "price",
  "side": "side",
  "orderType": "orderType",
  "timeInForce": "timeInForce",
  "posSide": "posSide",
  "clientOid": "clientOid",
  "reduceOnly": "reduceOnly",
  "stpMode": "stpMode",
  "tpTriggerBy": "tpTriggerBy",
  "slTriggerBy": "slTriggerBy",
  "takeProfit": "takeProfit",
  "stopLoss": "stopLoss",
  "tpOrderType": "tpOrderType",
  "slOrderType": "slOrderType",
  "tpLimitPrice": "tpLimitPrice",
  "slLimitPrice": "slLimitPrice",
  "marginMode": "marginMode",
  "autoBorrow": "autoBorrow"
}'

Example Request Body

{
  "category": "category",
  "symbol": "symbol",
  "qty": "qty",
  "price": "price",
  "side": "side",
  "orderType": "orderType",
  "timeInForce": "timeInForce",
  "posSide": "posSide",
  "clientOid": "clientOid",
  "reduceOnly": "reduceOnly",
  "stpMode": "stpMode",
  "tpTriggerBy": "tpTriggerBy",
  "slTriggerBy": "slTriggerBy",
  "takeProfit": "takeProfit",
  "stopLoss": "stopLoss",
  "tpOrderType": "tpOrderType",
  "slOrderType": "slOrderType",
  "tpLimitPrice": "tpLimitPrice",
  "slLimitPrice": "slLimitPrice",
  "marginMode": "marginMode",
  "autoBorrow": "autoBorrow"
}

json

Example Responses

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

json

application/json

修改订单

POST

https://api.bitget.com

/api/v3/trade/modify-order

限频规则: 10次/秒/UID

支持通过订单号orderId或者自定义订单号clientOid来修改订单

仅支持修改未完全成交的订单。如订单已完全成交，您将无法通过该接口修改
修改提交后到返回结果前，无法重复提交修改请求

限频规则: 10次/秒/UID
需要统一账户交易读写权限

修改订单 › Request Parameters

orderId

string

订单ID
orderId和clientOid二者必填其一
如同时传入orderId及clientOid，则orderId优先级更高

clientOid

string

自定义订单ID
orderId和clientOid二者必填其一
如同时传入orderId及clientOid，则orderId优先级更高

qty

string

下单数量
单位为基础币
qty和price二者必填其一

price

string

下单价格
qty和price二者必填其一

autoCancel

string

修改订单失败是否撤销原订单
yes: 撤销
no: 不撤销（默认值）
若设置为 yes：撮合改单失败后，直接执行撤单；撤单后，柜台将拒绝该订单的后续改单请求（含在途及新请求）。

symbol

string

交易对名称
例如：BTCUSDT

category

string

产品类型
SPOT 现货交易
MARGIN 杠杆交易
USDT-FUTURES USDT合约
COIN-FUTURES 币本位合约
USDC-FUTURES USDC合约

tpTriggerBy

string

预设止盈触发类型
market 市场价格
mark 标记价格
如不填写，默认值为market市场价格
该字段仅针对合约业务线USDT-FUTURES、COIN-FUTURES及USDC-FUTURES生效
若不传或传空，则代表不修改现有值

slTriggerBy

string

预设止损触发类型
market 市场价格
mark 标记价格
如不填写，默认值为market市场价格
该字段仅针对合约业务线USDT-FUTURES、COIN-FUTURES及USDC-FUTURES生效
若不传或传空，则代表不修改现有值

takeProfit

string

预设止盈触发价格
若不传或传空，则代表不修改现有值
若传"0"，则代表取消止盈

stopLoss

string

预设止损触发价格
若不传或传空，则代表不修改现有值
若传"0"，则代表取消止损

tpOrderType

string

止盈触发的策略单类型
limit 限价单
market 市价单

slOrderType

string

止损触发的策略单类型
limit 限价单
market 市价单

tpLimitPrice

string

止盈策略单执行价格
仅限价单tpOrderType=limit时有效，市价单忽略该参数
若不传或传空，则代表不修改现有值

slLimitPrice

string

止损策略单执行价格
仅限价单slOrderType=limit时有效，市价单忽略该参数
若不传或传空，则代表不修改现有值

修改订单 › Response Parameters

200

Successful response

code

string

msg

string

requestTime

integer

object

orderId

string

订单号

clientOid

string

自定义订单号

POST/api/v3/trade/modify-order

curl https://api.bitget.com/api/v3/trade/modify-order \
  --request POST \
  --header 'Content-Type: application/json' \
  --data '{
  "orderId": "orderId",
  "clientOid": "clientOid",
  "qty": "qty",
  "price": "price",
  "autoCancel": "autoCancel",
  "symbol": "symbol",
  "category": "category",
  "tpTriggerBy": "tpTriggerBy",
  "slTriggerBy": "slTriggerBy",
  "takeProfit": "takeProfit",
  "stopLoss": "stopLoss",
  "tpOrderType": "tpOrderType",
  "slOrderType": "slOrderType",
  "tpLimitPrice": "tpLimitPrice",
  "slLimitPrice": "slLimitPrice"
}'

Example Request Body

{
  "orderId": "orderId",
  "clientOid": "clientOid",
  "qty": "qty",
  "price": "price",
  "autoCancel": "autoCancel",
  "symbol": "symbol",
  "category": "category",
  "tpTriggerBy": "tpTriggerBy",
  "slTriggerBy": "slTriggerBy",
  "takeProfit": "takeProfit",
  "stopLoss": "stopLoss",
  "tpOrderType": "tpOrderType",
  "slOrderType": "slOrderType",
  "tpLimitPrice": "tpLimitPrice",
  "slLimitPrice": "slLimitPrice"
}

json

Example Responses

{
  "code": "00000",
  "data": {
    "orderId": "1",
    "clientOid": "12313"
  },
  "msg": "success",
  "requestTime": 1627293504612
}

json

application/json

撤单

POST

https://api.bitget.com

/api/v3/trade/cancel-order

限频规则: 10次/秒/UID

该接口现支持 Reality 股票交易对（rtoken，如 rAAPLUSDT）撤单。Reality 订单适用独立限频规则：默认 5次/秒/UID，白名单用户 30次/秒/UID。

该接口支持取消单独的现货、合约、杠杆的未成交以及部分成交订单

限频规则: 10次/秒/UID
需要统一账户交易读写权限

撤单 › Request Parameters

orderId

string

订单号
clientOid和orderId二者必填其一
如用户同时传入orderId及clientOid,则orderId优先级更高

clientOid

string

自定义订单号d
clientOid和orderId二者必填其一
如用户同时传入orderId及clientOid,则orderId优先级更高

category

string

产品类型
SPOT 现货交易
MARGIN 杠杆交易
USDT-FUTURES USDT合约
COIN-FUTURES 币本位合约
USDC-FUTURES USDC合约

撤单 › Response Parameters

200

Successful response

code

string

msg

string

requestTime

integer

object

orderId

string

订单id

clientOid

string

自定义订单id

倒计时全部撤单

POST

https://api.bitget.com

/api/v3/trade/countdown-cancel-all

限频规则: 1次/秒/UID

实际使用时，客户端需要定期重复发送心跳请求，以防止异常断连或系统崩溃导致的挂单失控情况

举例说明，假设您预期的心跳周期为10s，即如果超过10s未发送心跳请求，则需要撤销全部订单

正常情况下，可以选择每3-5s调用一次该接口，将countdown设置为10，并以此反复调用来重置倒计时

异常情况下，超过10s未发送心跳请求，则账户下的全部订单将被自动撤销；自动撤销后，Deadman switch机制将自动关闭

如需手动关闭Deadman Switch机制，则将countdown设置为0即可

p.s 该接口仅支持撤销UTA账户下的订单，不支持撤销经典账户下的订单

该接口请联系对接BD申请接入权限

限频规则: 1次/秒/UID
需要统一账户交易读写权限

倒计时全部撤单 › Request Parameters

countdown

string · required

重连窗口期
- 单位为秒
- 正整数，范围为[5,60]，倒计时最小为5s，最大为60s
- 如填写0，则表示取消倒计时撤单功能

倒计时全部撤单 › Response Parameters

200

Successful response

code

string

msg

string

requestTime

integer

data

Response data

批量下单

POST

https://api.bitget.com

/api/v3/trade/place-batch

限频规则: 5次/秒/UID

该接口支持现货、杠杆及合约的批量下单，并可以自定义包括价格、数量和订单类型等参数。

新功能预告 (当前暂不支持) - 逐仓杠杆交易即将上线 - 跟单交易即将上线 - 即将支持止盈止损功能

合约交易
合约单向持仓下只减仓订单，如果已经存在减仓单并且减仓单数量已经等于仓位数量，或者你新下的减仓单大于仓位剩余数量，会自动把之前减仓单取消，重新下新的减仓单，此时返回的信息
orderId会为 null，建议一定要传cliendOid（暂不支持reduce-only订单）

杠杆交易
杠杆下单会自动借贷

订单检查 - 合约：Price下单价格要满足价格乘数priceMultiplier的倍数，并且符合pricePrecision小数位。qty要满足大于
minTradeUSDT并且满足sizeMultiplier的倍数

Code
- **现货**：`price`要满足小数位。`qty`下单数量必须要大于`minTradeUSDT`

开仓逻辑 - 双向持仓

Code
  开多： `side=buy` & `posSide=long`

  开空：`side=sell` & `posSide=short`

  平多：`side=sell` & `posSide=long`

  平空：`side=buy` & `posSide=short`


- **单向持仓**

  开多 `side`:buy

  开空 `side`:sell

  平多 `side`:sell   `reduceOnly`:yes

  平空 `side`:buy    `reduceOnly`:yes

订单持有上限: - 合约: USDT合约/币本位合约/USDC合约所有交易对加起来一共最多支持400个订单 - 现货: 现货/杠杆所有交易对最多支持400订单

请求监控:

将针对您的 API 请求进行统计监控，当单日 (UTC 0点 - UTC 24点) 单账号（母账号和子账号整体运算）订单总数超过一定上限，平台将保留提醒、警告，以及进行必要性限制的权利。
使用API的客户预设接收本条款并负有配合调整的义务。

API Broker返佣标识:

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

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

下单出现错误

{ "code":"40762", "msg":"The order size is greater than the max open size", "requestTime":1627293504612 }

两种原因 - 账户余额不足

Code
-<br/>  当前交易对当前杠杆仓位梯度已满，具体仓位梯度请参考 <br/>  这里

注意：操作订单时出现以下错误，请用clientOid查询订单详情，以确认操作的最终结果

{ "code": "40010", "msg": "Request timed out", "requestTime": 1666268894074, "data": null }

{ "code": "40725", "msg": "service return an error", "requestTime": 1666268894071, "data": null }

{ "code": "45001", "msg": "Unknown error", "requestTime": 1666268894071, "data": null }

限频规则: 5次/秒/UID
批量限制：每批不能超过20笔委托单
需要统一账户交易读写权限

批量下单 › Request Parameters

category

string · required

产品类型
SPOT 现货交易
MARGIN 杠杆交易
USDT-FUTURES USDT合约
COIN-FUTURES 币本位合约
USDC-FUTURES USDC合约
所有委托单的产品类型必须相同

symbol

string · required

交易对名称
例如：BTCUSDT

qty

string · required

下单数量
现货/杠杆：
市价买单，单位为quote coin
限价及市价卖单，单位为base coin
USDT/USDC合约：
单位为base coin
币本位合约：
单位为 quote coin

side

string · required

下单方向
buy: 买
sell: 卖

orderType

string · required

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

price

string

下单价格
订单类型为限价单limit时，该字段必填
订单类型为市价单market时，该字段失效

timeInForce

string

订单执行策略
ioc: 无法立即成交的部分就撤销
fok: 无法全部立即成交就撤销
gtc: 普通订单, 订单会一直有效，直到被成交或者取消
post_only: 只做maker
rpi: 零售价格优化订单，仅限拥有RPI做市商权限的账户使用
订单类型为限价单limit时必填，若省略则默认为gtc

posSide

string

仓位方向
双向持仓模式下必填，单向持仓时不要填，否则会报错
long: 多头
short: 空头
只适用于合约交易

clientOid

string

自定义订单ID, [0-9A-Za-z_:#\\-+\\s]{1,32}$

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

code

string

这笔委托单的Error code

msg

string

这笔委托单的Error message

POST/api/v3/trade/place-batch

curl https://api.bitget.com/api/v3/trade/place-batch \
  --request POST \
  --header 'Content-Type: application/json' \
  --data '{
  "category": "category",
  "symbol": "symbol",
  "qty": "qty",
  "price": "price",
  "side": "side",
  "orderType": "orderType",
  "timeInForce": "timeInForce",
  "posSide": "posSide",
  "clientOid": "clientOid",
  "stpMode": "stpMode"
}'

Example Request Body

{
  "category": "category",
  "symbol": "symbol",
  "qty": "qty",
  "price": "price",
  "side": "side",
  "orderType": "orderType",
  "timeInForce": "timeInForce",
  "posSide": "posSide",
  "clientOid": "clientOid",
  "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/v3/trade/batch-modify-order

限频规则: 10次/秒/UID

支持API批量改单，可以同时提交多笔跨交易对订单（限同一个业务线订单）
每次请求最多支持修改20笔
支持连续改单，即在前一个改单申请完成前可以再提交多个改单申请，在途修改订单最多连续提交5笔改单申请，撮合将依序处理改单请求
同一批改单申请中，每个委托订单只能存在一个
仅支持完全未成交订单修改价格、数量
支持部分成交订单修改价格、数量 (不可低于已成交数量)
不支持改只减仓(reduceOnly)委托

限频规则: 10次/秒/UID
需要统一账户交易读写权限

批量修改订单 › Request Parameters

orderId

string

订单ID
orderId和clientOid二者必填其一
如同时传入orderId及clientOid，则orderId优先级更高

clientOid

string

自定义订单ID
orderId和clientOid二者必填其一
如同时传入orderId及clientOid，则orderId优先级更高

qty

string

下单数量
base coin

price

string

下单价格

autoCancel

string

category

string

产品类型
SPOT 现货交易
MARGIN 杠杆交易
USDT-FUTURES USDT合约
COIN-FUTURES 币本位合约
USDC-FUTURES USDC合约

symbol

string

交易对名称
例如：BTCUSDT

批量修改订单 › Response Parameters

200

Successful response

code

string

msg

string

requestTime

integer

object

orderId

string

订单号

clientOid

string

自定义订单号

批量撤单

POST

https://api.bitget.com

/api/v3/trade/cancel-batch

限频规则: 5次/秒/UID

该接口支持批量取消现货、合约、杠杆的未成交以及部分成交订单
在批量撤单操作中，请确保每次调用仅使用orderId或clientOid进行标识，避免混用。如果在一次调用中混合使用orderId和clientOid，则clientOid将失效
批量撤单允许部分成功

限频规则: 5次/秒/UID
批量限制：每批不能超过20笔委托单
需要统一账户交易读写权限

批量撤单 › Request Parameters

category

string · required

产品类型
SPOT 现货交易
MARGIN 杠杆交易
USDT-FUTURES USDT合约
COIN-FUTURES 币本位合约
USDC-FUTURES USDC合约
所有委托单的产品类型必须相同

symbol

string · required

交易对名称
例如：BTCUSDT

orderId

string

订单号
clientOid和orderId二者必填其一
如用户同时传入orderId及clientOid,则orderId优先级更高

clientOid

string

自定义订单号d
clientOid和orderId二者必填其一
如用户同时传入orderId及clientOid,则orderId优先级更高

批量撤单 › Response Parameters

200

Successful response

code

string

msg

string

requestTime

integer

object

orderId

string

订单id

clientOid

string

自定义订单id

code

string

这笔委托单的Error code

msg

string

这笔委托单的Error message

一键撤单

POST

https://api.bitget.com

/api/v3/trade/cancel-symbol-order

限频规则: 5次/秒/UID

按交易对或者业务线撤销未成交以及部分成交的挂单

限频规则: 5次/秒/UID
需要统一账户交易读写权限

一键撤单 › Request Parameters

category

string · required

产品类型
SPOT 现货交易
MARGIN 杠杆
USDT-FUTURES U本位合约
COIN-FUTURES 币本位合约
USDC-FUTURES USDC合约

symbol

string

交易对名称
例如：BTCUSDT 如不填，则取消 category 下所有symbol挂单

一键撤单 › Response Parameters

200

Successful response

code

string

msg

string

requestTime

integer

object

object[]

列表

获取订单信息

GET

https://api.bitget.com

/api/v3/trade/order-info

限频规则: 20次/秒/UID

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

限频规则: 20次/秒/UID
需要统一账户交易只读/读写权限

获取订单信息 › Request Parameters

orderId

string

订单号
clientOid和orderId必传其一。如同时传参，则orderId优先级更高

clientOid

string

自定义订单号
clientOid和orderId必传其一。如同时传参，则orderId优先级更高

获取订单信息 › Response Parameters

200

Successful response

code

string

msg

string

requestTime

integer

object

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
rpi: 零售价格优化订单

posSide

string

仓位方向
long: 开
short: 平
只适用合约订单

tradeSide

string

交易方向
open: 开
close : 平
详细枚举可以在枚举页面获取

holdMode

string

持仓模式
one_way_mode: 单向持仓
hedge_mode: 双向持仓
只适用合约订单

marginMode

string

保证金模式
crossed: 全仓
isolated: 逐仓
只适用合约订单

stpMode

string

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

takeProfit

string

止盈触发价格

stopLoss

string

止损触发价格

tpTriggerBy

string

止盈触发类型
market: 市场价格
mark: 标记价格

slTriggerBy

string

止损触发类型
market: 市场价格
mark: 标记价格

tpOrderType

string

止盈订单类型
limit: 限价单
market: 市价单

slOrderType

string

止损订单类型
limit: 限价单
market: 市价单

tpLimitPrice

string

止盈限价单执行价格

slLimitPrice

string

止损限价单执行价格

reduceOnly

string

是否减仓单
YES: 是
NO: 否
只适用合约订单

feeDetail

string[]

手续费明细

> feeCoin

string

手续费币种

> fee

string

总计手续费

delegateType

string

委托类型
normal 限价普通
stop_profit_market 最优价止盈
stop_loss_market 最优价止损
stop_profit_chase 止盈追价委托
stop_loss_chase 止损追价委托
trader_delegate 带单委托
trader_stop_profit 带单止盈
trader_stop_loss 带单止损
follower_delegate 跟单委托
reduce_offset_delegate 减仓扎差委托
market 最优价普通
market_risk 最优价风险处理
plan_limit 限价计划委托
plan_market 最优价计划委托
back_contract 反手
trader_back_contract 带单反手
strategy_grid_positive 策略-正向网格
strategy_grid_reverse 策略-反向网格
strategy_unlimited 无限策略
stop_profit_limit 限价止盈
stop_loss_limit 限价止损
move_stop_limit 限价移动止盈止损
move_stop_market 最优价移动止盈止损
position_stop_profit_limit 限价仓位止盈
position_stop_profit_market 最优价仓位止盈
position_stop_loss_limit 限价仓位止损
position_stop_loss_market 最优价仓位止损
tracking_plan_limit 限价追踪委托
tracking_plan_market 最优价追踪委托
delivery_close_long 多头交割
delivery_close_short 空头交割
liquidation 爆仓清算
strategy_dca_positive DCA策略-正向
strategy_dca_reverse DCA策略-反向
spot_trace_trader_buy 现货带单买
spot_trace_follower_buy 现货跟单买
spot_trace_trader_sell 现货带单卖
spot_trace_follower_sell 现货跟单卖
strategy_oco_limit 策略-OCO限价单
strategy_oco_trigger 策略-OCO触发单
modify_limit_order 限价修改
strategy_regular_buy 策略-定投策略买
strategy_grid_middle 策略-中性网格
strategy_cta_positive CTA策略-正向
strategy_cta_reverse CTA策略-反向
strategy_tpsl_limit 现货止盈止损限价单
strategy_tpsl_market 现货止盈止损市价单
strategy_contract_ai 合约AI智投
strategy_trace_market 追踪委托市价单
strategy_trace_limit 追踪委托限价单
strategy_portfolio_buy 策略-囤币宝买
strategy_portfolio_sell 策略-囤币宝卖
strategy_tradingview TRADINGVIEW信号接入策略
sigan_trace 信号跟单
mmr_stop_loss_market 最优价MMR止损
bbo_opponent1 BBO-对手价1
bbo_opponent5 BBO-对手价5
bbo_companion1 BBO-同向价1
bbo_companion5 BBO-同向价5
bbo_opponent1_profit BBO-对手价1止盈
bbo_opponent5_profit BBO-对手价5止盈
bbo_companion1_profit BBO-同向价1止盈
bbo_companion5_profit BBO-同向价5止盈
bbo_opponent1_loss BBO-对手价1止损
bbo_opponent5_loss BBO-对手价5止损
bbo_companion1_loss BBO-同向价1止损
bbo_companion5_loss BBO-同向价5止损
spot_bbo_opponent1_tpsl BBO-对手价1止盈止损
spot_bbo_opponent5_tpsl BBO-对手价5止盈止损
spot_bbo_companion1_tpsl BBO-同向价1止盈止损
spot_bbo_companion5_tpsl BBO-同向价5止盈止损
dummy_bbo_profit BBO-止盈
dummy_bbo_loss BBO-止损
strategy_pre_tpsl_limit 现货预设止盈止损限价单
strategy_pre_tpsl_market 现货预设止盈止损市价单
future_signal_delegate 合约喊单跟单限价单
grant_market 体验券开仓
tg_signal_limit TG信号单
tg_signal_tp_market TG信号单止盈
tg_signal_sl_market TG信号单止损
strategy_preset_tpsl_limit 现货预设计划委托止盈止损限价单
strategy_preset_tpsl_market 现货预设计划委托止盈止损市价单
trader_iceberg_limit 冰山委托
trader_time_share_market 分时委托
strategy_arbitrage_positive 资金费套利策略正向
strategy_arbitrage_reverse 资金费套利策略反向
convert_hedging 闪兑操盘
off_close 下架平仓

cancelReason

string

撤销原因
normal_cancel: 常规取消
详细枚举可以在枚举页面获取

execType

string

执行类型
normal: 常规成交
offset: 轧差订单
reduce: 强制减仓单
liquidation: 爆仓单
delivery: 交割订单

createdTime

string

订单创建时间
Unix时间戳，毫秒

updatedTime

string

订单更新时间
Unix时间戳，毫秒

GET/api/v3/trade/order-info

curl https://api.bitget.com/api/v3/trade/order-info

Example Responses

{
  "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",
    "marginMode": "crossed",
    "stpMode": "none",
    "takeProfit": "",
    "stopLoss": "",
    "tpTriggerBy": "",
    "slTriggerBy": "",
    "tpOrderType": "",
    "slOrderType": "",
    "tpLimitPrice": "",
    "slLimitPrice": "",
    "feeDetail": [
      {
        "feeCoin": "ETH",
        "fee": "0.00000744"
      }
    ],
    "delegateType": "normal",
    "cancelReason": "",
    "execType": "",
    "createdTime": "1730295766596",
    "updatedTime": "1730295766691"
  }
}

json

application/json

获取当前委托

GET

https://api.bitget.com

/api/v3/trade/unfilled-orders

限频规则: 20次/秒/UID

查询未成交及部分成交订单。查询已成交订单，请使用【获取历史委托单】接口

订单持有上限: - 合约: USDT合约/币本位合约/USDC合约所有交易对加起来一共最多支持400个订单 - 现货: 现货/杠杆所有交易对最多支持400订单

限频规则: 20次/秒/UID
需要统一账户交易只读/读写权限

获取当前委托 › Request Parameters

category

string

产品类型
SPOT 现货交易
MARGIN 杠杆交易
USDT-FUTURES U本位合约
COIN-FUTURES 币本位合约
USDC-FUTURES USDC合约

symbol

string

交易对名称
例如：BTCUSDT

startTime

string

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

endTime

string

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

limit

string

每页条目数
最大100，默认100

cursor

string

分页游标
用于翻页，首次查询不传，查询第二页及后面的数据时，取上一次查询返回的最小orderId，结果会返回小于该值的数据

获取当前委托 › Response Parameters

200

Successful response

code

string

msg

string

requestTime

integer

object

list

string[]

订单列表

>orderId

string

订单ID

>clientOid

string

自定义订单ID

>category

string

产品类型
SPOT 现货交易
MARGIN 杠杆交易
USDT-FUTURES U本位合约
COIN-FUTURES 币本位合约
USDC-FUTURES USDC合约

>symbol

string

交易对名称
例如：BTCUSDT

>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: 部分成交

>side

string

订单方向
buy: 买
sell: 卖

>timeInForce

string

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

>posSide

string

交易方向
long: 开
short: 平

>holdMode

string

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

>delegateType

string

委托类型
normal: 限价普通
stop_profit_market: 最优价止盈
stop_loss_market: 最优价止损
stop_profit_chase: 止盈追价委托
stop_loss_chase: 止损追价委托
trader_delegate: 带单委托
trader_stop_profit: 带单止盈
trader_stop_loss: 带单止损
follower_delegate: 跟单委托
reduce_offset_delegate: 减仓扎差委托
market: 最优价普通
market_risk: 最优价风险处理
plan_limit: 限价计划委托
plan_market: 最优价计划委托
back_contract: 反手
trader_back_contract: 带单反手
strategy_grid_positive: 策略-正向网格
strategy_grid_reverse: 策略-反向网格
strategy_unlimited: 无限策略
stop_profit_limit: 限价止盈
stop_loss_limit: 限价止损
move_stop_limit: 限价移动止盈止损
move_stop_market: 最优价移动止盈止损
position_stop_profit_limit: 限价仓位止盈
position_stop_profit_market: 最优价仓位止盈
position_stop_loss_limit: 限价仓位止损
position_stop_loss_market: 最优价仓位止损
tracking_plan_limit: 限价追踪委托
tracking_plan_market: 最优价追踪委托
delivery_close_long: 多头交割
delivery_close_short: 空头交割
liquidation: 爆仓清算
strategy_dca_positive: DCA策略-正向
strategy_dca_reverse: DCA策略-反向
spot_trace_trader_buy: 现货带单买
spot_trace_follower_buy: 现货跟单买
spot_trace_trader_sell: 现货带单卖
spot_trace_follower_sell: 现货跟单卖
strategy_oco_limit: 策略-OCO限价单
strategy_oco_trigger: 策略-OCO触发单
modify_limit_order: 限价修改
strategy_regular_buy: 策略-定投策略买
strategy_grid_middle: 策略-中性网格
strategy_cta_positive: CTA策略-正向
strategy_cta_reverse: CTA策略-反向
strategy_tpsl_limit: 现货止盈止损限价单
strategy_tpsl_market: 现货止盈止损市价单
strategy_contract_ai: 合约AI智投
strategy_trace_market: 追踪委托市价单
strategy_trace_limit: 追踪委托限价单
strategy_portfolio_buy: 策略-囤币宝买
strategy_portfolio_sell: 策略-囤币宝卖
strategy_tradingview: TRADINGVIEW信号接入策略
sigan_trace: 信号跟单
mmr_stop_loss_market: 最优价MMR止损
bbo_opponent1: BBO-对手价1
bbo_opponent5: BBO-对手价5
bbo_companion1: BBO-同向价1
bbo_companion5: BBO-同向价5
bbo_opponent1_profit: BBO-对手价1止盈
bbo_opponent5_profit: BBO-对手价5止盈
bbo_companion1_profit: BBO-同向价1止盈
bbo_companion5_profit: BBO-同向价5止盈
bbo_opponent1_loss: BBO-对手价1止损
bbo_opponent5_loss: BBO-对手价5止损
bbo_companion1_loss: BBO-同向价1止损
bbo_companion5_loss: BBO-同向价5止损
spot_bbo_opponent1_tpsl: BBO-对手价1止盈止损
spot_bbo_opponent5_tpsl: BBO-对手价5止盈止损
spot_bbo_companion1_tpsl: BBO-同向价1止盈止损
spot_bbo_companion5_tpsl: BBO-同向价5止盈止损
dummy_bbo_profit: BBO-止盈
dummy_bbo_loss: BBO-止损
strategy_pre_tpsl_limit: 现货预设止盈止损限价单
strategy_pre_tpsl_market: 现货预设止盈止损市价单
future_signal_delegate: 合约喊单跟单限价单
grant_market: 体验券开仓
tg_signal_limit: TG信号单
tg_signal_tp_market: TG信号单止盈
tg_signal_sl_market: TG信号单止损
strategy_preset_tpsl_limit: 现货预设计划委托止盈止损限价单
strategy_preset_tpsl_market: 现货预设计划委托止盈止损市价单
trader_iceberg_limit: 冰山委托
trader_time_share_market: 分时委托
strategy_arbitrage_positive: 资金费套利策略正向
strategy_arbitrage_reverse: 资金费套利策略反向
liquidation_take_over_long: 爆仓接管多仓
liquidation_take_over_short: 爆仓接管空仓
convert_hedging: 闪兑操盘
off_close: 下架平仓

>marginMode

string

保证金模式
crossed: 全仓
isolated: 逐仓
只适用合约订单

>stpMode

string

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

>takeProfit

string

止盈触发价格

>stopLoss

string

止损触发价格

>tpTriggerBy

string

止盈触发类型
market: 市场价格
mark: 标记价格

>slTriggerBy

string

止损触发类型
market: 市场价格
mark: 标记价格

>tpOrderType

string

止盈订单类型
limit: 限价单
market: 市价单

>slOrderType

string

止损订单类型
limit: 限价单
market: 市价单

>tpLimitPrice

string

止盈限价单执行价格

>slLimitPrice

string

止损限价单执行价格

>reduceOnly

string

是否减仓单
YES: 是
NO: 否

>feeDetail

string[]

手续费明细

>> feeCoin

string

手续费币种

>> fee

string

总计手续费

>createdTime

string

订单创建时间
Unix毫秒时间戳，例如1690196141868

>updatedTime

string

订单更新时间
Unix毫秒时间戳，例如1690196141868

cursor

string

翻页游标（取当前页最小 orderId，传入查询更早的订单）

GET/api/v3/trade/unfilled-orders

curl https://api.bitget.com/api/v3/trade/unfilled-orders

Example Responses

{
  "code": "00000",
  "msg": "success",
  "requestTime": 1730186730084,
  "data": {
    "list": [
      {
        "orderId": "111111111111111111",
        "clientOid": "111111111111111111",
        "category": "USDT-FUTURES",
        "symbol": "BTCUSDT",
        "orderType": "limit",
        "side": "buy",
        "price": "45000",
        "qty": "0.01",
        "amount": "0",
        "cumExecQty": "0",
        "cumExecValue": "0",
        "avgPrice": "0",
        "timeInForce": "gtc",
        "orderStatus": "live",
        "posSide": "long",
        "holdMode": "hedge_mode",
        "delegateType": "normal",
        "reduceOnly": "NO",
        "marginMode": "crossed",
        "stpMode": "none",
        "takeProfit": "",
        "stopLoss": "",
        "tpTriggerBy": "",
        "slTriggerBy": "",
        "tpOrderType": "",
        "slOrderType": "",
        "tpLimitPrice": "",
        "slLimitPrice": "",
        "feeDetail": [
          {
            "feeCoin": null,
            "fee": null
          }
        ],
        "createdTime": "1730186725663",
        "updatedTime": "1730186725691"
      }
    ],
    "cursor": "1235058132196622336"
  }
}

json

application/json

获取历史委托

GET

https://api.bitget.com

/api/v3/trade/history-orders

限频规则: 20次/秒/UID

查询90天内的历史委托单

查询时间范围

每次查询只支持查询90天内的30天数据

限频规则: 20次/秒/UID
需要统一账户交易只读/读写权限

获取历史委托 › Request Parameters

category

string · required

产品类型
SPOT 现货交易
MARGIN 杠杆交易
USDT-FUTURES USDT合约
COIN-FUTURES 币本位合约
USDC-FUTURES USDC合约

symbol

string

交易对名称
例如：BTCUSDT

startTime

string

开始时间戳
Unix时间戳的毫秒数格式，如 1597026383085
最大查询范围90天

endTime

string

结束时间戳
Unix时间戳的毫秒数格式，如 1597026383085
startTime和endTime间隔不超过30天

limit

string

每页条目数
最大100，默认100

cursor

string

游标ID
用于翻页，首次查询不传，查询第二页及后面的数据时，取上一次查询返回的最小orderId，结果会返回小于该值的数据

获取历史委托 › Response Parameters

200

Successful response

code

string

msg

string

requestTime

integer

object

object[]

订单列表

cursor

string

分页游标

GET/api/v3/trade/history-orders

curl 'https://api.bitget.com/api/v3/trade/history-orders?category=<string>'

Example Responses

{
  "code": "00000",
  "msg": "success",
  "requestTime": 1730186348272,
  "data": {
    "list": [
      {
        "orderId": "111111111111111111",
        "clientOid": "111111111111111111",
        "category": "USDT-FUTURES",
        "symbol": "BTCUSDT",
        "orderType": "limit",
        "side": "sell",
        "price": "49534.4",
        "qty": "0.429",
        "amount": "0",
        "cumExecQty": "0.429",
        "cumExecValue": "21250.2929",
        "avgPrice": "49534.4",
        "timeInForce": "gtc",
        "orderStatus": "filled",
        "posSide": "long",
        "holdMode": "hedge_mode",
        "delegateType": "normal",
        "reduceOnly": "NO",
        "marginMode": "crossed",
        "stpMode": "none",
        "takeProfit": "",
        "stopLoss": "",
        "tpTriggerBy": "",
        "slTriggerBy": "",
        "tpOrderType": "",
        "slOrderType": "",
        "tpLimitPrice": "",
        "slLimitPrice": "",
        "feeDetail": [
          {
            "feeCoin": "USDT",
            "fee": "4.2500586"
          }
        ],
        "cancelReason": "normal_cancel",
        "execType": "liquidation",
        "createdTime": "1730181468493",
        "updatedTime": "1730181468493"
      }
    ],
    "cursor": "1233319323918499840"
  }
}

json

application/json

获取成交明细

GET

https://api.bitget.com

/api/v3/trade/fills

限频规则: 20次/秒/UID

获取用户最近90天内委托单成交明细

查询时间范围

每次查询只支持查询90天内的30天数据

限频规则: 20次/秒/UID
需要统一账户交易只读/读写权限

获取成交明细 › Request Parameters

category

string

产品类型
SPOT 现货交易
MARGIN 杠杆交易
USDT-FUTURES USDT合约
COIN-FUTURES 币本位合约
USDC-FUTURES USDC合约

orderId

string

订单ID

startTime

string

开始时间戳
Unix时间戳的毫秒数格式，如 1597026383085
最大查询范围90天

endTime

string

结束时间戳
Unix时间戳的毫秒数格式，如 1597026383085
startTime和endTime间隔不超过30天

limit

string

查询条数
最大100，默认100

cursor

string

分页游标
用于翻页，首次查询不传，查询第二页及后面的数据时，取上一次查询返回cursor

获取成交明细 › Response Parameters

200

Successful response

code

string

msg

string

requestTime

integer

object

object[]

成交明细集合

cursor

string

分页游标

GET/api/v3/trade/fills

curl https://api.bitget.com/api/v3/trade/fills

Example Responses

{
  "code": "00000",
  "msg": "success",
  "requestTime": 1750142995229,
  "data": {
    "list": [
      {
        "execId": "131111111111111111",
        "execLinkId": "131111111111111111",
        "orderId": "131111111111111111",
        "clientOid": "131111111111111111",
        "category": "USDT-FUTURES",
        "symbol": "BTCUSDT",
        "orderType": "market",
        "side": "sell",
        "tradeSide": "open",
        "execPrice": "106950.1",
        "execQty": "0.01",
        "execValue": "1069.501",
        "tradeScope": "taker",
        "feeDetail": [
          {
            "feeCoin": "USDT",
            "fee": "0.6417006"
          }
        ],
        "createdTime": "1750141421721",
        "updatedTime": "1750141421728",
        "execPnl": "-0.002",
        "isRPI": "no"
      }
    ],
    "cursor": "131111111111111111"
  }
}

json

application/json

创建Reality股票订单

POST

https://api.bitget.com

/api/v3/trade/place-reality-order

限频规则: 10次/秒/UID

对 Reality 股票交易对进行限价或市价下单。
该接口仅对白名单 UID 开放，如有需要请联系BD。

限频规则: 10次/秒/UID
需要统一账户交易权限

创建Reality股票订单 › Request Parameters

symbol

string · required

交易对名称
如 rAAPLUSDT
该接口仅支持 Reality 股票交易对

side

string · required

方向
buy 买
sell 卖

orderType

string · required

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

qty

string · required

下单数量
市价买单，单位为 quote coin
限价及市价卖单，单位为 base coin

category

string

交易类型
SPOT 现货交易
MARGIN 杠杆交易
默认值：SPOT

price

string

委托价格
orderType=limit 时必传

clientOid

string

自定义订单 ID

创建Reality股票订单 › Response Parameters

200

Successful response

code

string

msg

string

requestTime

integer

object

orderId

string

系统订单 ID

clientOid

string

客户端自定义订单 ID，未传则返回空字符串

撤销Reality股票订单

POST

https://api.bitget.com

/api/v3/trade/cancel-reality-order

限频规则: 10次/秒/UID

撤销未成交或部分成交的 Reality 股票订单。
该接口仅对白名单 UID 开放，如有需要请联系BD。

限频规则: 10次/秒/UID
需要统一账户交易权限

撤销Reality股票订单 › Request Parameters

symbol

string · required

交易对名称
如 rAAPLUSDT

category

string

交易类型
SPOT 现货交易
MARGIN 杠杆交易
默认值：SPOT

orderId

string

系统订单 ID
orderId 与 clientOid 至少传其一；同时传入时 orderId 优先

clientOid

string

自定义订单 ID
orderId 与 clientOid 至少传其一；同时传入时 orderId 优先

撤销Reality股票订单 › Response Parameters

200

Successful response

code

string

msg

string

requestTime

integer

object

orderId

string

系统订单 ID

clientOid

string

客户端自定义订单 ID，未传则返回空字符串

仓位管理