vnpy_okx 2025.12.28__py3-none-any.whl → 2026.2.1__py3-none-any.whl

vnpy_okx/__init__.py

@@ -23,7 +23,7 @@
 from .okx_gateway import OkxGateway
 
 
-__version__ = "2025.12.28"
+__version__ = "2026.02.01"
 
 
 __all__ = ["OkxGateway"]

vnpy_okx/okx_gateway.py

@@ -10,6 +10,7 @@ from types import TracebackType
 from collections.abc import Callable
 from time import sleep
 from decimal import Decimal
+from typing import cast
 
 from vnpy.event import EventEngine, Event, EVENT_TIMER
 from vnpy.trader.constant import (
@@ -116,7 +117,7 @@ class OkxGateway(BaseGateway):
         "Margin Currency": ""
     }
 
-    exchanges: Exchange = [Exchange.GLOBAL]
+    exchanges: list[Exchange] = [Exchange.GLOBAL]
 
     def __init__(self, event_engine: EventEngine, gateway_name: str) -> None:
         """
@@ -339,7 +340,7 @@ class OkxGateway(BaseGateway):
         self.orders[order.orderid] = order
         super().on_order(order)
 
-    def get_order(self, orderid: str) -> OrderData:
+    def get_order(self, orderid: str) -> OrderData | None:
         """
         Get previously saved order by order id.
 
@@ -401,7 +402,7 @@ class OkxGateway(BaseGateway):
         Returns:
             OrderData: VeighNa order object
         """
-        contract: ContractData = self.get_contract_by_name(data["instId"])
+        contract: ContractData = cast(ContractData, self.get_contract_by_name(data["instId"]))
 
         order_id: str = data["clOrdId"]
         if order_id:
@@ -439,7 +440,7 @@ class OkxGateway(BaseGateway):
         Returns:
             OrderData: VeighNa order object
         """
-        contract: ContractData = self.get_contract_by_name(data["sprdId"])
+        contract: ContractData = cast(ContractData, self.get_contract_by_name(data["sprdId"]))
 
         order_id: str = data["clOrdId"]
         if order_id:
@@ -512,6 +513,13 @@ class RestApi(RestClient):
         Returns:
             Request: Modified request with authentication parameters
         """
+        # Add simulated trading header for demo server (applies to all requests)
+        if self.simulated:
+            if not request.headers:
+                request.headers = {"x-simulated-trading": "1"}
+            else:
+                request.headers["x-simulated-trading"] = "1"
+
         # Public API does not need to sign
         if "public" in request.path:
             return request
@@ -739,7 +747,11 @@ class RestApi(RestClient):
                     base, quote, _ = name.split("-")
                     symbol = base + quote + "_SWAP_OKX"
                 case Product.FUTURES:
-                    base, quote, expiry = name.split("-")
+                    symbol_parts: list[str] = name.split("-")
+                    if len(symbol_parts) < 3:
+                        continue
+
+                    base, quote, expiry = symbol_parts
                     symbol = base + quote + "_" + expiry + "_OKX"
 
             if d["tickSz"]:
@@ -764,6 +776,7 @@ class RestApi(RestClient):
                 net_position=net_position,
                 gateway_name=self.gateway_name,
             )
+            contract.extra = d
 
             self.gateway.on_contract(contract)
 
@@ -795,7 +808,7 @@ class RestApi(RestClient):
             leg_symbols: list[str] = []
             for leg in d["legs"]:
                 leg_name: str = leg["instId"]
-                leg_contract: ContractData = self.gateway.get_contract_by_name(leg_name)
+                leg_contract: ContractData = cast(ContractData, self.gateway.get_contract_by_name(leg_name))
                 leg_symbols.append(leg_contract.symbol)
 
             contract: ContractData = ContractData(
@@ -857,6 +870,8 @@ class RestApi(RestClient):
             request: Original request object
         """
         detail: str = self.exception_detail(exc, value, tb, request)
+        # Escape curly braces to prevent loguru from interpreting them as format placeholders
+        detail = detail.replace("{", "{{").replace("}", "}}")
 
         msg: str = f"Exception catched by REST API: {detail}"
         self.gateway.write_log(msg)
@@ -877,6 +892,11 @@ class RestApi(RestClient):
             self.gateway.write_log(f"Query kline history failed, symbol not found: {req.symbol}")
             return []
 
+        # Validate interval is not None
+        if not req.interval:
+            self.gateway.write_log(f"Query kline history failed, interval not found: {req.symbol}")
+            return []
+
         # Initialize buffer for storing bars
         buf: dict[datetime, BarData] = {}
         limit: str = "100"
@@ -913,7 +933,7 @@ class RestApi(RestClient):
                 break
             else:
                 data: dict = resp.json()
-                bar_data: list = data.get("data", None)
+                bar_data: list | None = data.get("data", None)
 
                 if not bar_data:
                     msg: str = data.get("msg", "No data returned.")
@@ -1395,7 +1415,7 @@ class PrivateApi(WebsocketApi):
             # Process trade data for filled or partially filled orders
             # Round trade volume number to meet minimum volume precision
             trade_volume: float = float(d["fillSz"])
-            contract: ContractData = self.gateway.get_contract_by_symbol(order.symbol)
+            contract: ContractData | None = self.gateway.get_contract_by_symbol(order.symbol)
             if contract:
                 trade_volume = round_to(trade_volume, contract.min_volume)
 
@@ -1451,7 +1471,7 @@ class PrivateApi(WebsocketApi):
         data: list = packet["data"]
         for d in data:
             name: str = d["instId"]
-            contract: ContractData = self.gateway.get_contract_by_name(name)
+            contract: ContractData = cast(ContractData, self.gateway.get_contract_by_name(name))
 
             pos: float = float(d["pos"])
             price: float = get_float_value(d, "avgPx")
@@ -1483,9 +1503,11 @@ class PrivateApi(WebsocketApi):
         # Wrong parameters
         if packet["code"] != "0":
             if not data:
-                order: OrderData = self.reqid_order_map[packet["id"]]
-                order.status = Status.REJECTED
-                self.gateway.on_order(order)
+                order: OrderData | None = self.reqid_order_map.get(packet["id"], None)
+                if order:
+                    order.status = Status.REJECTED
+                    self.gateway.on_order(order)
+
                 return
 
         # Failed to process
@@ -1616,7 +1638,7 @@ class PrivateApi(WebsocketApi):
 
         # Prepare order parameters for OKX API
         arg: dict = {
-            "instId": contract.name,
+            "instIdCode": contract.extra["instIdCode"],     # type: ignore
             "clOrdId": orderid,
             "side": DIRECTION_VT2OKX[req.direction],
             "ordType": ORDERTYPE_VT2OKX[req.type],
@@ -1625,9 +1647,15 @@ class PrivateApi(WebsocketApi):
             "tdMode": "cross"       # Only support cross margin mode
         }
 
+        # Add extra field for portfolio margin
         if self.margin_currency:
             arg["ccy"] = self.margin_currency
 
+        # Add extra field for spot
+        if "SPOT" in req.symbol:
+            quote_ccy_list: list[str] = contract.extra["tradeQuoteCcyList"]     # type: ignore
+            arg["tradeQuoteCcy"] = quote_ccy_list[0]
+
         # Create websocket request with unique request ID
         self.reqid += 1
         packet: dict = {
@@ -1661,7 +1689,7 @@ class PrivateApi(WebsocketApi):
             return
 
         # Initialize cancel parameters
-        arg: dict = {"instId": contract.name}
+        arg: dict = {"instIdCode": contract.extra["instIdCode"]}     # type: ignore
 
         # Determine the type of order ID to use for cancellation
         # OKX supports both client order ID and exchange order ID for cancellation

{vnpy_okx-2025.12.28.dist-info → vnpy_okx-2026.2.1.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: vnpy_okx
-Version: 2025.12.28
+Version: 2026.2.1
 Summary: OKX trading gateway for VeighNa.
 Project-URL: Homepage, https://www.github.com/veighna-global
 Project-URL: Source, https://www.github.com/veighna-global
@@ -33,7 +33,7 @@ Description-Content-Type: text/markdown
 </p>
 
 <p align="center">
-    <img src ="https://img.shields.io/badge/version-2025.12.28-blueviolet.svg"/>
+    <img src ="https://img.shields.io/badge/version-uv-blueviolet.svg"/>
     <img src ="https://img.shields.io/badge/platform-windows|linux|macos-yellow.svg"/>
     <img src ="https://img.shields.io/badge/python-3.10|3.11|3.12|3.13-blue.svg" />
     <img src ="https://img.shields.io/github/license/veighna-global/vnpy_okx.svg?color=orange"/>

vnpy_okx-2026.2.1.dist-info/RECORD

@@ -0,0 +1,7 @@
+vnpy_okx/__init__.py,sha256=0d6DqmtG5dW0pHCM4ZFYu5SnQCgfN0oX_dtGSLxyrzg,1248
+vnpy_okx/okx_gateway.py,sha256=9-DyVRsUCSL5iLut6NYqve_W-frI9bOsiuGoHzW4aW8,73708
+vnpy_okx/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+vnpy_okx-2026.2.1.dist-info/METADATA,sha256=1icb0W6UmQQRUf191UsPMenh5c5PdcNW0PHcLwgAZY8,2831
+vnpy_okx-2026.2.1.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
+vnpy_okx-2026.2.1.dist-info/licenses/LICENSE,sha256=vKkW-EmD7w-5lDDjg15L8feZ1nkQeNpEHfyO2v9tprs,1099
+vnpy_okx-2026.2.1.dist-info/RECORD,,

vnpy_okx-2025.12.28.dist-info/RECORD

@@ -1,7 +0,0 @@
-vnpy_okx/__init__.py,sha256=q5WNRYb_KdEzXSfonARFuNujBAS4jL-z77Lu2pm8beY,1248
-vnpy_okx/okx_gateway.py,sha256=eqKESbdBr5Av4TJ7HhQgp6jJjmZjgtgP6ivICOIeozI,72352
-vnpy_okx/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-vnpy_okx-2025.12.28.dist-info/METADATA,sha256=gGPXJ52UM7FZ8oW0EkNWu3NU4k4rJZsS8iSOHay2sJk,2841
-vnpy_okx-2025.12.28.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
-vnpy_okx-2025.12.28.dist-info/licenses/LICENSE,sha256=vKkW-EmD7w-5lDDjg15L8feZ1nkQeNpEHfyO2v9tprs,1099
-vnpy_okx-2025.12.28.dist-info/RECORD,,