deprecate last_id in futures trading history

revilwang · revilwang · commit be3c452e4828 · 2019-12-17T11:28:41.000+08:00
diff --git a/README.md b/README.md
@@ -3,8 +3,8 @@ APIv4 provides spot, margin and futures trading operations. There are public API
 
 This Python package is automatically generated by the [OpenAPI Generator](https://openapi-generator.tech) project:
 
-- API version: 4.8.2
-- Package version: 4.8.2
+- API version: 4.9.0
+- Package version: 4.9.0
 - Build package: org.openapitools.codegen.languages.PythonClientCodegen
 For more information, please visit [https://www.gate.io/page/contacts](https://www.gate.io/page/contacts)
 
diff --git a/docs/FuturesApi.md b/docs/FuturesApi.md
@@ -468,7 +468,7 @@ settle = 'btc' # str | Settle currency (default to 'btc')
 contract = 'BTC_USD' # str | Futures contract, return related data only if specified (optional)
 order = 12345 # int | Futures order ID, return related data only if specified (optional)
 limit = 100 # int | Maximum number of record returned in one list (optional) (default to 100)
-last_id = '12345' # str | Specify list staring point using the last record of `id` in previous list-query results (optional)
+last_id = '12345' # str | Specify list staring point using the `id` of last record in previous list-query results (optional)
 
 try:
     # List personal trading history
@@ -486,7 +486,7 @@ Name | Type | Description  | Notes
  **contract** | **str**| Futures contract, return related data only if specified | [optional] 
  **order** | **int**| Futures order ID, return related data only if specified | [optional] 
  **limit** | **int**| Maximum number of record returned in one list | [optional] [default to 100]
- **last_id** | **str**| Specify list staring point using the last record of &#x60;id&#x60; in previous list-query results | [optional] 
+ **last_id** | **str**| Specify list staring point using the &#x60;id&#x60; of last record in previous list-query results | [optional] 
 
 ### Return type
 
@@ -986,7 +986,7 @@ settle = 'btc' # str | Settle currency (default to 'btc')
 contract = 'BTC_USD' # str | Futures contract
 status = 'open' # str | List orders based on status
 limit = 100 # int | Maximum number of record returned in one list (optional) (default to 100)
-last_id = '12345' # str | Specify list staring point using the last record of `id` in previous list-query results (optional)
+last_id = '12345' # str | Specify list staring point using the `id` of last record in previous list-query results (optional)
 
 try:
     # List futures orders
@@ -1004,7 +1004,7 @@ Name | Type | Description  | Notes
  **contract** | **str**| Futures contract | 
  **status** | **str**| List orders based on status | 
  **limit** | **int**| Maximum number of record returned in one list | [optional] [default to 100]
- **last_id** | **str**| Specify list staring point using the last record of &#x60;id&#x60; in previous list-query results | [optional] 
+ **last_id** | **str**| Specify list staring point using the &#x60;id&#x60; of last record in previous list-query results | [optional] 
 
 ### Return type
 
@@ -1069,7 +1069,7 @@ No authorization required
 [[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)
 
 # **list_futures_trades**
-> list[FuturesTrade] list_futures_trades(settle, contract, limit=limit, last_id=last_id)
+> list[FuturesTrade] list_futures_trades(settle, contract, limit=limit, last_id=last_id, _from=_from, to=to)
 
 Futures trading history
 
@@ -1085,11 +1085,13 @@ api_instance = gate_api.FuturesApi()
 settle = 'btc' # str | Settle currency (default to 'btc')
 contract = 'BTC_USD' # str | Futures contract
 limit = 100 # int | Maximum number of record returned in one list (optional) (default to 100)
-last_id = '12345' # str | Specify list staring point using the last record of `id` in previous list-query results (optional)
+last_id = '12345' # str | Specify list staring point using the id of last record in previous list-query results  This parameter is deprecated. Use `from` and `to` instead to limit time range (optional)
+_from = 1546905600 # float | Specify starting time in Unix seconds. If not specified, `to` and `limit` will be used to limit response items. If items between `from` and `to` are more than `limit`, only `limit` number will be returned.  (optional)
+to = 1546935600 # float | Specify end time in Unix seconds, default to current time (optional)
 
 try:
     # Futures trading history
-    api_response = api_instance.list_futures_trades(settle, contract, limit=limit, last_id=last_id)
+    api_response = api_instance.list_futures_trades(settle, contract, limit=limit, last_id=last_id, _from=_from, to=to)
     print(api_response)
 except ApiException as e:
     print("Exception when calling FuturesApi->list_futures_trades: %s\n" % e)
@@ -1102,7 +1104,9 @@ Name | Type | Description  | Notes
  **settle** | **str**| Settle currency | [default to &#39;btc&#39;]
  **contract** | **str**| Futures contract | 
  **limit** | **int**| Maximum number of record returned in one list | [optional] [default to 100]
- **last_id** | **str**| Specify list staring point using the last record of &#x60;id&#x60; in previous list-query results | [optional] 
+ **last_id** | **str**| Specify list staring point using the id of last record in previous list-query results  This parameter is deprecated. Use &#x60;from&#x60; and &#x60;to&#x60; instead to limit time range | [optional] 
+ **_from** | **float**| Specify starting time in Unix seconds. If not specified, &#x60;to&#x60; and &#x60;limit&#x60; will be used to limit response items. If items between &#x60;from&#x60; and &#x60;to&#x60; are more than &#x60;limit&#x60;, only &#x60;limit&#x60; number will be returned.  | [optional] 
+ **to** | **float**| Specify end time in Unix seconds, default to current time | [optional] 
 
 ### Return type
 
diff --git a/docs/SpotApi.md b/docs/SpotApi.md
@@ -685,7 +685,7 @@ from gate_api.rest import ApiException
 api_instance = gate_api.SpotApi()
 currency_pair = 'BTC_USDT' # str | Currency pair
 limit = 100 # int | Maximum number of record returned in one list (optional) (default to 100)
-last_id = '12345' # str | Specify list staring point using the last record of `id` in previous list-query results (optional)
+last_id = '12345' # str | Specify list staring point using the `id` of last record in previous list-query results (optional)
 
 try:
     # Retrieve market trades
@@ -701,7 +701,7 @@ Name | Type | Description  | Notes
 ------------- | ------------- | ------------- | -------------
  **currency_pair** | **str**| Currency pair | 
  **limit** | **int**| Maximum number of record returned in one list | [optional] [default to 100]
- **last_id** | **str**| Specify list staring point using the last record of &#x60;id&#x60; in previous list-query results | [optional] 
+ **last_id** | **str**| Specify list staring point using the &#x60;id&#x60; of last record in previous list-query results | [optional] 
 
 ### Return type
 
diff --git a/gate_api/__init__.py b/gate_api/__init__.py
@@ -14,7 +14,7 @@
 
 from __future__ import absolute_import
 
-__version__ = "4.8.2"
+__version__ = "4.9.0"
 
 # import apis into sdk package
 from gate_api.api.futures_api import FuturesApi
diff --git a/gate_api/api/futures_api.py b/gate_api/api/futures_api.py
@@ -879,7 +879,7 @@ def get_my_trades(self, settle, **kwargs):  # noqa: E501
         :param str contract: Futures contract, return related data only if specified
         :param int order: Futures order ID, return related data only if specified
         :param int limit: Maximum number of record returned in one list
-        :param str last_id: Specify list staring point using the last record of `id` in previous list-query results
+        :param str last_id: Specify list staring point using the `id` of last record in previous list-query results
         :return: list[MyFuturesTrade]
                  If the method is called asynchronously,
                  returns the request thread.
@@ -904,7 +904,7 @@ def get_my_trades_with_http_info(self, settle, **kwargs):  # noqa: E501
         :param str contract: Futures contract, return related data only if specified
         :param int order: Futures order ID, return related data only if specified
         :param int limit: Maximum number of record returned in one list
-        :param str last_id: Specify list staring point using the last record of `id` in previous list-query results
+        :param str last_id: Specify list staring point using the `id` of last record in previous list-query results
         :return: list[MyFuturesTrade]
                  If the method is called asynchronously,
                  returns the request thread.
@@ -1950,7 +1950,7 @@ def list_futures_orders(self, settle, contract, status, **kwargs):  # noqa: E501
         :param str contract: Futures contract (required)
         :param str status: List orders based on status (required)
         :param int limit: Maximum number of record returned in one list
-        :param str last_id: Specify list staring point using the last record of `id` in previous list-query results
+        :param str last_id: Specify list staring point using the `id` of last record in previous list-query results
         :return: list[FuturesOrder]
                  If the method is called asynchronously,
                  returns the request thread.
@@ -1976,7 +1976,7 @@ def list_futures_orders_with_http_info(self, settle, contract, status, **kwargs)
         :param str contract: Futures contract (required)
         :param str status: List orders based on status (required)
         :param int limit: Maximum number of record returned in one list
-        :param str last_id: Specify list staring point using the last record of `id` in previous list-query results
+        :param str last_id: Specify list staring point using the `id` of last record in previous list-query results
         :return: list[FuturesOrder]
                  If the method is called asynchronously,
                  returns the request thread.
@@ -2170,7 +2170,9 @@ def list_futures_trades(self, settle, contract, **kwargs):  # noqa: E501
         :param str settle: Settle currency (required)
         :param str contract: Futures contract (required)
         :param int limit: Maximum number of record returned in one list
-        :param str last_id: Specify list staring point using the last record of `id` in previous list-query results
+        :param str last_id: Specify list staring point using the id of last record in previous list-query results  This parameter is deprecated. Use `from` and `to` instead to limit time range
+        :param float _from: Specify starting time in Unix seconds. If not specified, `to` and `limit` will be used to limit response items. If items between `from` and `to` are more than `limit`, only `limit` number will be returned. 
+        :param float to: Specify end time in Unix seconds, default to current time
         :return: list[FuturesTrade]
                  If the method is called asynchronously,
                  returns the request thread.
@@ -2194,15 +2196,17 @@ def list_futures_trades_with_http_info(self, settle, contract, **kwargs):  # noq
         :param str settle: Settle currency (required)
         :param str contract: Futures contract (required)
         :param int limit: Maximum number of record returned in one list
-        :param str last_id: Specify list staring point using the last record of `id` in previous list-query results
+        :param str last_id: Specify list staring point using the id of last record in previous list-query results  This parameter is deprecated. Use `from` and `to` instead to limit time range
+        :param float _from: Specify starting time in Unix seconds. If not specified, `to` and `limit` will be used to limit response items. If items between `from` and `to` are more than `limit`, only `limit` number will be returned. 
+        :param float to: Specify end time in Unix seconds, default to current time
         :return: list[FuturesTrade]
                  If the method is called asynchronously,
                  returns the request thread.
         """
 
         local_var_params = locals()
 
-        all_params = ['settle', 'contract', 'limit', 'last_id']  # noqa: E501
+        all_params = ['settle', 'contract', 'limit', 'last_id', '_from', 'to']  # noqa: E501
         all_params.append('async_req')
         all_params.append('_return_http_data_only')
         all_params.append('_preload_content')
@@ -2242,6 +2246,10 @@ def list_futures_trades_with_http_info(self, settle, contract, **kwargs):  # noq
             query_params.append(('limit', local_var_params['limit']))  # noqa: E501
         if 'last_id' in local_var_params:
             query_params.append(('last_id', local_var_params['last_id']))  # noqa: E501
+        if '_from' in local_var_params:
+            query_params.append(('from', local_var_params['_from']))  # noqa: E501
+        if 'to' in local_var_params:
+            query_params.append(('to', local_var_params['to']))  # noqa: E501
 
         header_params = {}
 
diff --git a/gate_api/api/spot_api.py b/gate_api/api/spot_api.py
@@ -1353,7 +1353,7 @@ def list_trades(self, currency_pair, **kwargs):  # noqa: E501
         :param async_req bool
         :param str currency_pair: Currency pair (required)
         :param int limit: Maximum number of record returned in one list
-        :param str last_id: Specify list staring point using the last record of `id` in previous list-query results
+        :param str last_id: Specify list staring point using the `id` of last record in previous list-query results
         :return: list[Trade]
                  If the method is called asynchronously,
                  returns the request thread.
@@ -1376,7 +1376,7 @@ def list_trades_with_http_info(self, currency_pair, **kwargs):  # noqa: E501
         :param async_req bool
         :param str currency_pair: Currency pair (required)
         :param int limit: Maximum number of record returned in one list
-        :param str last_id: Specify list staring point using the last record of `id` in previous list-query results
+        :param str last_id: Specify list staring point using the `id` of last record in previous list-query results
         :return: list[Trade]
                  If the method is called asynchronously,
                  returns the request thread.
diff --git a/gate_api/api_client.py b/gate_api/api_client.py
@@ -75,7 +75,7 @@ def __init__(self, configuration=None, header_name=None, header_value=None,
             self.default_headers[header_name] = header_value
         self.cookie = cookie
         # Set default User-Agent.
-        self.user_agent = 'OpenAPI-Generator/4.8.2/python'
+        self.user_agent = 'OpenAPI-Generator/4.9.0/python'
 
     def __del__(self):
         if self._pool:
diff --git a/gate_api/configuration.py b/gate_api/configuration.py
@@ -248,6 +248,6 @@ def to_debug_report(self):
         return "Python SDK Debug Report:\n"\
                "OS: {env}\n"\
                "Python Version: {pyversion}\n"\
-               "Version of the API: 4.8.2\n"\
-               "SDK Package Version: 4.8.2".\
+               "Version of the API: 4.9.0\n"\
+               "SDK Package Version: 4.9.0".\
                format(env=sys.platform, pyversion=sys.version)
diff --git a/setup.py b/setup.py
@@ -13,7 +13,7 @@
 from setuptools import setup, find_packages  # noqa: H301
 
 NAME = "gate-api"
-VERSION = "4.8.2"
+VERSION = "4.9.0"
 # To install the library, run the following
 #
 # python setup.py install

Original file line number	Diff line number	Diff line change
`@@ -13,7 +13,7 @@`
`13`	`13`	`from setuptools import setup, find_packages # noqa: H301`
`14`	`14`
`15`	`15`	`NAME = "gate-api"`
`16`		`-VERSION = "4.8.2"`
	`16`	`+VERSION = "4.9.0"`
`17`	`17`	`# To install the library, run the following`
`18`	`18`	`#`
`19`	`19`	`# python setup.py install`