Skip to main content
Page through leaves. Used by clients catching up cold or re-syncing after a long disconnect.
For clients catching up from cold or verifying an independently built mirror. Ordinary trading does not need it. This is an authenticated read. Complete Transport & Attestation before sending the bearer token.

Authorizations

Authorization
string
header
required

Short-lived (≤ 1h) bearer token from POST /auth/token.

Expiry is EXACT — there is no grace period past expires_in, on REST or on the streaming transport. Refresh on a margin.

A structurally valid, unexpired token is still refused when it has been revoked (401), when the operator has invalidated the tokens the account was holding (401), or when the account is suspended (403). Suspension also blocks issuing a new one, so re-authenticating does not clear it.

Query Parameters

from
integer
required
to
integer
required
tree_id
integer
default:0

Which Merkle shard to page (0..num_trees-1). Default 0.

Response

Leaves in [from, to) on the selected shard.

leaves
object[]
required
merkle_root
string
required