Skip to main content

Get History Orders

Frequency limit: 20 times/1s (UID)

Description

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

HTTP Request

  • GET /api/v2/spot/trade/history-orders
Request Example
curl "https://api.bitget.com/api/v2/spot/trade/history-orders?symbol=BTCUSDT&startTime=1659036670000&endTime=1659076670000&limit=20" \
-H "ACCESS-KEY:*******" \
-H "ACCESS-SIGN:*" \
-H "ACCESS-PASSPHRASE:*" \
-H "ACCESS-TIMESTAMP:1659076670000" \
-H "locale:en-US" \
-H "Content-Type: application/json"

request parameter

ParameterTypeRequiredDescription
symbolStringNoTrading pair
startTimeStringNoThe 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)
endTimeStringNoThe end time of the record for the query. Unix millisecond timestamp, e.g. 1690196141868
idLessThanStringNoRequests the content on the page before this ID (older data), the value input should be the orderId of the corresponding interface.
limitStringNoLimit number default 100 max 100
orderIdStringNoOrderId
tpslTypeStringNoorder type deafult normal
normal spot order
tpsl spot tpsl order
requestTimeStringNorequest Time Unix millisecond timestamp
receiveWindowStringNovalid window period Unix millisecond timestamp Unix millisecond timestamp
Response Example
{
"code": "00000",
"message": "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},\"USDT\":{\"deduction\":false,\"feeCoinCode\":\"ETH\",\"totalDeductionFee\":0,\"totalFee\":-0.1120792560000000}}",
"orderSource": "market",
"cTime": "1698736299656",
"uTime": "1698736300363",
"tpslType": "normal",
"cancelReason": "",
"triggerPrice": null
}
]
}

Response Parameter

ParameterTypeDescription
userIdStringUser id
symbolStringTrading pair name
orderIdStringOrder ID
clientOidStringClient Order ID
priceStringOrder price
sizeStringAmount
(orderType = limit means base coin; orderType = market means quote coin)
orderTypeStringOrder type
limit Limit price
market Market price
sideStringDirection
statusStringOrder status
live:unfilled;
partially_filled:partially filled;
filled:filled;
cancelled:cancelled;
priceAvgStringAverage fill price
baseVolumeStringFilled volume (base coin)
quoteVolumeStringFilled volume (quote coin)
enterPointSourceStringClient
WEB WEB Client
APP APP Client
API API Client
SYS SYS Client
ANDROID ANDROID Client
IOS IOS Client
orderSourceStringOrder 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)
cTimeStringCreation time, Unix millisecond timestamp, e.g. 1690196141868
uTimeStringUpdate time, Unix millisecond timestamp, e.g. 1690196141868
feeDetailStringFee details. If there is a "newFees" field, then "newFees" represents the fee details. If not, the remaining information is the fee details.
> newFeesStringFee details for "newFees".
>> cStringAmount deducted by coupons, unit:currency obtained from the transaction.
>> dStringAmount deducted in BGB (Bitget Coin), unit:BGB
>> rStringIf the BGB balance is insufficient to cover the fees, the remaining amount is deducted from the currency obtained from the transaction.
>> tStringThe total fee amount to be paid, unit :currency obtained from the transaction.
>> deductionStringIgnore.
>> totalDeductionFeeStringIgnore.
> BGBStringIf 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).
>> deductionStringWhether there is a fee deduction.
>> feeCoinCodeStringTransaction fee coin code
>> totalDeductionFeeStringDeduction amount unit: BGB
>> totalFeeStringThe total fee amount to be paid, unit:currency obtained from the transaction.
triggerPriceStringspot tpsl trigger price
tpslTypeStringnormal spot order
tpsl spot tpsl order
cancelReasonStringCancel reason
normal_cancel: Normal cancel
stp_cancel: Cancelled by STP

How was your Reading Experience with us?