TornAPIWrapper 2.3.0__tar.gz → 2.4.0__tar.gz

{tornapiwrapper-2.3.0/src/TornAPIWrapper.egg-info → tornapiwrapper-2.4.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: TornAPIWrapper
-Version: 2.3.0
+Version: 2.4.0
 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-10.03.2026-c4c4c4?cacheSeconds=300></a>
+<a href="https://www.torn.com/api.html#:~:text=Patch%20Notes"><img src=https://img.shields.io/badge/patch-15.04.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.3.0 → tornapiwrapper-2.4.0}/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-10.03.2026-c4c4c4?cacheSeconds=300></a>
+<a href="https://www.torn.com/api.html#:~:text=Patch%20Notes"><img src=https://img.shields.io/badge/patch-15.04.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.3.0 → tornapiwrapper-2.4.0}/src/TornAPIWrapper/__init__.py

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

{tornapiwrapper-2.3.0 → tornapiwrapper-2.4.0}/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.3.0 → tornapiwrapper-2.4.0}/src/TornAPIWrapper/endpoints/user.py

@@ -29,7 +29,7 @@ from typing import TYPE_CHECKING
 from ..params.builders import build_params
 from ..type_hints import SortOptions, RaceCatOptions, UserListCatOptions, AttackFiltersOptions, \
     UserPropertiesFiltersOptions, ReportCatOptions, UserPrsnlStatsCatOptions, UserPrsnlStatsStatOptions, \
-    UserTradeCatOptions
+    UserTradeCatOptions, UserInventoryCatOptions
 
 if TYPE_CHECKING:
     from ..client import TornAPIWrapper
@@ -365,6 +365,21 @@ class User:
         """
         return self.api.request("/user/icons", build_params(self.get_icons, locals()))
 
+    def get_inventory(self, inventory_category: UserInventoryCatOptions, limit: int = 20, offset: int = 0, timestamp: int = None, comment: str = None) -> dict:
+        """
+        Get your inventory.
+        API key (Limited).
+        Cached selection (1 hour per category).
+        :param inventory_category: Items category.
+        :param offset: Number of rows to skip before returning results.
+        :param limit: Number of results to return.
+        :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/inventory", build_params(self.get_inventory, locals()))
+
     def get_itemmarket(self, offset: int = 0, timestamp: int = None, comment: str = None) -> dict:
         """
         Get your item market listings for a specific item.
@@ -668,6 +683,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.

{tornapiwrapper-2.3.0 → tornapiwrapper-2.4.0}/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.3.0 → tornapiwrapper-2.4.0}/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, UserInventoryCatOptions
 
 if TYPE_CHECKING:
     from ..client_async import TornAPIWrapperAsync
@@ -364,6 +365,21 @@ class User:
         """
         return await self.api.request("/user/icons", build_params(self.get_icons, locals()))
 
+    async def get_inventory(self, inventory_category: UserInventoryCatOptions, limit: int = 20, offset: int = 0, timestamp: int = None, comment: str = None) -> dict:
+        """
+        Get your inventory.
+        API key (Limited).
+        Cached selection (1 hour per category).
+        :param inventory_category: Items category.
+        :param offset: Number of rows to skip before returning results.
+        :param limit: Number of results to return.
+        :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/inventory", build_params(self.get_inventory, locals()))
+
     async def get_itemmarket(self, offset: int = 0, timestamp: int = None, comment: str = None) -> dict:
         """
         Get your item market listings for a specific item.
@@ -667,6 +683,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 +753,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.3.0 → tornapiwrapper-2.4.0}/src/TornAPIWrapper/params/map.py

@@ -14,15 +14,15 @@ param_id = {
     "log_category_id_torn",
     "property_id",
     "property_type_id",
-    "stock_id",
-    "trade_id",
     "race_id",
     "raid_war_id",
     "ranked_war_id",
+    "stock_id",
     "team_id",
     "territory_war_id",
     "thread_id",
     "track_id",
+    "trade_id",
     "user_id",
 }
 param_cat = {
@@ -31,6 +31,7 @@ param_cat = {
     "car_category",
     "contributors_category",
     "crimes_category",
+    "inventory_category",
     "item_category",
     "leaderboard_category",
     "list_category",

{tornapiwrapper-2.3.0 → tornapiwrapper-2.4.0}/src/TornAPIWrapper/type_hints.py

@@ -32,6 +32,7 @@ ReportCatOptions = Literal["mostwanted", "money", "stats", "references", "friend
 UserTradeCatOptions = Literal["finished", "ongoing"]
 UserListCatOptions = Literal["Friends", "Enemies", "Targets"]
 UserPropertiesFiltersOptions = Literal["ownedByUser", "ownedBySpouse"]
+UserInventoryCatOptions = Literal["Collectible", "Clothing", "Other", "Tool", "Melee", "Defensive", "Material", "Car", "Primary", "Secondary", "Book", "Special", "Supply Pack", "Temporary", "Enhancer", "Artifact", "Flower", "Booster", "Medical", "Candy", "Jewelry", "Alcohol", "Plushie", "Drug", "Energy Drink"]
 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"]
 UserPrsnlStatsStatOptions = Literal["attackswon", "attackslost", "attacksdraw", "attacksassisted", "defendswon", "defendslost", "defendsstalemated", "elo", "yourunaway", "theyrunaway", "unarmoredwon", "bestkillstreak", "attackhits", "attackmisses", "attackdamage", "bestdamage", "onehitkills", "attackcriticalhits", "roundsfired", "specialammoused", "hollowammoused", "tracerammoused", "piercingammoused", "incendiaryammoused", "attacksstealthed", "retals", "moneymugged", "largestmug", "itemslooted", "highestbeaten", "respectforfaction", "rankedwarhits", "raidhits", "territoryjoins", "territoryclears", "territorytime", "jobpointsused", "trainsreceived", "marketitemsbought", "auctionswon", "auctionsells", "itemssent", "trades", "cityitemsbought", "pointsbought", "pointssold", "bazaarcustomers", "bazaarsales", "bazaarprofit", "jailed", "peoplebusted", "failedbusts", "peoplebought", "peopleboughtspent", "hospital", "medicalitemsused", "bloodwithdrawn", "reviveskill", "revives", "revivesreceived", "heavyhits", "machinehits", "riflehits", "smghits", "shotgunhits", "pistolhits", "temphits", "piercinghits", "slashinghits", "clubbinghits", "mechanicalhits", "h2hhits", "mailssent", "friendmailssent", "factionmailssent", "companymailssent", "spousemailssent", "classifiedadsplaced", "personalsplaced", "criminaloffensesold", "sellillegalgoods", "theftold", "autotheftcrime", "drugdealscrime", "computercrime", "fraudold", "murdercrime", "othercrime", "organizedcrimes", "bountiesplaced", "totalbountyspent", "bountiescollected", "totalbountyreward", "bountiesreceived", "receivedbountyvalue", "cityfinds", "dumpfinds", "itemsdumped", "booksread", "boostersused", "consumablesused", "candyused", "alcoholused", "energydrinkused", "statenhancersused", "eastereggsfound", "eastereggsused", "virusescoded", "traveltimes", "timespenttraveling", "itemsboughtabroad", "attackswonabroad", "defendslostabroad", "argtravel", "mextravel", "uaetravel", "hawtravel", "japtravel", "uktravel", "satravel", "switravel", "chitravel", "cantravel", "caytravel", "drugsused", "overdosed", "rehabs", "rehabcost", "cantaken", "exttaken", "kettaken", "lsdtaken", "opitaken", "pcptaken", "shrtaken", "spetaken", "victaken", "xantaken", "missionscompleted", "contractscompleted", "dukecontractscompleted", "missioncreditsearned", "racingskill", "racingpointsearned", "racesentered", "raceswon", "networth", "timeplayed", "activestreak", "bestactivestreak", "awards", "refills", "nerverefills", "tokenrefills", "meritsbought", "daysbeendonator", "criminaloffenses", "vandalism", "theft", "counterfeiting", "fraud", "illicitservices", "cybercrime", "extortion", "illegalproduction", "currentkillstreak", "strength", "defense", "speed", "dexterity", "totalstats", "manuallabor", "intelligence", "endurance", "totalworkingstats", "moneyinvested", "investedprofit", "investamount", "banktimeleft", "stockprofits", "stocklosses", "stockfees", "stocknetprofits", "stockpayouts", "networthwallet", "networthvault", "networthbank", "networthcayman", "networthpoints", "networthitems", "networthdisplaycase", "networthbazaar", "networthitemmarket", "networthproperties", "networthstockmarket", "networthauctionhouse", "networthbookie", "networthcompany", "networthenlistedcars", "networthpiggybank", "networthpending", "networthloan", "networthunpaidfees", "huntingskill", "searchforcashskill", "bootleggingskill", "graffitiskill", "shopliftingskill", "pickpocketingskill", "cardskimmingskill", "burglaryskill", "hustlingskill", "disposalskill", "crackingskill", "forgeryskill", "scammingskill", "arsonskill"]
 

{tornapiwrapper-2.3.0 → tornapiwrapper-2.4.0/src/TornAPIWrapper.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: TornAPIWrapper
-Version: 2.3.0
+Version: 2.4.0
 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-10.03.2026-c4c4c4?cacheSeconds=300></a>
+<a href="https://www.torn.com/api.html#:~:text=Patch%20Notes"><img src=https://img.shields.io/badge/patch-15.04.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>