aiosteampy 0.7.21

Trade and interact with steam market, webapi, guard

AIOSTEAMPY

Previously this library was a soft fork of bukson/steampy with intend to provide asynchronous methods and proxies support. But now it standalone project.

Created for steam trading purposes mostly. Inspired by DoctorMcKay/node-steamcommunity

---

0.8

The 0.7 line is now entering its sunset phase 🌇. main branch will receive only minor fixes as part of the final maintenance.

All major development is now happening in the 0.8.0 branch. Expect significant changes that may break existing code, you can preview the work-in-progress here.

Once the full migration to 0.8.0 is complete, the branch will be merged back into main.

[!IMPORTANT] The project is unstable and there might be some breaking changes in the future unless stable (first major) version is released.

Take a look at TODO

See full documentation here 📖

Installation

pip install aiosteampy

pipenv install aiosteampy

poetry add aiosteampy

uv add aiosteampy

Project does have extras as socks proxies and currencies converter.

Either of extras can be installed separately with the appropriate installation target: aiosteampy[socks] or aiosteampy[converter].

Or all extras at once aiosteampy[all].

An UV example

uv add aiosteampy[socks]

[!TIP] aiohttp docs recommends installing speedups (aiodns, cchardet, ...)

AIOSTEAMPY use aiohttp underneath to do asynchronous requests to steam servers, with modern async/await syntax.

Key features ✨

• Stateless: low-middle layer API wrapper of some steam services and methods like market, tradeoffers, confirmations, steamguard, etc.
• Declarative: there is models or TypedDicts for every data.
• Typed: High-end support with extensive typing, tested on VSCode and PyCharm.
• Simple: Fit most important related to steam trading process methods.
• Web proxy support.

What can I do with this

• Operate with steam trade offers.
• Sell, buy items on market. Place, cancel orders.
• Login trough steam to 3rd party sites.
• Fetch data from market.
• Manipulate many accounts with proxies for each session.
• Get and load cookies to stay logged in (session persistence).
• Convert market prices into different currencies.

What I can't do

• Chat.
• Get apps, packages.
• All, that need connection to CM.
• Interact with game servers (inspect CS2 (ex. CSGO) items, ...).
• Social interaction(groups, clans).
• Handle entities (listings, items, tradeoffers) lifecycle for easy if you need to store it.

Tests 🧪

[!WARNING] Test cases and test code as a whole are deprecated and will not work until they are updated (a lot of work). I'll leave the code and this heading here as a reminder 🫣

TODO 📃

Hard to say roadmap. Can be a little changed or updated later, get ready.

Path to first stable release. Non-exhaustive list, scheduled tasks can be done earlier than the version mentioned, but not otherwise.

v0.6.0

• Listings, items, offers pagination/iteration
• Get single item from inventory as browser does
• Change client username method

v0.7.0

• Remove storage methods. Caching entities must be user responsibility
• Rename fetch_... methods to get_... to remove annoying methods symantic mess
• Web browser mechanism to fetch trade offers from Steam, avoiding Steam Web Api
• Edit profile privacy settings

v0.8.0

• Context managers as helpers to login/logout, load/dump or get/put cookies
• Fetch/paginate over market search pages

v0.9.0

• Steam user model with minimal attrs, retrieving/fetching
• Refresh access_token mechanism

v1.0.0

• Tests with Steam API mocking. Target coverage ~70%. Key points (listings, inventory items, trade offers) testing suits is mandatory
• Maturity, battle-testing in more different cases by more participants/users

Contribution 💛

There is no rules or requirements to contribute. Feedbacks, suggests, other are welcome. I will be very grateful for helping me get the things right.

Credits

• bukson/steampy
• aiohttp-socks
• croniter
• DoctorMcKay/node-steamcommunity
• Identifying Steam items
• Revadike/InternalSteamWebAPI
• Gobot1234/steam.py
• Steam Market id's storage repo
• steamapi.xpaw.me
• Steam Exchange Rate Tracker
• ethanfurman/aenum