diff --git a/src/content/data-streams/reference/report-schema-v10.mdx b/src/content/data-streams/reference/report-schema-v10.mdx index 63c14bbc56b..ac6fdbe46b4 100644 --- a/src/content/data-streams/reference/report-schema-v10.mdx +++ b/src/content/data-streams/reference/report-schema-v10.mdx @@ -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.
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
(set to `0` if none is scheduled) | -| `activationDateTime` | `uint32` | When the next corporate action takes effect
(set to `0` if none is scheduled) | +| `activationDateTime` | `uint32` | When the next corporate action takes effect
(set to `0` if none is scheduled) (seconds) | | `tokenizedPrice` | `int192` | 24/7 tokenized equity price as traded on supported exchanges
(In development; currently returns `0`). | **Notes:** diff --git a/src/content/data-streams/reference/report-schema-v3-dex.mdx b/src/content/data-streams/reference/report-schema-v3-dex.mdx index fa8e57bfe39..187419e848d 100644 --- a/src/content/data-streams/reference/report-schema-v3-dex.mdx +++ b/src/content/data-streams/reference/report-schema-v3-dex.mdx @@ -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`. | diff --git a/src/content/data-streams/reference/report-schema-v3.mdx b/src/content/data-streams/reference/report-schema-v3.mdx index 830fc20aa75..94716f4f855 100644 --- a/src/content/data-streams/reference/report-schema-v3.mdx +++ b/src/content/data-streams/reference/report-schema-v3.mdx @@ -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. diff --git a/src/content/data-streams/reference/report-schema-v4.mdx b/src/content/data-streams/reference/report-schema-v4.mdx index e2640197455..67e98b14090 100644 --- a/src/content/data-streams/reference/report-schema-v4.mdx +++ b/src/content/data-streams/reference/report-schema-v4.mdx @@ -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`). | diff --git a/src/content/data-streams/reference/report-schema-v8.mdx b/src/content/data-streams/reference/report-schema-v8.mdx index e90a498b80b..9015d8a73a7 100644 --- a/src/content/data-streams/reference/report-schema-v8.mdx +++ b/src/content/data-streams/reference/report-schema-v8.mdx @@ -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`) | diff --git a/src/content/data-streams/reference/report-schema-v9.mdx b/src/content/data-streams/reference/report-schema-v9.mdx index e81744c71e6..34ba9aa4a91 100644 --- a/src/content/data-streams/reference/report-schema-v9.mdx +++ b/src/content/data-streams/reference/report-schema-v9.mdx @@ -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
Possible values: `0` (normal state), `1` (paused state)
[More details](#ripcord-status) |