bybit-exchange · petifish · Aug 31, 2026 · Aug 27, 2026 · Aug 27, 2026 · Aug 27, 2026
diff --git a/docs/changelog/v5.mdx b/docs/changelog/v5.mdx
@@ -4,6 +4,11 @@ title: V5
 
 import '/src/css/changelog.css';
 
+## 2026-09-02
+### REST API
+- [Event Trading](../v5/event/introduction) [NEW]
+    - Launch Event Contract OpenAPI. Includes Market, Trade endpoints and WebSocket streams.
+
 ## 2026-08-31
 ### REST API
 - [Integration Guidance](../v5/guide#authentication)

diff --git a/docs/v5/account/transaction-log.mdx b/docs/v5/account/transaction-log.mdx
@@ -16,7 +16,7 @@ Query for transaction logs in your Unified account. It supports up to 2 years wo
 | Parameter | Required | Type | Comments|
 |:----- |:-------|:-----|------ |
 |[accountType](../enum#accounttype) |false |string |Account Type. `UNIFIED`|
-|[category](../enum#category) |false |string |Product type `spot`,`linear`,`option`,`inverse`|
+|[category](../enum#category) |false |string |Product type `spot`,`linear`,`option`,`inverse`,`event`|
 |currency |false |string |Currency, uppercase only |
 |baseCoin |false |string |BaseCoin, uppercase only. e.g., BTC of BTCPERP|
 |[type](../enum#typeuta-translog) |false |string |Types of transaction logs|
@@ -32,7 +32,7 @@ Query for transaction logs in your Unified account. It supports up to 2 years wo
 |list |array |Object |
 |> id |string |Unique id |
 |> symbol |string |Symbol name |
-|> category |string |Product type |
+|> category |string |Product type. `spot`,`linear`,`option`,`inverse`,`event`|
 |> side |string |Side. `Buy`,`Sell`,`None` |
 |> transactionTime |string |Transaction timestamp (ms)|
 |> [type](../enum#typeuta-translog) |string |Type |

diff --git a/docs/v5/enum.mdx b/docs/v5/enum.mdx
@@ -437,7 +437,7 @@ _Options:_
 * `TRANSFER_OUT`&emsp;Assets that transferred out from Unified wallet
 * `TRADE`
 * `SETTLEMENT`&emsp;USDT Perp funding settlement, and USDC Perp funding settlement + USDC 8-hour session settlement
-* `DELIVERY`&emsp;USDC Futures, Option delivery
+* `DELIVERY`&emsp;USDC Futures, Option delivery, Event Contract settlement
 * `LIQUIDATION`
 * `ADL`&emsp;Auto-Deleveraging
 * `AIRDROP`

diff --git a/docs/v5/event/.gitkeep b/docs/v5/event/.gitkeep
diff --git a/docs/v5/event/introduction.mdx b/docs/v5/event/introduction.mdx
@@ -0,0 +1,15 @@
+---
+title: Introduction
+sidebar_label: Introduction
+sidebar_position: 0
+---
+
+## Overview
+
+Event Contract is a structured product offered by Bybit that allows users to trade on the outcome of market events with a defined payout structure.
+
+## Access
+
+:::caution
+Only **market makers** are permitted to call the Event Contract OpenAPI endpoints. To apply for market maker access, please contact your **Relation Manager**.
+:::
diff --git a/docs/v5/event/market/.gitkeep b/docs/v5/event/market/.gitkeep
diff --git a/docs/v5/event/market/instrument-info.mdx b/docs/v5/event/market/instrument-info.mdx
@@ -0,0 +1,240 @@
+---
+title: Get Instrument Info
+sidebar_label: Get Instrument Info
+sidebar_position: 1
+---
+
+Query Event Contract instrument information with pagination support.
+
+### HTTP Request
+<APIEndpoint method="GET" url="/v5/event/instruments-info" />
+
+### Request Parameters
+| Parameter | Required | Type | Comments |
+|:----------|:---------|:-----|:---------|
+|symbol |false |string |Symbol name, e.g. `ETHUSDT-28AUG26-2450-2570-OUT`|
+|status |false |string |`PreLaunch`, `Trading`, `Delivering`, `Closed`|
+|limit |false |integer |Items per page. Default: `50`, range: [`1`, `100`]|
+|cursor |false |string |Pagination cursor. Use `nextPageCursor` from the previous response|
+
+### Response Parameters
+| Parameter | Type | Comments |
+|:----------|:-----|:---------|
+|nextPageCursor |string |Cursor for next page|
+|list |array |Instrument list|
+|> symbol |string |Symbol name|
+|> symbolId |integer |Symbol ID|
+|> baseCoin |string |Base coin|
+|> quoteCoin |string |Quote coin|
+|> settleCoin |string |Settle coin|
+|> eventContractType |string |Event Contract type: `Up_Down`, `Target`, `Range`|
+|> durationWindow |string |Duration window in seconds. Empty string for non-Up_Down types|
+|> rvThreshold |string |Volatility threshold|
+|> rebate |string |Rebate rate. `0` for Up_Down type|
+|> takerFeeRate |string |Taker fee rate|
+|> makerFeeRate |string |Maker fee rate|
+|> launchTime |string |Launch time in milliseconds|
+|> deliveryTime |string |Delivery time in milliseconds|
+|> status |string |Symbol status: `PreLaunch`, `Trading`, `Delivering`, `Closed`|
+|> targetPrice |string |Target price. Target type only. `"0"` for Up_Down and Range|
+|> lowerBound |string |[Range only] Lower bound of the range (exclusive). If the price is below this value, Range Out wins. `"0"` for Up_Down and Target|
+|> upperBound |string |[Range only] Upper bound of the range (exclusive). If the price is above this value, Range Out wins. `"0"` for Up_Down and Target|
+|> callOptionSymbolId |integer |Maps to the corresponding Call option symbolId. (1) Range upper bound: call option symbolId for the upper bound Strike; (2) Target ABOVE: call option symbolId for the Strike; (3) Up_Down and Target BELOW: `0`|
+|> putOptionSymbolId |integer |Maps to the corresponding Put option symbolId. (1) Range lower bound: put option symbolId for the lower bound Strike; (2) Target BELOW: put option symbolId for the Strike; (3) Up_Down and Target ABOVE: `0`|
+|> feeRateRule |array |Fee rate config|
+|>> minSecToDelivery |integer |Interval start — seconds from now to settlement|
+|>> maxSecToDelivery |integer |Interval end — seconds from now to settlement|
+|>> baseMarkup |string |Base markup|
+|> lotSizeFilter |object |Lot size config|
+|>> minOrderAmount |string |Minimum order amount|
+|>> maxOrderAmount |string |Maximum order amount|
+|>> orderAmountTickSize |string |Order amount tick size|
+|>> quoteMaxValidMs |integer |Maximum validity period for a single quote (milliseconds)|
+|>> quoteMinIntervalPerUserMs |integer |Minimum interval between quote requests per UID (milliseconds)|
+|> quotationLimit |array |Quotation limit config|
+|>> minSecToDelivery |integer |Interval start — seconds from now to settlement|
+|>> maxSecToDelivery |integer |Interval end — seconds from now to settlement|
+|>> quoteMaxAmountPerUser |string |Maximum cumulative quote amount per UID|
+|>> quoteMinAmountPerUser |string |Minimum cumulative quote amount per UID|
+|>> quoteMinAmount |string |Minimum amount per single quote|
+
+---
+
+### Request Example
+
+```http
+GET /v5/event/instruments-info?status=Trading&limit=10 HTTP/1.1
+Host: api.bybit.com
+```
+
+### Response Example
+
+```json
+{
+    "retCode": 0,
+    "retMsg": "OK",
+    "result": {
+        "nextPageCursor": "0%2C10",
+        "list": [
+            {
+                "symbolId": 500017,
+                "symbol": "BTCUSDT-15MIN-DOWN",
+                "baseCoin": "BTC",
+                "quoteCoin": "USDT",
+                "settleCoin": "USDT",
+                "eventContractType": "Up_Down",
+                "durationWindow": 900,
+                "rvThreshold": "0.60",
+                "rebate": "0",
+                "takerFeeRate": "0.0088",
+                "makerFeeRate": "0",
+                "launchTime": "1786000980000",
+                "deliveryTime": "1798779602000",
+                "status": "Trading",
+                "targetPrice": "0",
+                "lowerBound": "0",
+                "upperBound": "0",
+                "callOptionSymbolId": 0,
+                "putOptionSymbolId": 0,
+                "feeRateRule": [
+                    {
+                        "minSecToDelivery": 0,
+                        "maxSecToDelivery": 315360000,
+                        "baseMarkup": "0.0600"
+                    }
+                ],
+                "quotationLimit": [
+                    {
+                        "minSecToDelivery": 0,
+                        "maxSecToDelivery": 315360000,
+                        "quoteMaxAmountPerUser": "20000",
+                        "quoteMinAmountPerUser": "10000",
+                        "quoteMinAmount": "50"
+                    }
+                ],
+                "lotSizeFilter": {
+                    "minOrderAmount": "5",
+                    "maxOrderAmount": "800",
+                    "orderAmountTickSize": "1",
+                    "quoteMaxValidMs": 60000,
+                    "quoteMinIntervalPerUserMs": 200
+                }
+            },
+            {
+                "symbolId": 500241,
+                "symbol": "ETHUSDT-22AUG26-1850-2000-OUT",
+                "baseCoin": "ETH",
+                "quoteCoin": "USDT",
+                "settleCoin": "USDT",
+                "eventContractType": "Range",
+                "durationWindow": "",
+                "rvThreshold": "0.62",
+                "rebate": "0.25",
+                "takerFeeRate": "0.008",
+                "makerFeeRate": "0",
+                "launchTime": "1787018820000",
+                "deliveryTime": "1787385600000",
+                "status": "Trading",
+                "targetPrice": "0",
+                "lowerBound": "1850",
+                "upperBound": "2000",
+                "callOptionSymbolId": 32101659,
+                "putOptionSymbolId": 32101656,
+                "feeRateRule": [
+                    {
+                        "minSecToDelivery": 0,
+                        "maxSecToDelivery": 259200,
+                        "baseMarkup": "0.0230"
+                    },
+                    {
+                        "minSecToDelivery": 259200,
+                        "maxSecToDelivery": 315360000,
+                        "baseMarkup": "0.0180"
+                    }
+                ],
+                "quotationLimit": [
+                    {
+                        "minSecToDelivery": 0,
+                        "maxSecToDelivery": 259200,
+                        "quoteMaxAmountPerUser": "6000000",
+                        "quoteMinAmountPerUser": "5000",
+                        "quoteMinAmount": "500"
+                    },
+                    {
+                        "minSecToDelivery": 259200,
+                        "maxSecToDelivery": 315360000,
+                        "quoteMaxAmountPerUser": "990",
+                        "quoteMinAmountPerUser": "3000",
+                        "quoteMinAmount": "500"
+                    }
+                ],
+                "lotSizeFilter": {
+                    "minOrderAmount": "5",
+                    "maxOrderAmount": "500",
+                    "orderAmountTickSize": "1",
+                    "quoteMaxValidMs": 6000000,
+                    "quoteMinIntervalPerUserMs": 5000
+                }
+            },
+            {
+                "symbolId": 500239,
+                "symbol": "ETHUSDT-22AUG26-1850-BELOW",
+                "baseCoin": "ETH",
+                "quoteCoin": "USDT",
+                "settleCoin": "USDT",
+                "eventContractType": "Target",
+                "durationWindow": "",
+                "rvThreshold": "0.62",
+                "rebate": "0.25",
+                "takerFeeRate": "0.008",
+                "makerFeeRate": "0",
+                "launchTime": "1787051280000",
+                "deliveryTime": "1787385600000",
+                "status": "Trading",
+                "targetPrice": "1850",
+                "lowerBound": "0",
+                "upperBound": "0",
+                "callOptionSymbolId": 0,
+                "putOptionSymbolId": 32101656,
+                "feeRateRule": [
+                    {
+                        "minSecToDelivery": 0,
+                        "maxSecToDelivery": 259200,
+                        "baseMarkup": "0.0230"
+                    },
+                    {
+                        "minSecToDelivery": 259200,
+                        "maxSecToDelivery": 315360000,
+                        "baseMarkup": "0.0180"
+                    }
+                ],
+                "quotationLimit": [
+                    {
+                        "minSecToDelivery": 0,
+                        "maxSecToDelivery": 259200,
+                        "quoteMaxAmountPerUser": "990000",
+                        "quoteMinAmountPerUser": "5000",
+                        "quoteMinAmount": "500"
+                    },
+                    {
+                        "minSecToDelivery": 259200,
+                        "maxSecToDelivery": 315360000,
+                        "quoteMaxAmountPerUser": "9000000",
+                        "quoteMinAmountPerUser": "3000",
+                        "quoteMinAmount": "500"
+                    }
+                ],
+                "lotSizeFilter": {
+                    "minOrderAmount": "5",
+                    "maxOrderAmount": "500",
+                    "orderAmountTickSize": "1",
+                    "quoteMaxValidMs": 6000000,
+                    "quoteMinIntervalPerUserMs": 5000
+                }
+            }
+        ]
+    },
+    "retExtInfo": {},
+    "time": 1787108703481
+}
+```
diff --git a/docs/v5/event/market/orderbook.mdx b/docs/v5/event/market/orderbook.mdx
@@ -0,0 +1,58 @@
+---
+title: Get Orderbook
+sidebar_label: Get Orderbook
+sidebar_position: 2
+---
+
+Query 25-level orderbook data for an Event Contract symbol.
+
+### HTTP Request
+<APIEndpoint method="GET" url="/v5/event/orderbook" />
+
+### Request Parameters
+| Parameter | Required | Type | Comments |
+|:----------|:---------|:-----|:---------|
+|symbol |**true** |string |Symbol name, e.g. `ETHUSDT-28AUG26-2450-2570-OUT`|
+
+### Response Parameters
+| Parameter | Type | Comments |
+|:----------|:-----|:---------|
+|s |string |Symbol name|
+|r |array |Orderbook entries. Up to 25 levels. Each entry is `[payoutRatio, orderValue]`|
+|ts |integer |Matching engine timestamp in milliseconds|
+|u |integer |Update ID|
+|seq |integer |Cross sequence number|
+|cts |integer |Creation timestamp in milliseconds|
+
+---
+
+### Request Example
+
+```http
+GET /v5/event/orderbook?symbol=ETHUSDT-28AUG26-2450-2570-OUT HTTP/1.1
+Host: api.bybit.com
+```
+
+### Response Example
+
+```json
+{
+    "retCode": 0,
+    "retMsg": "OK",
+    "result": {
+        "s": "BTCUSDT-5MIN-UP",
+        "r": [
+            [
+                "0.90",
+                "50000"
+            ]
+        ],
+        "ts": 1716863719031,
+        "u": 230704,
+        "seq": 1432604333,
+        "cts": 1716863718905
+    },
+    "retExtInfo": {},
+    "time": 1716863719382
+}
+```
diff --git a/docs/v5/event/trade/.gitkeep b/docs/v5/event/trade/.gitkeep