← Back to Index

Architecture · ops.tradeit.gg

Tradeit.gg Domain Model

---

The vocabulary of the system — products, users, items, inventory types, games, and how they relate. Use to orient in any repo.

Why

Many repos use the same domain concepts with assumed shared understanding. This is the glossary.

How to apply

When a repo uses terms like "sinv", "float", "StatTrak", "veryGoodBots" without explanation — this is the reference.

Products

Product	Domain	Description
tradeit.gg	Marketplace	CS2/TF2/Rust skin buy/sell/trade platform
lootbear.com	Rental	Item rental product (80M+ hours of user rentals)

Supported Games

• CS2 (Counter-Strike 2) — primary, largest catalog
• TF2 (Team Fortress 2)
• Rust

Users

• 3.5M+ registered users
• Auth via Steam (primary), FACEIT OAuth2, GitHub
• MySQL table: oauth2_users
• Auth services: tradeit-oauth2-server, tradeit-login-server
• Balance tracked in balance_transactions

Items

An "item" is a virtual skin. Key attributes:

• market_hash_name — Steam's canonical item identifier (used as primary key in pricing, OpenSearch)
• appid — Steam app ID (CS2 = 730, TF2 = 440, Rust = 252490)
• CS2-specific attributes:
• Condition: FN / MW / FT / WW / BS (Factory New → Battle-Scarred)
• Float value: 0.00–1.00, determines condition band + exact wear
• StatTrak: tracks kills, commands price premium
• Souvenir: tournament drop items, separate market
• Stickers: applied to weapon, high-value stickers affect price
• Paint index: identifies specific skin pattern variant

Inventory Types

Name	Redis prefix	Description
Site inventory	sinv:	All items the site/bots have available for trade
Container/bot inventory	cinv:	Per-bot item holdings
Bot container data	containers:*	Bot metadata and state

OpenSearch holds the full searchable item catalog. Alias swap pattern for zero-downtime refresh (10-min cycle — confirmed via production crontab; see Production Cron Schedule).

Bots

• ~541 Steam trade bots (live numBots value from configurations registry; legacy docs said ~400)
• Act as the counterparty in all trades
• Tiered by reliability: veryGoodBots > goodBots > badBots (size thresholds: <850 = very good, <900 = good)
• MySQL tables: bot_users (bot Steam account/user records — Steam identity, trade URL — READ by inventory-server) + bot_accounts (tradebot fleet internal credentials + config, managed by tradebot-creator)
• Managed by: tradeit-tradebot-server
• Provisioned by: tradeit-tradebot-creator

Balance Model

• Users hold a balance on the platform
• Credited when selling items (or via deposits)
• Debited on withdrawals / purchases
• All movements logged in balance_transactions
• $10M+ paid out to sellers historically

Organization

• Company: Zengaming (Delaware-incorporated, profitable)
• Raised: $4.5M (Gigi Levy, NFX, Foundation Capital, 500 Startups, Crown Resorts, Stan Chudnovsky)
• GitHub org: zengamingx
• CEO: Jimi
• CTO: Ehud Shahak
• Dev team: Rick, Kim, Neo, David (+ Ehud)

Related

• Business Rules & Named Constants
• Production Cron Schedule

---

ops.tradeit.gg — Internal Engineering Docs