Skip to content

docs(data-streams): add How Report Timestamps Work page - #4106

Open
j0sh-cl wants to merge 1 commit into
smartcontractkit:mainfrom
j0sh-cl:docs/data-streams-report-timestamps
Open

docs(data-streams): add How Report Timestamps Work page#4106
j0sh-cl wants to merge 1 commit into
smartcontractkit:mainfrom
j0sh-cl:docs/data-streams-report-timestamps

Conversation

@j0sh-cl

@j0sh-cl j0sh-cl commented Aug 26, 2026

Copy link
Copy Markdown
Contributor

Summary

Adds a new How Report Timestamps Work page at /data-streams/how-report-timestamps-work, under the Data Streams Concepts section.

The page explains:

  • Reports describe a span of time (validFromTimestampobservationsTimestamp), not a price at an instant, and spans are contiguous by construction.
  • What "current" means in real-time transmission, including the edge case where no report exists for a given second and the next report's window absorbs the gap.
  • How timestamps relate to TWAP streams: the TWAP span is anchored to observationsTimestamp and slides rather than aligning to round clock boundaries, plus the weighting formula and interpolation across wider-than-1-second windows.

Cross-linked from Architecture (whatsnext), Best Practices (new "Report Timestamps" section + whatsnext), and the REST API reference (note under "API endpoints").

Test plan

  • Preview the new page renders correctly in the docs site
  • Sidebar entry appears under Data Streams → Concepts
  • Internal links resolve (linkcheck-internal)

🤖 Generated with Claude Code

Adds a concepts page explaining that reports describe a span of time
(validFromTimestamp through observationsTimestamp) rather than an
instant, how gaps between reports are absorbed, and how timestamps
anchor TWAP stream calculations.

Cross-links it from Architecture, Best Practices, and the REST API
reference.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
@j0sh-cl
j0sh-cl requested review from a team as code owners August 26, 2026 10:35
@vercel

vercel Bot commented Aug 26, 2026

Copy link
Copy Markdown

@j0sh-cl is attempting to deploy a commit to the Chainlink Labs Team on Vercel.

A member of the Team first needs to authorize it.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant