Get Cross History Orders

Rate limit:10 req/sec/UID

Description

HTTP Request

• GET /api/v2/margin/crossed/history-orders

Request Example

curl "https://api.bitget.com/api/v2/margin/crossed/history-orders?symbol=BTCUSDT&limit=20&startTime=1693205171000&endTime=1694155571000" \
   -H "ACCESS-KEY:*******" \
   -H "ACCESS-SIGN:*******" \
   -H "ACCESS-PASSPHRASE:*****" \
   -H "ACCESS-TIMESTAMP:1659076670000" \
   -H "locale:en-US" \
   -H "Content-Type: application/json" \

Request Parameters

Parameter	Type	Required	Description
symbol	String	Yes	Trading pairs, like BTCUSDT
orderId	String	No	Order ID
enterPointSource	String	No	Order source WEB: Orders created on the website API: Orders created on API SYS: System managed orders, usually generated by forced liquidation logic ANDROID: Orders created on the Android app IOS: Orders created on the iOS app
clientOid	String	No	Client customized ID
startTime	String	Yes	Start time, Unix millisecond timestamp
endTime	String	No	End time, Unix millisecond timestamp Maximum interval between start time and end time is 90 days
limit	String	No	Number of quiries Default: 100, maximum: 500
idLessThan	String	No	For turning pages It's not needed in the first query. When querying data in the second page and the data beyond, the last endId returned in the last query is used, and the result will return data with a value less than this one; the query response time will be shortened.

Response Example

{
    "code": "00000",
    "msg": "success",
    "requestTime": 1695636829522,
    "data": {
        "orderList": [
            {
                "orderId": "121211212122",
                "symbol": "BTCUSDT",
                "orderType": "limit",
                "enterPointSource": "API",
                "clientOid": "myClientOid001",
                "loanType": "normal",
                "price": "32111",
                "side": "buy",
                "status": "filled",
                "baseSize": "0.01",
                "quoteSize": "1000",
                "priceAvg": "32111",
                "size": "0.01",
                "amount": "1000",
                "force": "gtc",
                "cTime": "1695629859821",
                "uTime": "1695629890839"
            }
        ],
        "maxId": "121211212122",
        "minId": "121211212122"
    }
}

Response Parameters

Parameter	Type	Description
symbol	String	Trading pair
orderId	String	Order ID
clientOid	String	Client customized ID
size	String	Filled quantity
priceAvg	String	Order price
amount	String	Filled volume
force	String	Time in force gtc: normal limit order, good till canceled post_only: Post only fok: Fill or kill ioc: Immediate or cancel
price	String	Order price
enterPointSource	String	Order source WEB: Orders created on the website API: Orders created on API SYS: System managed orders, usually generated by forced liquidation logic ANDROID: Orders created on the Android app IOS: Orders created on the iOS app
status	String	Order status live: New order partially_fill: Partially filled filled: Fully filled cancelled: Cancelled reject: Rejected
side	String	Direction sell: Sell buy: Buy liquidation-buy: Settlement – buy liquidation-sell: Settlement – sell systemRepay-buy: Repay by system – buy systemRepay-selll: Repay by system – sell
baseSize	String	Quantity of the base currency
quoteSize	String	Quantity of the quote currency
orderType	String	Order type limit: limit price market: market price
cTime	String	Creation time
uTime	String	Updated time
loanType	String	Margin order model normal: place a normal order autoLoan place an order with auto-borrow autoRepay place an order with auto-repay autoLoanAndRepay place an order with auto-borrow and auto-repay