Skip to content

Data Streams: Update report schemas to specify timestamp format #2942

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 1 commit into from
Sep 2, 2025
Merged

Data Streams: Update report schemas to specify timestamp format #2942

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
10 changes: 5 additions & 5 deletions src/content/data-streams/reference/report-schema-v10.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -49,17 +49,17 @@ Chainlink Backed xStock Data Streams adhere to the report schema outlined below.
| Field | Type | Description |
| ----------------------- | --------- | -------------------------------------------------------------------------------------------------------------------- |
| `feedId` | `bytes32` | Unique identifier for the Data Streams feed |
| `validFromTimestamp` | `uint32` | Earliest timestamp when the price is valid |
| `observationsTimestamp` | `uint32` | Latest timestamp when the price is valid |
| `validFromTimestamp` | `uint32` | Earliest timestamp when the price is valid (seconds) |
| `observationsTimestamp` | `uint32` | Latest timestamp when the price is valid (seconds) |
| `nativeFee` | `uint192` | Cost to verify report onchain (native token) |
| `linkFee` | `uint192` | Cost to verify report onchain (LINK) |
| `expiresAt` | `uint32` | Expiration date of the report |
| `lastUpdateTimestamp` | `uint64` | Timestamp of the last valid price update |
| `expiresAt` | `uint32` | Expiration date of the report (seconds) |
| `lastUpdateTimestamp` | `uint64` | Timestamp of the last valid price update (nanoseconds) |
| `price` | `int192` | Last traded price from the real-world equity market |
| `marketStatus` | `uint32` | Status of the real-world equity market. <br/> Possible values: `0` (Unknown), `1` (Closed), `2` (Open), `3` (Halted) |
| `currentMultiplier` | `int192` | Currently applied multiplier accounting for past corporate actions |
| `newMultiplier` | `int192` | Multiplier to be applied at the activationDateTime <br/> (set to `0` if none is scheduled) |
| `activationDateTime` | `uint32` | When the next corporate action takes effect <br/> (set to `0` if none is scheduled) |
| `activationDateTime` | `uint32` | When the next corporate action takes effect <br/> (set to `0` if none is scheduled) (seconds) |
| `tokenizedPrice` | `int192` | 24/7 tokenized equity price as traded on supported exchanges <br/> (In development; currently returns `0`). |

**Notes:**
Expand Down
6 changes: 3 additions & 3 deletions src/content/data-streams/reference/report-schema-v3-dex.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -43,11 +43,11 @@ DEX State Price streams adhere to the report schema outlined below.
| Field | Type | Description |
| ----------------------- | --------- | ---------------------------------------------------------------------------------------------------------- |
| `feedID` | `bytes32` | Unique identifier for the data stream |
| `validFromTimestamp` | `uint32` | Start timestamp of price validity period |
| `observationsTimestamp` | `uint32` | End timestamp of price validity period |
| `validFromTimestamp` | `uint32` | Start timestamp of price validity period (seconds) |
| `observationsTimestamp` | `uint32` | End timestamp of price validity period (seconds) |
| `nativeFee` | `uint192` | Verification cost in native blockchain tokens |
| `linkFee` | `uint192` | Verification cost in LINK tokens |
| `expiresAt` | `uint32` | Timestamp when this report expires |
| `expiresAt` | `uint32` | Timestamp when this report expires (seconds) |
| `price` | `int192` | DON consensus median [DEX state price](/data-streams/concepts/dex-state-price-streams) (18 decimal places) |
| `bid` | `int192` | N/A, equals `price`. |
| `ask` | `int192` | N/A, equals `price`. |
Expand Down
22 changes: 11 additions & 11 deletions src/content/data-streams/reference/report-schema-v3.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -47,16 +47,16 @@ Cryptocurrency streams adhere to the report schema outlined below.

## Schema Fields

| Field | Type | Description |
| ----------------------- | --------- | ------------------------------------------------- |
| `feedID` | `bytes32` | Unique identifier for the data stream |
| `validFromTimestamp` | `uint32` | Start timestamp of price validity period |
| `observationsTimestamp` | `uint32` | End timestamp of price validity period |
| `nativeFee` | `uint192` | Verification cost in native blockchain tokens |
| `linkFee` | `uint192` | Verification cost in LINK tokens |
| `expiresAt` | `uint32` | Timestamp when this report expires |
| `price` | `int192` | DON consensus median price |
| `bid` | `int192` | Simulated buy impact price at X% liquidity depth |
| `ask` | `int192` | Simulated sell impact price at X% liquidity depth |
| Field | Type | Description |
| ----------------------- | --------- | -------------------------------------------------- |
| `feedID` | `bytes32` | Unique identifier for the data stream |
| `validFromTimestamp` | `uint32` | Start timestamp of price validity period (seconds) |
| `observationsTimestamp` | `uint32` | End timestamp of price validity period (seconds) |
| `nativeFee` | `uint192` | Verification cost in native blockchain tokens |
| `linkFee` | `uint192` | Verification cost in LINK tokens |
| `expiresAt` | `uint32` | Timestamp when this report expires (seconds) |
| `price` | `int192` | DON consensus median price |
| `bid` | `int192` | Simulated buy impact price at X% liquidity depth |
| `ask` | `int192` | Simulated sell impact price at X% liquidity depth |

**Note**: Future Cryptocurrency streams may use different report schemas.
6 changes: 3 additions & 3 deletions src/content/data-streams/reference/report-schema-v4.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -58,11 +58,11 @@ Real World Asset (RWA) streams adhere to the report schema outlined below.
| Field | Type | Description |
| ----------------------- | --------- | ---------------------------------------------------------------------------------------------------------------------------- |
| `feedID` | `bytes32` | The unique identifier for the stream |
| `validFromTimestamp` | `uint32` | The earliest timestamp during which the price is valid |
| `observationsTimestamp` | `uint32` | The latest timestamp during which the price is valid |
| `validFromTimestamp` | `uint32` | The earliest timestamp during which the price is valid (seconds) |
| `observationsTimestamp` | `uint32` | The latest timestamp during which the price is valid (seconds) |
| `nativeFee` | `uint192` | The cost to verify this report onchain when paying with the blockchain's native token |
| `linkFee` | `uint192` | The cost to verify this report onchain when paying with LINK |
| `expiresAt` | `uint32` | The expiration date of this report |
| `expiresAt` | `uint32` | The expiration date of this report (seconds) |
| `price` | `int192` | The DON's consensus median price |
| `marketStatus` | `uint32` | The DON's consensus on whether the market is currently open. Possible values: `0` (`Unknown`), `1` (`Closed`), `2` (`Open`). |

Expand Down
8 changes: 4 additions & 4 deletions src/content/data-streams/reference/report-schema-v8.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -49,11 +49,11 @@ RWA streams adhere to the report schema outlined below.
| Value | Type | Description |
| ----------------------- | --------- | ----------------------------------------------------------------------------------------------------------- |
| `feedID` | `bytes32` | Unique identifier for the Data Streams feed |
| `validFromTimestamp` | `uint32` | Earliest timestamp when the price is valid |
| `observationsTimestamp` | `uint32` | Latest timestamp when the price is valid |
| `validFromTimestamp` | `uint32` | Earliest timestamp when the price is valid (seconds) |
| `observationsTimestamp` | `uint32` | Latest timestamp when the price is valid (seconds) |
| `nativeFee` | `uint192` | Cost to verify report onchain (native token) |
| `linkFee` | `uint192` | Cost to verify report onchain (LINK) |
| `expiresAt` | `uint32` | Expiration date of the report |
| `lastUpdateTimestamp` | `uint64` | Timestamp of the last valid price update |
| `expiresAt` | `uint32` | Expiration date of the report (seconds) |
| `lastUpdateTimestamp` | `uint64` | Timestamp of the last valid price update (nanoseconds) |
| `midPrice` | `int192` | DON's consensus median price |
| `marketStatus` | `uint32` | [Market status](/data-streams/market-hours). Possible values: `0` (`Unknown`), `1` (`Closed`), `2` (`Open`) |
8 changes: 4 additions & 4 deletions src/content/data-streams/reference/report-schema-v9.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -49,13 +49,13 @@ Chainlink NAV Data Streams streams adhere to the report schema outlined below.
| Value | Type | Description |
| ----------------------- | --------- | --------------------------------------------------------------------------------------------------------------------------------------------- |
| `feedID` | `bytes32` | Unique identifier for the Data Streams feed |
| `validFromTimestamp` | `uint32` | Earliest timestamp when the price is valid |
| `observationsTimestamp` | `uint32` | Latest timestamp when the price is valid |
| `validFromTimestamp` | `uint32` | Earliest timestamp when the price is valid (seconds) |
| `observationsTimestamp` | `uint32` | Latest timestamp when the price is valid (seconds) |
| `nativeFee` | `uint192` | Cost to verify report onchain (native token) |
| `linkFee` | `uint192` | Cost to verify report onchain (LINK) |
| `expiresAt` | `uint32` | Expiration date of the report |
| `expiresAt` | `uint32` | Expiration date of the report (seconds) |
| `navPerShare` | `int192` | DON consensus NAV Per Share value as reported by the Fund Manager |
| `navDate` | `uint64` | Timestamp for the date the publication of NAV Report |
| `navDate` | `uint64` | Timestamp for the date the publication of NAV Report (nanoseconds) |
| `aum` | `int192` | DON consensus Total USD value of Assets Under Management |
| `ripcord` | `uint32` | Whether the provider paused NAV reporting <br/> Possible values: `0` (normal state), `1` (paused state) <br/> [More details](#ripcord-status) |

Expand Down
Loading