Skip to content

Documentation clarification: WsTrade.time, trades snapshots, and candle finality #326

Description

@Hobbel1968

Hi — I am trying to consume the public WebSocket feeds causally and would appreciate provider-level clarification on three schema points that do not appear to be documented.

References:

1. WsTrade.time

The schema defines WsTrade.time only as a number, while the tid comment separately recommends (block_time, coin, tid) as a globally unique trade ID.

  • Is WsTrade.time exactly that block_time value, converted to Unix milliseconds?
  • If not, what event assigns WsTrade.time (matching, execution, block production, or something else)?
  • What are its units, and how should it be related to the node output's block_time?

2. Initial snapshot scope for public trades

The documentation attaches isSnapshot to streaming user endpoints such as WsUserFills and WsUserFundings, whereas public trades is documented as WsTrade[] with no snapshot flag.

  • Does a new public trades subscription send an initial snapshot/backfill, or live updates only?
  • If it sends a snapshot, how can clients identify it and determine its boundary?

3. Native candle completeness and revision

The candle schema defines t as open milliseconds and T as close milliseconds.

  • Does T represent only the interval boundary, or does it also indicate that the candle is complete/final?
  • Can a candle be revised after its T boundary has elapsed?
  • Is any finalization flag, publication timestamp, sequence number, or block reference exposed for a specific candle version?

The goal is to avoid look-ahead when sequencing trades and candles in research/replay. I am asking for the authoritative semantics rather than an implementation change.

Thank you.

Activity

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

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions