Skip to content

Commit c9adb64

Browse files
dev-distdev-dist
committed
schema+hours update
1 parent 2628788 commit c9adb64

File tree

1 file changed

+32
-18
lines changed

1 file changed

+32
-18
lines changed

‎src/content/data-streams/reference/report-schema-v11.mdx‎

Lines changed: 32 additions & 18 deletions
Original file line numberDiff line numberDiff line change
@@ -30,26 +30,40 @@ Chainlink Data Streams that use the RWA Advanced (v11) schema adhere to the stru
3030

3131
## Schema Fields
3232

33-
| Field | Type | Description |
34-
| ----------------------- | --------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
35-
| `feedId` | `bytes32` | Unique identifier for the Data Streams feed |
36-
| `validFromTimestamp` | `uint32` | Earliest timestamp when the price is valid (seconds) |
37-
| `observationsTimestamp` | `uint32` | Latest timestamp when the price is valid (seconds) |
38-
| `nativeFee` | `uint192` | Cost to verify report onchain (native token) |
39-
| `linkFee` | `uint192` | Cost to verify report onchain (LINK) |
40-
| `expiresAt` | `uint32` | Expiration date of the report (seconds) |
41-
| `mid` | `int192` | DON Consensus mid-price |
42-
| `lastSeenTimestampNs` | `uint64` | Reflects the timestamp of the last update for the **mid price only** (nanoseconds). See [Notes](#notes) below. |
43-
| `bid` | `int192` | Median bid price |
44-
| `bidVolume` | `int192` | Volume at bid price. See [bid/ask volume note](#bidask-volume-note) below. |
45-
| `ask` | `int192` | Median ask price |
46-
| `askVolume` | `int192` | Volume at ask price. See [bid/ask volume note](#bidask-volume-note) below. |
47-
| `lastTradedPrice` | `int192` | Last traded price |
48-
| `marketStatus` | `uint32` | Status of the real-world equity market. <br/> Possible values: <br/> `0` (Unknown), <br/> `1` (Pre-market extended hours), <br/> `2` (Regular hours), <br/> `3` (Post-market hours), <br/> `4` (Overnight), <br/> `5` (Weekend) <br/> [More details](#market-status-values) |
33+
| Field | Type | Description |
34+
| ----------------------- | --------- | ---------------------------------------------------------------------------------------------------------------------------------------------------- |
35+
| `feedId` | `bytes32` | Unique identifier for the Data Streams feed |
36+
| `validFromTimestamp` | `uint32` | Earliest timestamp when the price is valid (seconds) |
37+
| `observationsTimestamp` | `uint32` | Latest timestamp when the price is valid (seconds) |
38+
| `nativeFee` | `uint192` | Cost to verify report onchain (native token) |
39+
| `linkFee` | `uint192` | Cost to verify report onchain (LINK) |
40+
| `expiresAt` | `uint32` | Expiration date of the report (seconds) |
41+
| `mid` | `int192` | DON Consensus mid-price |
42+
| `lastSeenTimestampNs` | `uint64` | Reflects the timestamp of the last update for the **mid price only** (nanoseconds). See [Notes](#notes) below. |
43+
| `bid` | `int192` | Median bid price |
44+
| `bidVolume` | `int192` | Volume at bid price. See [bid/ask volume note](#bidask-volume-note) below. |
45+
| `ask` | `int192` | Median ask price |
46+
| `askVolume` | `int192` | Volume at ask price. See [bid/ask volume note](#bidask-volume-note) below. |
47+
| `lastTradedPrice` | `int192` | Last traded price |
48+
| `marketStatus` | `uint32` | Status of the real-world asset market. Values depend on the stream's supported hours. See [Market Status Values](#market-status-values) for details. |
4949

5050
### Market Status Values
5151

52-
The `marketStatus` field reflects the current state of the equity market:
52+
The `marketStatus` field indicates the current state of the market. The possible values vary depending on the stream's supported trading hours:
53+
54+
#### Standard RWA Streams
55+
56+
For streams with standard market hours coverage. Unless a feed explicitly states extended hours support, it is assumed to follow this format:
57+
58+
| Value | Status | Description |
59+
| ----- | ----------- | ---------------------------------- |
60+
| `0` | **Unknown** | Market status cannot be determined |
61+
| `1` | **Closed** | Market is closed |
62+
| `2` | **Open** | Market is open |
63+
64+
#### 24/5 US Equities Streams
65+
66+
For streams with 24/5 extended hours coverage (e.g., US Equities):
5367

5468
| Value | Status | Hours (ET) | Description |
5569
| ----- | ----------------- | ------------------------------------- | ---------------------------------------------- |
@@ -60,7 +74,7 @@ The `marketStatus` field reflects the current state of the equity market:
6074
| `4` | **Overnight** | 8:00pm–4:00am Sun evening–Fri morning | Overnight session with limited liquidity |
6175
| `5` | **Weekend** | 8:00pm Fri–8:00pm Sun | Weekend period when primary markets are closed |
6276

63-
Users should implement appropriate safeguards based on market status, such as pausing trading, adjusting risk parameters, or implementing staleness checks during non-regular hours.
77+
Users should implement appropriate safeguards based on market status, such as pausing trading, adjusting risk parameters, or implementing staleness checks during non-regular hours or closed periods.
6478

6579
### Notes
6680

0 commit comments

Comments
 (0)