From 3c53b046f85df02c26f77ee77ed9a655450bb5f1 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Pawe=C5=82=20Orzech?= <pawel@pawelorzech.pl>
Date: Sun, 18 Jan 2026 00:52:58 +0000
Subject: [PATCH] docs: Add API data usage section to README.

---
 README.md | 15 +++++++++++++++
 1 file changed, 15 insertions(+)

diff --git a/README.md b/README.md
index 8cb3a3c..2fef0ae 100644
--- a/README.md
+++ b/README.md
@@ -63,6 +63,21 @@ A native macOS menu bar app for monitoring your **Torn** game status.
 - macOS 13.0 (Ventura) or later
 - Torn API Key with access to: basic, bars, cooldowns, travel, profile, events, messages, market
 
+## API Data Usage
+
+In compliance with the [Torn API Terms of Service](https://www.torn.com/api.html), the following table shows which API selections MacTorn uses and why:
+
+| Selection | Purpose |
+|-----------|---------|
+| `basic` | Player name, ID, basic info |
+| `bars` | Energy, Nerve, Happy, Life bars |
+| `cooldowns` | Drug, Medical, Booster cooldowns |
+| `travel` | Travel status and destination |
+| `profile` | Battle stats, faction info |
+| `events` | Recent events feed |
+| `messages` | Unread message count |
+| `market` | Item watchlist prices |
+
 ## Configuration
 
 ### Refresh Interval