diff --git a/contracts/predictify-hybrid/src/markets.rs b/contracts/predictify-hybrid/src/markets.rs
index ab5db911..e2a3d1c8 100644
--- a/contracts/predictify-hybrid/src/markets.rs
+++ b/contracts/predictify-hybrid/src/markets.rs
@@ -725,6 +725,11 @@ pub struct MarketReadCache<'a> {
 }
 
 impl<'a> MarketReadCache<'a> {
+    /// Creates a market read cache bound to the current contract environment.
+    ///
+    /// The cache uses instance storage for read-only market lookups, so callers
+    /// should create it per operation and continue to treat persistent storage as
+    /// the source of truth for mutations.
     pub fn new(env: &'a Env) -> Self {
         Self { env }
     }