Trade

Classic Account — Spot — Trade

Place Order

POST

https://api.bitget.com

/api/v2/spot/trade/place-order

Rate limit: 10 requests/second/UID Rate limit: 1 request/second/UID for copy trading traders

Place Order

API Broker rebate identifier: The following code block needs to be added to the HTTP Header of the request.

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

Place Order › Request Parameters

symbol

string · required

Trading pair name, e.g. BTCUSDT

side

string · required

Order Direction buy: Buy sell: Sell

orderType

string · required

Order type limit: Limit order market: Market order

force

string · required

Execution strategy(It is invalid when orderType is market) gtc: Normal limit order, good till cancelled post_only: Post only fok: Fill or kill ioc: Immediate or cancel

size

string · required

Amount. For Limit and Market-Sell orders, it represents the number of base coins. For Market-Buy orders, it represents the number of quote coins.

price

string

Limit price

clientOid

string

Customed order ID. It's invalid when tpslType is tpsl

triggerPrice

string

SPOT TP/SL trigger price, only required in SPOT TP/SL order

tpslType

string

Order type normal: SPOT order(default) tpsl: SPOT TP/SL order

requestTime

string

Request Time, Unix millisecond timestamp

receiveWindow

string

Valid time window, Unix millisecond timestamp

stpMode

string

STP Mode(Self Trade Prevention) none: not setting STP(default) cancel_taker: cancel taker order cancel_maker: cancel maker order cancel_both: cancel both of taker and maker orders

presetTakeProfitPrice

string

Take profit price. It's invalid when tpslType is tpsl

executeTakeProfitPrice

string

Take profit execute price. It's invalid when tpslType is tpsl

presetStopLossPrice

string

Stop loss price. It's invalid when tpslType is tpsl

executeStopLossPrice

string

Stop loss execute price. It's invalid when tpslType is tpsl

Place Order › Response Parameters

200

Successful response

code

string

msg

string

requestTime

integer

object

orderId

string

Order ID

clientOid

string

Custom order ID

POST/api/v2/spot/trade/place-order

curl https://api.bitget.com/api/v2/spot/trade/place-order \
  --request POST \
  --header 'Content-Type: application/json' \
  --data '{
  "symbol": "symbol",
  "side": "side",
  "orderType": "orderType",
  "force": "force",
  "price": "price",
  "size": "size",
  "clientOid": "clientOid",
  "triggerPrice": "triggerPrice",
  "tpslType": "tpslType",
  "requestTime": "requestTime",
  "receiveWindow": "receiveWindow",
  "stpMode": "stpMode",
  "presetTakeProfitPrice": "presetTakeProfitPrice",
  "executeTakeProfitPrice": "executeTakeProfitPrice",
  "presetStopLossPrice": "presetStopLossPrice",
  "executeStopLossPrice": "executeStopLossPrice"
}'

Example Request Body

{
  "symbol": "symbol",
  "side": "side",
  "orderType": "orderType",
  "force": "force",
  "price": "price",
  "size": "size",
  "clientOid": "clientOid",
  "triggerPrice": "triggerPrice",
  "tpslType": "tpslType",
  "requestTime": "requestTime",
  "receiveWindow": "receiveWindow",
  "stpMode": "stpMode",
  "presetTakeProfitPrice": "presetTakeProfitPrice",
  "executeTakeProfitPrice": "executeTakeProfitPrice",
  "presetStopLossPrice": "presetStopLossPrice",
  "executeStopLossPrice": "executeStopLossPrice"
}

json

Example Responses

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

json

application/json

Batch Place Orders

POST

https://api.bitget.com

/api/v2/spot/trade/batch-orders

Frequency limit: 5 times/1s (UID) Trader frequency limit: 1 times/1s (UID)

Place Orders in Batch

API Broker rebate identifier: The following code block needs to be added to the HTTP Header of the request.

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

Batch Place Orders › Request Parameters

object[] · required

Collection of placing orders，maximum length: 50

batchMode

string

Batch order mode single single currency mode, default single currency mode multiple cross-currency mode. If single mode, the symbol in orderList will be ignored. If multiple mode, the symbol in orderList is not allowed to be null, and the symbol in orderList is required. The symbol outside orderList will be ignored.

symbol

string

Trading pair name, e.g. BTCUSDT. Used when batchMode is single.

Batch Place Orders › Response Parameters

200

Successful response

code

string

msg

string

requestTime

integer

object

object[]

Successful order number

object[]

Failed order number

POST/api/v2/spot/trade/batch-orders

curl https://api.bitget.com/api/v2/spot/trade/batch-orders \
  --request POST \
  --header 'Content-Type: application/json' \
  --data '{
  "batchMode": "batchMode",
  "orderList": [
    {
      "symbol": "symbol",
      "side": "side",
      "orderType": "orderType",
      "force": "force",
      "price": "price",
      "size": "size",
      "clientOid": "clientOid",
      "stpMode": "stpMode",
      "presetTakeProfitPrice": "presetTakeProfitPrice",
      "executeTakeProfitPrice": "executeTakeProfitPrice",
      "presetStopLossPrice": "presetStopLossPrice",
      "executeStopLossPrice": "executeStopLossPrice"
    }
  ],
  "symbol": "symbol"
}'

Example Request Body

{
  "batchMode": "batchMode",
  "orderList": [
    {
      "symbol": "symbol",
      "side": "side",
      "orderType": "orderType",
      "force": "force",
      "price": "price",
      "size": "size",
      "clientOid": "clientOid",
      "stpMode": "stpMode",
      "presetTakeProfitPrice": "presetTakeProfitPrice",
      "executeTakeProfitPrice": "executeTakeProfitPrice",
      "presetStopLossPrice": "presetStopLossPrice",
      "executeStopLossPrice": "executeStopLossPrice"
    }
  ],
  "symbol": "symbol"
}

json

Example Responses

{
  "code": "00000",
  "msg": "success",
  "requestTime": 1666336231317,
  "data": {
    "successList": [
      {
        "orderId": "121211212122",
        "clientOid": "1"
      }
    ],
    "failureList": [
      {
        "orderId": "121211212122",
        "clientOid": "1",
        "errorMsg": "clientOrderId duplicate",
        "errorCode": "43118"
      }
    ]
  }
}

json

application/json

Cancel Order

POST

https://api.bitget.com

/api/v2/spot/trade/cancel-order

Frequency limit:10 times/1s (UID)

Cancel Order

Cancel Order › Request Parameters

symbol

string

Trading pair name, e.g. BTCUSDT. It is not required when tpslType is tpsl

tpslType

string

order type, deafult:normal normal spot order tpsl spot tpsl order

orderId

string

Order ID. Either orderId or clientOid is required. It's required when tpslType is tpsl

clientOid

string

Client Order ID. Either orderId or clientOid is required

Cancel Order › Response Parameters

200

Successful response

code

string

msg

string

requestTime

integer

object

orderId

string

Order ID

clientOid

string

Client Order ID

Batch Cancel Orders

POST

https://api.bitget.com

/api/v2/spot/trade/batch-cancel-order

Frequency limit:10 times/1s (UID)

Cancel Orders in Batch

For batch cancellation (simultaneously revoking multiple orders for the same symbol), it is not permitted to mix the use of orderId and clientOid. The identifiers used must be consistent across all orders in the batch. Otherwise, orders that only submit a clientOid will fail to be cancelled.

Batch Cancel Orders › Request Parameters

object[] · required

Order ID List, maximum length: 50

symbol

string

Trading pair name, e.g. BTCUSDT

batchMode

string

Batch Cancel Orders › Response Parameters

200

Successful response

code

string

msg

string

requestTime

integer

object

object[]

Successful order number

object[]

Failed order number

POST/api/v2/spot/trade/batch-cancel-order

curl https://api.bitget.com/api/v2/spot/trade/batch-cancel-order \
  --request POST \
  --header 'Content-Type: application/json' \
  --data '{
  "symbol": "symbol",
  "batchMode": "batchMode",
  "orderList": [
    {
      "symbol": "symbol",
      "orderId": "orderId",
      "clientOid": "clientOid"
    }
  ]
}'

Example Request Body

{
  "symbol": "symbol",
  "batchMode": "batchMode",
  "orderList": [
    {
      "symbol": "symbol",
      "orderId": "orderId",
      "clientOid": "clientOid"
    }
  ]
}

json

Example Responses

{
  "code": "00000",
  "msg": "success",
  "requestTime": 1695808949356,
  "data": {
    "successList": [
      {
        "orderId": "121211212122",
        "clientOid": "121211212122"
      }
    ],
    "failureList": [
      {
        "orderId": "121211212122",
        "clientOid": "xxx001",
        "errorMsg": "duplicate clientOrderId",
        "errorCode": "43118"
      }
    ]
  }
}

json

application/json

Cancel Order by Symbol

POST

https://api.bitget.com

/api/v2/spot/trade/cancel-symbol-order

Frequency limit: 5 times/1s (UID)

Cancel order by symbol

Cancel Order by Symbol › Request Parameters

symbol

string · required

Trading pair name, e.g. BTCUSDT

Cancel Order by Symbol › Response Parameters

200

Successful response

code

string

msg

string

requestTime

integer

object

symbol

string

Cancelled symbol (This request is executed asynchronously. If you need to know the result, please query the Get History Orders endpoint.)

Cancel an Existing Order and Send a New Order

POST

https://api.bitget.com

/api/v2/spot/trade/cancel-replace-order

Rate limit: 5 requests/second/UID

Cancel an Existing Order and Send a New Order

API Broker rebate identifier: The following code block needs to be added to the HTTP Header of the request.

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

Cancel an Existing Order and Send a New Order › Request Parameters

symbol

string · required

Trading pair name, e.g. BTCUSDT

price

string · required

Limit price

size

string · required

Amount，it represents the number of base coins.

clientOid

string

Client Order ID. Either orderId or clientOid is required

orderId

string

Order ID. Either orderId or clientOid is required

newClientOid

string

New customed order ID. If newClientOid results in idempotency duplication, it may cause the old order to be successfully canceled but the new order placement to fail.

presetTakeProfitPrice

string

Take profit price

executeTakeProfitPrice

string

Take profit execute price

presetStopLossPrice

string

Stop loss price

executeStopLossPrice

string

Stop loss execute price

Cancel an Existing Order and Send a New Order › Response Parameters

200

Successful response

code

string

msg

string

requestTime

integer

object

orderId

string

Order ID

clientOid

string | null

Client Order ID

success

string

operate success success: success failure: failure

msg

string | null

Failure reason

POST/api/v2/spot/trade/cancel-replace-order

curl https://api.bitget.com/api/v2/spot/trade/cancel-replace-order \
  --request POST \
  --header 'Content-Type: application/json' \
  --data '{
  "symbol": "symbol",
  "price": "price",
  "size": "size",
  "clientOid": "clientOid",
  "orderId": "orderId",
  "newClientOid": "newClientOid",
  "presetTakeProfitPrice": "presetTakeProfitPrice",
  "executeTakeProfitPrice": "executeTakeProfitPrice",
  "presetStopLossPrice": "presetStopLossPrice",
  "executeStopLossPrice": "executeStopLossPrice"
}'

Example Request Body

{
  "symbol": "symbol",
  "price": "price",
  "size": "size",
  "clientOid": "clientOid",
  "orderId": "orderId",
  "newClientOid": "newClientOid",
  "presetTakeProfitPrice": "presetTakeProfitPrice",
  "executeTakeProfitPrice": "executeTakeProfitPrice",
  "presetStopLossPrice": "presetStopLossPrice",
  "executeStopLossPrice": "executeStopLossPrice"
}

json

Example Responses

{
  "code": "00000",
  "msg": "success",
  "requestTime": 1725345009763,
  "data": {
    "orderId": "xxxxxxxxxxxxxxx",
    "clientOid": null,
    "success": "success",
    "msg": null
  }
}

json

application/json

Batch Cancel Existing Order and Send New Orders

POST

https://api.bitget.com

/api/v2/spot/trade/batch-cancel-replace-order

Rate limit: 5 requests/second/UID

Cancel an Existing Order and Send a New Order

API Broker rebate identifier: The following code block needs to be added to the HTTP Header of the request.

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

Batch Cancel Existing Order and Send New Orders › Request Parameters

object[] · required

Collection of placing orders，maximum length: 50

Batch Cancel Existing Order and Send New Orders › Response Parameters

200

Successful response

code

string

msg

string

requestTime

integer

object[]

orderId

string

Order ID

clientOid

string | null

Client Order ID

success

string

operate success success: success failure: failure

msg

string

Failure reason

POST/api/v2/spot/trade/batch-cancel-replace-order

curl https://api.bitget.com/api/v2/spot/trade/batch-cancel-replace-order \
  --request POST \
  --header 'Content-Type: application/json' \
  --data '{
  "orderList": [
    {
      "symbol": "symbol",
      "price": "price",
      "size": "size",
      "clientOid": "clientOid",
      "orderId": "orderId",
      "newClientOid": "newClientOid",
      "presetTakeProfitPrice": "presetTakeProfitPrice",
      "executeTakeProfitPrice": "executeTakeProfitPrice",
      "presetStopLossPrice": "presetStopLossPrice",
      "executeStopLossPrice": "executeStopLossPrice"
    }
  ]
}'

Example Request Body

{
  "orderList": [
    {
      "symbol": "symbol",
      "price": "price",
      "size": "size",
      "clientOid": "clientOid",
      "orderId": "orderId",
      "newClientOid": "newClientOid",
      "presetTakeProfitPrice": "presetTakeProfitPrice",
      "executeTakeProfitPrice": "executeTakeProfitPrice",
      "presetStopLossPrice": "presetStopLossPrice",
      "executeStopLossPrice": "executeStopLossPrice"
    }
  ]
}

json

Example Responses

{
  "code": "00000",
  "msg": "success",
  "requestTime": 1725341809524,
  "data": [
    {
      "orderId": "xxxxxxxxxxxxxxxxxxxxxx",
      "clientOid": null,
      "success": "failure",
      "msg": "xxxxxx"
    }
  ]
}

json

application/json

Get Order Info

GET

https://api.bitget.com

/api/v2/spot/trade/orderInfo

Frequency limit: 20 times/1s (UID)

Get Order Info

Get Order Info › Request Parameters

orderId

string

Either Order ID or clientOids is required.

clientOid

string

Either Client customized ID or orderId is required.

requestTime

string

request Time Unix millisecond timestamp

receiveWindow

string

valid window period Unix millisecond timestamp

Get Order Info › Response Parameters

200

Successful response

code

string

msg

string

requestTime

integer

object[]

userId

string

Account id

symbol

string

Trading pair name

orderId

string

Order ID

clientOid

string

Customized ID

price

string

Order price

size

string

Amount. Limit represents the number of base coins. market-buy represents the number of quote coins. market-sell represents the number of base coins.

orderType

string

Order type limit Limit price market Market price

side

string

Direction

status

string

Order status live: pending match partially_filled: Partially filled filled: All filled cancelled: The order is cancelled

priceAvg

string

Filled price

baseVolume

string

Filled quantity (base coin)

quoteVolume

string

Total trading amount (quote coin)

enterPointSource

string

Client WEB WEB Client API API Client SYS SYS Client ANDROID ANDROID Client IOS IOS Client

cTime

string

Creation time, Unix millisecond timestamp, e.g. 1690196141868

uTime

string

Update time, Unix millisecond timestamp, e.g. 1690196141868

orderSource

string

Order source normal Normal order market Market order spot_trader_buy Elite spot trade to buy (elite traders) spot_follower_buy Copy trade to buy (followers) spot_trader_sell Elite spot trade to sell (elite traders) spot_follower_sell Copy trade to sell (followers)

feeDetail

string

Transaction fee breakdown

newFees: Fee details for "newFees".

c: Amount deducted by coupons, unit: currency obtained from the transaction. d: Amount deducted in BGB (Bitget Coin), unit: BGB r: If the BGB balance is insufficient to cover the fees, the remaining amount is deducted from the currency obtained from the transaction. t: The total fee amount to be paid, unit: currency obtained from the transaction. deduction: Ignore. totalDeductionFee: Ignore. BGB: (Ignore) If there is no "newFees" field, this data represents earlier historical data. This key represents the currency used for fee deduction (it is not fixed; if BGB deduction is enabled, it's BGB, otherwise, it's the currency obtained from the transaction). deduction: Whether there is a fee deduction. feeCoinCode: Transaction fee coin code totalDeductionFee: Deduction amount unit: BGB totalFee: The total fee amount to be paid, unit: currency obtained from the transaction.

tpslType

string

normal: spot order tpsl: spot tpsl order

triggerPrice

string | null

Spot tpsl trigger price (Only valid when tpslType is tpsl)

quoteCoin

string

Quote coin

baseCoin

string

Base coin

cancelReason

string

Cancel reason normal_cancel: Normal cancel stp_cancel: Cancelled by STP

executionType

string

Execution type exchange: exchange

GET/api/v2/spot/trade/orderInfo

curl https://api.bitget.com/api/v2/spot/trade/orderInfo

Example Responses

{
  "code": "00000",
  "msg": "success",
  "requestTime": 1695865476577,
  "data": [
    {
      "userId": "**********",
      "symbol": "BTCUSDT",
      "orderId": "121211212122",
      "clientOid": "121211212122",
      "price": "0",
      "size": "10.0000000000000000",
      "orderType": "market",
      "side": "buy",
      "status": "filled",
      "priceAvg": "13000.0000000000000000",
      "baseVolume": "0.0007000000000000",
      "quoteVolume": "9.1000000000000000",
      "enterPointSource": "API",
      "feeDetail": "{\"BGB\":{\"deduction\":true,\"feeCoinCode\":\"BGB\",\"totalDeductionFee\":-0.0041,\"totalFee\":-0.0041},\"newFees\":{\"c\":0,\"d\":0,\"deduction\":false,\"r\":-0.112079256,\"t\":-0.112079256,\"totalDeductionFee\":0}}",
      "orderSource": "market",
      "tpslType": "normal",
      "triggerPrice": null,
      "quoteCoin": "USDT",
      "baseCoin": "BTC",
      "cancelReason": "",
      "executionType": "exchange",
      "cTime": "1695865232127",
      "uTime": "1695865233051"
    }
  ]
}

json

application/json

Get Current Orders

GET

https://api.bitget.com

/api/v2/spot/trade/unfilled-orders

Frequency limit: 20 times/1s (UID)

Get Unfilled Orders

Get Current Orders › Request Parameters

symbol

string

Trading pair

startTime

string

The record start time for the query. Unix millisecond timestamp, e.g. 1690196141868 (Only queries for data from the past 90 days are allowed.)

endTime

string

The end time of the record for the query. Unix millisecond timestamp, e.g. 1690196141868 (The startTime and endTime should be within 90 days.)

idLessThan

string

Requests the content on the page before this ID (older data), the value input should be the orderId of the corresponding interface.

limit

string

Limit number default 100 max 100

orderId

string

OrderId

tpslType

string

order type deafult normal normal spot order tpsl spot tpsl order

requestTime

string

request Time Unix millisecond timestamp

receiveWindow

string

valid window period Unix millisecond timestamp

Get Current Orders › Response Parameters

200

Successful response

code

string

msg

string

requestTime

integer

object[]

userId

string

User id

symbol

string

Trading pair name

orderId

string

Order ID

clientOid

string

Client order ID

priceAvg

string

Order price

size

string

Amount. (orderType = limit means base coin; orderType = market means quote coin)

orderType

string

Order type limit Limit price market Market price

side

string

Direction

status

string

Order status live:unfilled; partially_filled:partially filled; filled:filled; cancelled:cancelled;

basePrice

string

Filled price

baseVolume

string

Filled volume in base coin

quoteVolume

string

Filled volume in quote coin

enterPointSource

string

Client type WEB WEB Client APP APP Client API API Client SYS SYS Client ANDROID ANDROID Client IOS IOS Client

orderSource

string

Order source normal: Normal order market: Market order spot_trader_buy: Elite spot trade to buy (elite traders) spot_follower_buy: Copy trade to buy (followers) spot_trader_sell: Elite spot trade to sell (elite traders) spot_follower_sell: Copy trade to sell (followers) strategy_oco_limit: OCO orders

triggerPrice

string | null

spot tpsl trigger price(Only valid when tpslType is tpsl)

tpslType

string

normal spot order tpsl spot tpsl order

presetTakeProfitPrice

string

Take profit trigger price

executeTakeProfitPrice

string

Take profit execute price(If the value is empty, it means take profit in market price)

presetStopLossPrice

string

Stop loss trigger price

executeStopLossPrice

string

Stop loss execute price(If the value is empty, it means stop loss in market price)

cTime

string

Creation time, Unix millisecond timestamp, e.g. 1690196141868

uTime

string

Update time, Unix millisecond timestamp, e.g. 1690196141868

force

string

Execution strategy gtc: Normal limit order, good till cancelled post_only: Post only fok: Fill or kill ioc: Immediate or cancel

executionType

string

Execution type exchange: exchange

GET/api/v2/spot/trade/unfilled-orders

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

Example Responses

{
  "code": "00000",
  "msg": "success",
  "requestTime": 1695808949356,
  "data": [
    {
      "userId": "**********",
      "symbol": "btcusdt",
      "orderId": "2222222",
      "clientOid": "xxxxxxx",
      "priceAvg": "34829.12",
      "size": "1",
      "orderType": "limit",
      "side": "buy",
      "status": "new",
      "basePrice": "0",
      "baseVolume": "0",
      "quoteVolume": "0",
      "enterPointSource": "WEB",
      "orderSource": "normal",
      "triggerPrice": null,
      "tpslType": "normal",
      "presetTakeProfitPrice": "70000",
      "executeTakeProfitPrice": "",
      "presetStopLossPrice": "10000",
      "executeStopLossPrice": "",
      "force": "gtc",
      "executionType": "exchange",
      "cTime": "1622697148",
      "uTime": "1622697148"
    }
  ]
}

json

application/json

Get History Orders

GET

https://api.bitget.com

/api/v2/spot/trade/history-orders

Frequency limit: 20 times/1s (UID)

Get History Orders(It only supports to get the data within 90days. The older data can be downloaded from web)

Get History Orders › Request Parameters

symbol

string

Trading pair

startTime

string

The record start time for the query. Unix millisecond timestamp, e.g. 1690196141868. (For Managed Sub-Account, the StartTime cannot be earlier than the binding time)

endTime

string

The end time of the record for the query. Unix millisecond timestamp, e.g. 1690196141868

idLessThan

string

Requests the content on the page before this ID (older data), the value input should be the orderId of the corresponding interface.

limit

string

Limit number default 100 max 100

orderId

string

OrderId

tpslType

string

order type deafult normal normal spot order tpsl spot tpsl order

requestTime

string

request Time Unix millisecond timestamp

receiveWindow

string

valid window period Unix millisecond timestamp

Get History Orders › Response Parameters

200

Successful response

code

string

msg

string

requestTime

integer

object[]

userId

string

User id

symbol

string

Trading pair name

orderId

string

Order ID

clientOid

string

Client Order ID

price

string

Order price

size

string

Amount (orderType = limit means base coin; orderType = market means quote coin)

orderType

string

Order type limit Limit price market Market price

side

string

Direction

status

string

Order status live:unfilled; partially_filled:partially filled; filled:filled; cancelled:cancelled;

priceAvg

string

Average fill price

baseVolume

string

Filled volume (base coin)

quoteVolume

string

Filled volume (quote coin)

enterPointSource

string

Client WEB WEB Client APP APP Client API API Client SYS SYS Client ANDROID ANDROID Client IOS IOS Client

orderSource

string

cTime

string

Creation time, Unix millisecond timestamp, e.g. 1690196141868

uTime

string

Update time, Unix millisecond timestamp, e.g. 1690196141868

feeDetail

string

Fee details. If there is a "newFees" field, then "newFees" represents the fee details. If not, the remaining information is the fee details.

newFees: Fee details for "newFees".

c: Amount deducted by coupons, unit: currency obtained from the transaction. d: Amount deducted in BGB (Bitget Coin), unit: BGB r: If the BGB balance is insufficient to cover the fees, the remaining amount is deducted from the currency obtained from the transaction. t: The total fee amount to be paid, unit: currency obtained from the transaction. deduction: Ignore. totalDeductionFee: Ignore. BGB: If there is no "newFees" field, this data represents earlier historical data. This key represents the currency used for fee deduction (it is not fixed; if BGB deduction is enabled, it's BGB, otherwise, it's the currency obtained from the transaction). deduction: Whether there is a fee deduction. feeCoinCode: Transaction fee coin code totalDeductionFee: Deduction amount unit: BGB totalFee: The total fee amount to be paid, unit: currency obtained from the transaction.

triggerPrice

string | null

spot tpsl trigger price

tpslType

string

normal spot order tpsl spot tpsl order

cancelReason

string

Cancel reason normal_cancel: Normal cancel stp_cancel: Cancelled by STP

quoteCoin

string

Quote coin

baseCoin

string

Base coin

executionType

string

Execution type exchange: exchange

GET/api/v2/spot/trade/history-orders

curl https://api.bitget.com/api/v2/spot/trade/history-orders

Example Responses

{
  "code": "00000",
  "msg": "success",
  "requestTime": 1695808949356,
  "data": [
    {
      "userId": "*********",
      "symbol": "ETHUSDT",
      "orderId": "*****************************",
      "clientOid": "*****************************",
      "price": "0",
      "size": "20.0000000000000000",
      "orderType": "market",
      "side": "buy",
      "status": "filled",
      "priceAvg": "1598.1000000000000000",
      "baseVolume": "0.0125000000000000",
      "quoteVolume": "19.9762500000000000",
      "enterPointSource": "WEB",
      "feeDetail": "{\"newFees\":{\"c\":0,\"d\":0,\"deduction\":false,\"r\":-0.112079256,\"t\":-0.112079256,\"totalDeductionFee\":0}}",
      "orderSource": "market",
      "quoteCoin": "USDT",
      "baseCoin": "ETH",
      "executionType": "exchange",
      "cTime": "1698736299656",
      "uTime": "1698736300363",
      "tpslType": "normal",
      "cancelReason": "",
      "triggerPrice": null
    }
  ]
}

json

application/json

Get Fills

GET

https://api.bitget.com

/api/v2/spot/trade/fills

Frequency limit:10 times/1s (UID) Trader frequency limit: 1 times/1s (UID)

Get Fills(It only supports to get the data within 90days.The older data can be downloaded from web)

Get Fills › Request Parameters

symbol

string

Trading pair name

orderId

string

Order ID

startTime

string

The start time of the orders, i.e. to get orders after that timestamp. Unix millisecond timestamp, e.g. 1690196141868. (For Managed Sub-Account, the StartTime cannot be earlier than the binding time)

endTime

string

The end time of a fulfilled order, i.e., get orders prior to that timestamp. Unix millisecond timestamp, e.g. 1690196141868. The interval between startTime and endTime must not exceed 90 days.

limit

string

Number of results returned: Default: 100, max 100

idLessThan

string

Requests the content on the page before this ID (older data), the value input should be the tradeId of the corresponding interface.

Get Fills › Response Parameters

200

Successful response

code

string

msg

string

requestTime

integer

object[]

userId

string

Account ID

symbol

string

Trading pair name

orderId

string

Order ID

tradeId

string

Transaction id

orderType

string

Order type

side

string

Order direction

priceAvg

string

Filled price

size

string

Filled quantity

amount

string

Total trading amount

cTime

string

Creation time, Unix second timestamp, e.g. 1622697148

uTime

string

Update time, Unix second timestamp, e.g. 1622697148

tradeScope

string

Trader tag taker Taker maker Maker

object

Transaction fee breakdown