Report Schema: Crypto Standard (v2)

Cryptocurrency streams adhere to the report schema outlined below.

Time-Weighted Average Price (TWAP)

The v2 schema is used by TWAP streams. The price field carries the time-weighted average price for the stream's configured window, not a spot or median price. Each TWAP stream is scoped to one asset and one window length (for example, 30 seconds or 60 seconds). The window length is part of the stream's name and metadata. See How Report Timestamps Work for how timestamps apply to TWAP streams.

Schema Fields

FieldTypeDescription
feedIdbytes32Unique identifier for the Data Streams feed
validFromTimestampuint32Earliest timestamp when the price is valid (seconds) — How report timestamps work
observationsTimestampuint32Latest timestamp when the price is valid (seconds) — How report timestamps work
nativeFeeuint192Legacy onchain verification fee field
linkFeeuint192Legacy onchain verification fee field; not used for subscription billing
expiresAtuint32Expiration date of the report (seconds)
priceint192Time-weighted average price (TWAP) for the stream's window

Note: Future Cryptocurrency streams may use different report schemas.

Get the latest Chainlink content straight to your inbox.