Merge branch 'feat_future_depth' into 'master'

Feat future depth

See merge request server/openapi/openapi-python-sdk!251

Author: tigersk

CHANGELOG.md

@@ -1,3 +1,9 @@
+## 3.4.5 (2025-08-22)
+### New
+- `QuoteClient.get_future_depth` 获取期货深度行情
+- QuoteClient 的 `get_depth_quote`, `get_trade_ticks`, `get_timeline`, `get_timeline_history`, `get_bars` 支持 `trade_session` 指定查询夜盘数据
+- MCP Server beta version pre-release
+
 ## 3.4.4 (2025-07-31)
 ### New
 选股器支持分页 cursor_id 参数

requirements.txt

@@ -7,7 +7,7 @@ pyasn1
 rsa
 stomp.py
 getmac
-cryptography
+cryptography~=44.0.3
 backoff
 jproperties
 protobuf

setup.py

@@ -21,7 +21,7 @@
     long_description_content_type='text/markdown',
     packages=find_packages(exclude=["tests"]),
     author='TigerBrokers',
-    author_email='openapi@tigerbrokers.com',
+    author_email='openapi@itiger.com',
     license='Apache License v2',
     package_data={'': ['*.*']},
     url='https://github.com/tigerbrokers/openapi-python-sdk',
@@ -37,5 +37,7 @@
         'Programming Language :: Python :: 3.9',
         'Programming Language :: Python :: 3.10',
         'Programming Language :: Python :: 3.11',
+        'Programming Language :: Python :: 3.12',
+        'Programming Language :: Python :: 3.13',
     ],
 )

tests/test_quote_client.py

@@ -24,7 +24,7 @@
 class TestTradeClient(unittest.TestCase):
 
     def setUp(self):
-        self.is_mock = False
+        self.is_mock = True
         current_dir = os.path.dirname(__file__)
         self.client_config = TigerOpenClientConfig(
             props_path=os.path.join(current_dir, ".config/prod_20150899/"))
@@ -625,16 +625,6 @@ def test_cancel_order(self):
             self.assertIsNotNone(mock_result_with_account)
             self.assertEqual(mock_result_with_account, 40132638459956224)
 
-            # Verify the correct parameters were passed to the API request
-            self.assertEqual(web_utils.do_request.call_count, 3)
-
-            # For the following assertions, we verify that the CancelOrderParams was correctly populated
-            # in each of the test cases by examining the payload sent to do_request
-            last_call_args = web_utils.do_request.call_args_list[2][0][
-                1]  # Get payload from third call
-            self.assertIn('"account":"123123"', last_call_args)
-            self.assertIn('"id":40132638459956224', last_call_args)
-
         else:
             result = self.client.cancel_order(id=40132638459956224)
             logger.debug(f"Cancel Order Result: {result}")

tests/test_trade_client.py

@@ -4,4 +4,4 @@
 
 @author: gaoan
 """
-__VERSION__ = '3.4.4'
+__VERSION__ = '3.4.5'

tigeropen/__init__.py

@@ -20,3 +20,11 @@
 COMMON_PARAM_KEYS = {P_TIGER_ID, P_METHOD, P_CHARSET, P_SIGN_TYPE, P_SIGN, P_TIMESTAMP, P_VERSION, P_NOTIFY_URL,
                      P_DEVICE_ID}
 P_BIZ_CONTENT = "biz_content"
+TIGER_ID = "tiger_id"
+ACCOUNT = "account"
+SECRET_KEY = "secret_key"
+LICENSE = "license"
+PRIVATE_KEY = "private_key"
+TOKEN = "token"
+ENV = "env"
+DATA = "data"

tigeropen/common/consts/params.py

@@ -100,6 +100,7 @@
 FUTURE_REAL_TIME_QUOTE = "future_real_time_quote"
 FUTURE_TICK = "future_tick"
 FUTURE_TRADING_DATE = "future_trading_date"
+FUTURE_DEPTH = "future_depth"
 
 # 基金行情
 FUND_ALL_SYMBOLS = "fund_all_symbols"

tigeropen/common/consts/service_types.py

@@ -0,0 +1,2 @@
+include README.md
+recursive-include tigermcp *

tigeropen/examples/ai/mcp_server/MANIFEST.in

@@ -0,0 +1,60 @@
+# Tiger MCP Server
+
+Tiger MCP Server 
+
+## Quickstart
+
+### Install 
+```shell
+mkdir demo
+cd demo
+
+# Create virtual environment and activate it
+python -m venv .venv
+source .venv/bin/activate
+# or windows
+# .venv\Scripts\activate
+
+pip install tigermcp
+```
+
+### Configure TigerOpen API credentials environment variables
+
+Method 1: Specify the configuration file
+```bash
+export TIGEROPEN_PROPS_PATH="path/to/your/tiger_openapi_config.properties"
+```
+
+Method 2: Specify tiger_id/private_key/account directly
+```bash
+export TIGEROPEN_TIGER_ID="your Tiger ID"
+export TIGEROPEN_PRIVATE_KEY="your private key"
+export TIGEROPEN_ACCOUNT="your trading account"
+```
+
+Set `TIGERMCP_READONLY` to true if you want to run the server in read-only mode (no trading actions allowed).
+
+
+
+### Run
+```shell
+tigermcp 
+```
+
+### Run with Cursor/Claude/Trae
+
+
+```json
+{
+  "mcpServers": {
+    "tigermcp": {
+      "command": "/path/to/tigermcp",
+      "env": {
+        "TIGEROPEN_PROPS_PATH": "/path/to/your/tiger_openapi_config.properties"
+      }
+    }
+  }
+}
+```
+
+