updates

Author: dev-dist

public/images/data-streams/24-5-price-jumps-example.png

@@ -39,7 +39,7 @@ Chainlink Data Streams that use the RWA Advanced (v11) schema adhere to the stru
 | `linkFee`               | `uint192` | Cost to verify report onchain (LINK)                                                                                                                                                                                                                                        |
 | `expiresAt`             | `uint32`  | Expiration date of the report (seconds)                                                                                                                                                                                                                                     |
 | `mid`                   | `int192`  | Liquidity-weighted mid price                                                                                                                                                                                                                                                |
-| `lastSeenTimestampNs`   | `uint64`  | Staleness indicator based on mid price (nanoseconds)                                                                                                                                                                                                                        |
+| `lastSeenTimestampNs`   | `uint64`  | Timestamp for **mid price only** (nanoseconds). See [Notes](#notes) below.                                                                                                                                                                                                  |
 | `bid`                   | `int192`  | Median bid price                                                                                                                                                                                                                                                            |
 | `bidVolume`             | `int192`  | Volume at bid price                                                                                                                                                                                                                                                         |
 | `ask`                   | `int192`  | Median ask price                                                                                                                                                                                                                                                            |
@@ -64,7 +64,8 @@ Users should implement appropriate safeguards based on market status, such as pa
 
 ### Notes
 
+- **IMPORTANT**: `lastSeenTimestampNs` is the timestamp for the `mid` price field **only**. Do not assume this timestamp applies to `bid`, `ask`, `bidVolume`, `askVolume`, or `lastTradedPrice`. These fields may have different update times depending on data provider behavior and caching mechanisms.
+- `lastSeenTimestampNs` helps applications detect stale data for the mid price, especially important during market transitions and holidays.
 - Future streams using this format may adopt different report schemas as needed.
-- `lastSeenTimestampNs` helps applications detect stale data, especially important during market transitions and holidays.
 - Market status cannot detect public holidays. See [Market Hours](/data-streams/market-hours) for major holiday periods.
 - Data availability and sourcing vary by session. Liquidity is typically highest during regular hours and lower during extended and overnight sessions.