Get Event Contract Order History

Query Event Contract historical orders. Returns orders in the past 2 years.

info

• Only Event Contract maker accounts are allowed to access this endpoint.
• Results are sorted by createdTime in descending order.
• Default query window: 7 days if startTime/endTime are not specified.

HTTP Request

GET/v5/event/order-list

Request Parameters

Parameter	Required	Type	Comments
symbol	false	string	Symbol name, e.g. ETHUSDT-28AUG26-2450-2570-OUT
orderId	false	string	Order ID
orderLinkId	false	string	User-defined order ID
startTime	false	integer	Start time in milliseconds. Default: 7 days ago
endTime	false	integer	End time in milliseconds. Default: now
limit	false	integer	Number of items per page. Default: 50, Range: [1, 100]
cursor	false	string	Pagination cursor

Response Parameters

Parameter	Type	Comments
list	array	Event Contract order history list
> orderId	string	Order ID
> orderLinkId	string	User-defined order ID
> orderStatus	string	Order status: Filled, Cancelled, Rejected, PartiallyFilledCanceled
> symbol	string	Symbol name
> symbolId	string	Symbol ID
> baseCoin	string	Base coin
> quoteCoin	string	Quote coin
> settleCoin	string	Settle coin
> ecDirection	string	Direction: UP/DOWN (UpDown type), ABOVE/BELOW (Target type), RANGE_IN/RANGE_OUT (Range type)
> ecDurationWindow	string	Duration window in seconds
> ecTargetPrice	string	Target price. Target type only.
> ecContractType	string	Event contract type: UpDown, Target, Range
> ecLowerBound	string	Lower bound. Range type only.
> ecUpperBound	string	Upper bound. Range type only.
> settleTimeMs	string	Settlement time in milliseconds
> ecOrderValue	string	Event Contract order value
> ecIndexPrice	string	Index price at order creation
> orderAvgPayoutRatio	string	Average payout ratio of filled portion
> cumExecValue	string	Cumulative executed value
> payoutRatio	string	Order payout ratio (price)
> tradeFee	string	Trade fee
> transTime	string	Transaction time in milliseconds
> createTime	string	Order creation time in milliseconds
> updateTime	string	Order update time in milliseconds
> cumPayout	string	Cumulative payout
> cumExecFee	string	Cumulative executed fee
> cancelType	string	Cancel type. Empty if not cancelled.
> createType	string	Order create type, e.g. CreateByUser
> rejectReason	string	Reject reason. Empty if not rejected.
> extraFees	string	Extra fees (JSON string if applicable)
cursor	string	Cursor for next page pagination

---

Request Example

GET /v5/event/order-list?symbol=ETHUSDT-28AUG26-2450-2570-OUT&limit=50 HTTP/1.1
Host: api.bybit.com
X-BAPI-SIGN: XXXXX
X-BAPI-API-KEY: xxxxxxxxxxxxxxxxxx
X-BAPI-TIMESTAMP: 1694402559000
X-BAPI-RECV-WINDOW: 5000

Response Example

{
    "retCode": 0,
    "retMsg": "OK",
    "result": {
        "list": [
            {
                "orderId": "1234567890",
                "orderLinkId": "",
                "orderStatus": "Filled",
                "symbol": "ETHUSDT-28AUG26-2450-2570-OUT",
                "symbolId": "100001",
                "baseCoin": "BTC",
                "quoteCoin": "USDT",
                "settleCoin": "USDT",
                "ecDirection": "UP",
                "ecDurationWindow": "300",
                "ecTargetPrice": "",
                "ecContractType": "UpDown",
                "ecLowerBound": "",
                "ecUpperBound": "",
                "settleTimeMs": "1694515498753",
                "ecOrderValue": "50",
                "ecIndexPrice": "26000.5",
                "orderAvgPayoutRatio": "1.85",
                "cumExecValue": "50",
                "payoutRatio": "1.95",
                "tradeFee": "0.5",
                "transTime": "1694402559843",
                "createTime": "1694402559843",
                "updateTime": "1694515498753",
                "cumPayout": "92.5",
                "cumExecFee": "0.5",
                "cancelType": "",
                "createType": "CreateByUser",
                "rejectReason": "",
                "extraFees": ""
            }
        ],
        "cursor": ""
    },
    "retExtInfo": {},
    "time": 1694402560000
}