TornAPIWrapper 2.2.0__tar.gz → 2.3.1__tar.gz

{tornapiwrapper-2.2.0/src/TornAPIWrapper.egg-info → tornapiwrapper-2.3.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: TornAPIWrapper
-Version: 2.2.0
+Version: 2.3.1
 Summary: A Python wrapper for the Torn City API, providing access to Torn City data.
 Author: cxdzc
 License: The MIT License (MIT)
@@ -53,7 +53,7 @@ Dynamic: license-file
 <a href="https://pypi.org/project/TornAPIWrapper/"><img src=https://img.shields.io/pypi/v/tornapiwrapper?cacheSeconds=300></a>
 <a href="https://pypi.org/project/TornAPIWrapper/"><img src=https://img.shields.io/pypi/pyversions/tornapiwrapper?cacheSeconds=300></a>
 <a href="https://pypi.org/project/TornAPIWrapper/"><img src=https://img.shields.io/pepy/dt/tornapiwrapper?color=blue&cacheSeconds=300></a>
-<a href="https://www.torn.com/api.html#:~:text=Patch%20Notes"><img src=https://img.shields.io/badge/patch-23.02.2026-c4c4c4?cacheSeconds=300></a>
+<a href="https://www.torn.com/api.html#:~:text=Patch%20Notes"><img src=https://img.shields.io/badge/patch-10.03.2026-c4c4c4?cacheSeconds=300></a>
 <a rel="license" href="https://github.com/cxdzc/TornAPIWrapper/blob/main/LICENSE"><img alt="MIT License" src="https://img.shields.io/badge/license-MIT-ab1436"/></a>
 </div>
 

{tornapiwrapper-2.2.0 → tornapiwrapper-2.3.1}/README.md

@@ -6,7 +6,7 @@
 <a href="https://pypi.org/project/TornAPIWrapper/"><img src=https://img.shields.io/pypi/v/tornapiwrapper?cacheSeconds=300></a>
 <a href="https://pypi.org/project/TornAPIWrapper/"><img src=https://img.shields.io/pypi/pyversions/tornapiwrapper?cacheSeconds=300></a>
 <a href="https://pypi.org/project/TornAPIWrapper/"><img src=https://img.shields.io/pepy/dt/tornapiwrapper?color=blue&cacheSeconds=300></a>
-<a href="https://www.torn.com/api.html#:~:text=Patch%20Notes"><img src=https://img.shields.io/badge/patch-23.02.2026-c4c4c4?cacheSeconds=300></a>
+<a href="https://www.torn.com/api.html#:~:text=Patch%20Notes"><img src=https://img.shields.io/badge/patch-10.03.2026-c4c4c4?cacheSeconds=300></a>
 <a rel="license" href="https://github.com/cxdzc/TornAPIWrapper/blob/main/LICENSE"><img alt="MIT License" src="https://img.shields.io/badge/license-MIT-ab1436"/></a>
 </div>
 
@@ -43,4 +43,4 @@ View [CONTRIBUTING.md](https://github.com/cxdzc/TornAPIWrapper?tab=contributing-
 > [!NOTE]
 > This is not legal advice.
 
-The content and software in this repository are licensed under the [MIT License](https://github.com/cxdzc/TornAPIWrapper?tab=MIT-1-ov-file), a simple and permissive license that allows use, modification, and distribution as long as the license notice is preserved.
+The content and software in this repository are licensed under the [MIT License](https://github.com/cxdzc/TornAPIWrapper?tab=MIT-1-ov-file), a simple and permissive license that allows use, modification, and distribution as long as the license notice is preserved.

{tornapiwrapper-2.2.0 → tornapiwrapper-2.3.1}/src/TornAPIWrapper/__init__.py

@@ -26,8 +26,8 @@ __author__ = "cxdzc"
 __copyright__ = "Copyright 2023-Present cxdzc"
 __license__ = "MIT"
 __title__ = "TornAPIWrapper"
-__version__ = "2.2.0"
-__patch__ = "23.02.2026"
+__version__ = "2.3.1"
+__patch__ = "10.03.2026"
 
 from .errors import (
     WrapperError,

{tornapiwrapper-2.2.0 → tornapiwrapper-2.3.1}/src/TornAPIWrapper/endpoints/faction.py

@@ -170,7 +170,7 @@ class Faction:
         """
         return self.api.request("/faction/contributors", build_params(self.get_contributors, locals()))
 
-    def get_crimes(self, crimes_category: FacCrimesCatOptions = "all", crimes_filter: FacCrimesFiltersOptions = None, offset: int = 0, sort: SortOptions = "DESC", to: int = None, from_: int = None, timestamp: int = None, comment: str = None) -> dict:
+    def get_crimes(self, crimes_category: FacCrimesCatOptions = "all", crimes_filter: FacCrimesFiltersOptions = None, limit: int = 20, offset: int = 0, sort: SortOptions = "DESC", to: int = None, from_: int = None, timestamp: int = None, comment: str = None) -> dict:
         """
         Get your faction's organized crimes.
         Requires faction API access permissions.
@@ -183,6 +183,7 @@ class Faction:
          - For category 'planning', the ordering field is 'ready_at'.
         :param crimes_category: Category of organized crimes returned. Category 'available' includes both 'recruiting' & 'planning', and category 'completed' includes both 'successful' & 'failure'.
         :param crimes_filter: It's possible to set this parameter to specify a field used for the sort, from & to query parameters. If not specified, the field will default to the category sorting as described above.
+        :param limit: Number of results to return.
         :param offset: Number of rows to skip before returning results.
         :param sort: Sorted by the greatest timestamps.
         :param to: Timestamp that sets the upper limit for the data returned. Data returned will be up to and including this time.
@@ -335,7 +336,8 @@ class Faction:
         """
         Get faction reports.
         API key (Limited).
-        The default limit is set to 25. However, the limit can be set to 100 for the 'stats' category.
+        The limit is set to 25 when requesting any category other than 'stats'.
+        When requesting the 'stats' category, limit can be increased up to 100.
         :param report_category: Used to filter reports with a specific type.
         :param target_id: Get reports for a specific player by passing their player ID.
         :param limit: Number of results to return.

{tornapiwrapper-2.2.0 → tornapiwrapper-2.3.1}/src/TornAPIWrapper/endpoints/user.py

@@ -28,7 +28,8 @@ from typing import TYPE_CHECKING
 
 from ..params.builders import build_params
 from ..type_hints import SortOptions, RaceCatOptions, UserListCatOptions, AttackFiltersOptions, \
-    UserPropertiesFiltersOptions, ReportCatOptions, UserPrsnlStatsCatOptions, UserPrsnlStatsStatOptions
+    UserPropertiesFiltersOptions, ReportCatOptions, UserPrsnlStatsCatOptions, UserPrsnlStatsStatOptions, \
+    UserTradeCatOptions
 
 if TYPE_CHECKING:
     from ..client import TornAPIWrapper
@@ -667,6 +668,8 @@ class User:
         """
         Get your reports.
         API key (Limited).
+        The limit is set to 25 when requesting any category other than 'stats'.
+        When requesting the 'stats' category, limit can be increased up to 100.
         :param report_category: Used to filter reports with a specific type.
         :param target_id: Get reports for a specific player by passing their player ID.
         :param limit: Number of results to return.
@@ -735,6 +738,36 @@ class User:
         """
         return self.api.request("/user/stocks", build_params(self.get_stocks, locals()))
 
+    def get_trades(self, trade_category: UserTradeCatOptions = "ongoing", limit: int = 100, sort: SortOptions = "DESC", to: int = None, from_: int = None, timestamp: int = None, comment: str = None) -> dict:
+        """
+        Get your trades.
+        API key (Limited).
+        When requesting 'ongoing' trades (default), limit/offset/sort are not being used.
+        :param trade_category: Category of trades returned.
+        :param limit: Number of results to return.
+        :param sort: Sorted by the greatest timestamps.
+        :param to: Timestamp that sets the upper limit for the data returned. Data returned will be up to and including this time.
+        :param from_: Timestamp that sets the lower limit for the data returned. Data returned will be after this time.
+        :param timestamp: Timestamp to bypass cache.
+        :param comment: Comment for your tool/service/bot/website to be visible in the logs.
+        :return: API response data.
+        :rtype: dict
+        """
+        return self.api.request("/user/trades", build_params(self.get_trades, locals()))
+
+    def get_trade(self, trade_id: int, timestamp: int = None, comment: str = None) -> dict:
+        """
+        Get your detailed trade.
+        API key (Limited).
+        Only possible to get trades you participated in.
+        :param trade_id: Trade id.
+        :param timestamp: Timestamp to bypass cache.
+        :param comment: Comment for your tool/service/bot/website to be visible in the logs.
+        :return: API response data.
+        :rtype: dict
+        """
+        return self.api.request("/user/trade", build_params(self.get_trade, locals()))
+
     def get_travel(self, timestamp: int = None, comment: str = None) -> dict:
         """
         Get your travel information.

{tornapiwrapper-2.2.0 → tornapiwrapper-2.3.1}/src/TornAPIWrapper/endpoints_async/faction.py

@@ -170,7 +170,7 @@ class Faction:
         """
         return await self.api.request("/faction/contributors", build_params(self.get_contributors, locals()))
 
-    async def get_crimes(self, crimes_category: FacCrimesCatOptions = "all", crimes_filter: FacCrimesFiltersOptions = None, offset: int = 0, sort: SortOptions = "DESC", to: int = None, from_: int = None, timestamp: int = None, comment: str = None) -> dict:
+    async def get_crimes(self, crimes_category: FacCrimesCatOptions = "all", crimes_filter: FacCrimesFiltersOptions = None, limit: int = 20, offset: int = 0, sort: SortOptions = "DESC", to: int = None, from_: int = None, timestamp: int = None, comment: str = None) -> dict:
         """
         Get your faction's organized crimes.
         Requires faction API access permissions.
@@ -183,6 +183,7 @@ class Faction:
          - For category 'planning', the ordering field is 'ready_at'.
         :param crimes_category: Category of organized crimes returned. Category 'available' includes both 'recruiting' & 'planning', and category 'completed' includes both 'successful' & 'failure'.
         :param crimes_filter: It's possible to set this parameter to specify a field used for the sort, from & to query parameters. If not specified, the field will default to the category sorting as described above.
+        :param limit: Number of results to return.
         :param offset: Number of rows to skip before returning results.
         :param sort: Sorted by the greatest timestamps.
         :param to: Timestamp that sets the upper limit for the data returned. Data returned will be up to and including this time.
@@ -335,7 +336,8 @@ class Faction:
         """
         Get faction reports.
         API key (Limited).
-        The default limit is set to 25. However, the limit can be set to 100 for the 'stats' category.
+        The limit is set to 25 when requesting any category other than 'stats'.
+        When requesting the 'stats' category, limit can be increased up to 100.
         :param report_category: Used to filter reports with a specific type.
         :param target_id: Get reports for a specific player by passing their player ID.
         :param limit: Number of results to return.

{tornapiwrapper-2.2.0 → tornapiwrapper-2.3.1}/src/TornAPIWrapper/endpoints_async/user.py

@@ -28,7 +28,8 @@ from typing import TYPE_CHECKING
 
 from ..params.builders import build_params
 from ..type_hints import SortOptions, RaceCatOptions, UserListCatOptions, AttackFiltersOptions, \
-    UserPropertiesFiltersOptions, ReportCatOptions, UserPrsnlStatsCatOptions, UserPrsnlStatsStatOptions
+    UserPropertiesFiltersOptions, ReportCatOptions, UserPrsnlStatsCatOptions, UserPrsnlStatsStatOptions, \
+    UserTradeCatOptions
 
 if TYPE_CHECKING:
     from ..client_async import TornAPIWrapperAsync
@@ -667,6 +668,8 @@ class User:
         """
         Get your reports.
         API key (Limited).
+        The limit is set to 25 when requesting any category other than 'stats'.
+        When requesting the 'stats' category, limit can be increased up to 100.
         :param report_category: Used to filter reports with a specific type.
         :param target_id: Get reports for a specific player by passing their player ID.
         :param limit: Number of results to return.
@@ -735,6 +738,36 @@ class User:
         """
         return await self.api.request("/user/stocks", build_params(self.get_stocks, locals()))
 
+    async def get_trades(self, trade_category: UserTradeCatOptions = "ongoing", limit: int = 100, sort: SortOptions = "DESC", to: int = None, from_: int = None, timestamp: int = None, comment: str = None) -> dict:
+        """
+        Get your trades.
+        API key (Limited).
+        When requesting 'ongoing' trades (default), limit/offset/sort are not being used.
+        :param trade_category: Category of trades returned.
+        :param limit: Number of results to return.
+        :param sort: Sorted by the greatest timestamps.
+        :param to: Timestamp that sets the upper limit for the data returned. Data returned will be up to and including this time.
+        :param from_: Timestamp that sets the lower limit for the data returned. Data returned will be after this time.
+        :param timestamp: Timestamp to bypass cache.
+        :param comment: Comment for your tool/service/bot/website to be visible in the logs.
+        :return: API response data.
+        :rtype: dict
+        """
+        return await self.api.request("/user/trades", build_params(self.get_trades, locals()))
+
+    async def get_trade(self, trade_id: int, timestamp: int = None, comment: str = None) -> dict:
+        """
+        Get your detailed trade.
+        API key (Limited).
+        Only possible to get trades you participated in.
+        :param trade_id: Trade id.
+        :param timestamp: Timestamp to bypass cache.
+        :param comment: Comment for your tool/service/bot/website to be visible in the logs.
+        :return: API response data.
+        :rtype: dict
+        """
+        return await self.api.request("/user/trade", build_params(self.get_trade, locals()))
+
     async def get_travel(self, timestamp: int = None, comment: str = None) -> dict:
         """
         Get your travel information.

{tornapiwrapper-2.2.0 → tornapiwrapper-2.3.1}/src/TornAPIWrapper/params/map.py

@@ -15,6 +15,7 @@ param_id = {
     "property_id",
     "property_type_id",
     "stock_id",
+    "trade_id",
     "race_id",
     "raid_war_id",
     "ranked_war_id",
@@ -38,6 +39,7 @@ param_cat = {
     "race_category",
     "report_category",
     "stat_category",
+    "trade_category",
     "warfare_category",
 }
 param_group = {

{tornapiwrapper-2.2.0 → tornapiwrapper-2.3.1}/src/TornAPIWrapper/type_hints.py

@@ -29,6 +29,7 @@ RaceCatOptions = Literal["official", "custom"]
 AttackFiltersOptions = Literal["incoming", "outgoing", "idFilter"]
 ReportCatOptions = Literal["mostwanted", "money", "stats", "references", "friendorfoe", "companyfinancials", "truelevel", "stockanalysis", "anonymousbounties", "investment"]
 
+UserTradeCatOptions = Literal["finished", "ongoing"]
 UserListCatOptions = Literal["Friends", "Enemies", "Targets"]
 UserPropertiesFiltersOptions = Literal["ownedByUser", "ownedBySpouse"]
 UserPrsnlStatsCatOptions = Literal["all", "popular", "attacking", "battle_stats", "jobs", "trading", "jail", "hospital", "finishing_hits", "communication", "crimes", "bounties", "investments", "items", "travel", "drugs", "missions", "racing", "networth", "other", "itemmarketcustomers", "itemmarketsales", "itemmarketrevenue", "itemmarketfees"]

{tornapiwrapper-2.2.0 → tornapiwrapper-2.3.1/src/TornAPIWrapper.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: TornAPIWrapper
-Version: 2.2.0
+Version: 2.3.1
 Summary: A Python wrapper for the Torn City API, providing access to Torn City data.
 Author: cxdzc
 License: The MIT License (MIT)
@@ -53,7 +53,7 @@ Dynamic: license-file
 <a href="https://pypi.org/project/TornAPIWrapper/"><img src=https://img.shields.io/pypi/v/tornapiwrapper?cacheSeconds=300></a>
 <a href="https://pypi.org/project/TornAPIWrapper/"><img src=https://img.shields.io/pypi/pyversions/tornapiwrapper?cacheSeconds=300></a>
 <a href="https://pypi.org/project/TornAPIWrapper/"><img src=https://img.shields.io/pepy/dt/tornapiwrapper?color=blue&cacheSeconds=300></a>
-<a href="https://www.torn.com/api.html#:~:text=Patch%20Notes"><img src=https://img.shields.io/badge/patch-23.02.2026-c4c4c4?cacheSeconds=300></a>
+<a href="https://www.torn.com/api.html#:~:text=Patch%20Notes"><img src=https://img.shields.io/badge/patch-10.03.2026-c4c4c4?cacheSeconds=300></a>
 <a rel="license" href="https://github.com/cxdzc/TornAPIWrapper/blob/main/LICENSE"><img alt="MIT License" src="https://img.shields.io/badge/license-MIT-ab1436"/></a>
 </div>