A comprehensive Home Assistant integration for Torn City, providing real-time access to your player stats, finances, stocks, travel status, cooldowns, and more.
- Open HACS → Integrations → Custom repositories
- Add
https://github.com/xlemmingx/ha-tornas "Integration" - Search for "Torn City" and install
- Restart Home Assistant
- Download from releases page
- Copy to
config/custom_components/torn/ - Restart Home Assistant
- Settings → Devices & Services → Add Integration
- Search "Torn City"
- Enter your Torn City API key (Full Access recommended)
- Optional: Enable "Throttle API Usage" to reduce API calls if needed
- Submit
- Name, level, status, battle stats (strength, defense, speed, dexterity)
- Energy, Nerve, Happy, Life, Chain with timers
- Chain timeout timer
- Drug, Medical, Booster cooldowns
- Wallet, Vault, Banks, Company & Faction funds
- City Bank investments with profit tracking
- Daily networth
- Current prices, market cap, owned shares
- Stock benefit blocks tracking
- Ready-to-claim benefits
- Destination, method, arrival/departure times
- Recent activity log
- Skills (dynamic sensors)
- Company stats
All sensors prefixed with sensor.torn_ and binary_sensor.torn_.
The integration uses intelligent caching to minimize API calls:
- High frequency (5s cache): profile, bars, money, travel, log
- Medium frequency (60s cache): cooldowns, stats, company, stocks
- Low frequency (600s cache): skills, refills
Total usage: ~64 API calls/minute (64% of the 100/minute limit)
Enable "Throttle API Usage" during setup to reduce this by 10x if you're sharing an API key or approaching limits.
MIT License - see LICENSE file for details.
This integration is not affiliated with Torn City Ltd.