diff --git a/.env.example b/.env.example
index a457460..16dd7a1 100644
--- a/.env.example
+++ b/.env.example
@@ -25,7 +25,9 @@ TRADE_HTTP_PORT=8002
 GETPRICE_HTTP_PORT=8003
 
 # API Server Port (exposed on host machine for REST API)
-# Container always uses 8080 internally
+# Container ALWAYS uses port 8080 internally (hardcoded in entrypoint-api.sh)
+# This variable ONLY controls the host port mapping (host:8080 -> container:8080)
+# Change this if port 8080 is already in use on your host machine
 # Used for Windmill integration and external API access
 API_PORT=8080