Skip to main content
GET
Window-aggregate cross-check (counts, volumes, fees, fingerprint)

Authorizations

X-Api-Key
string
header
required

Partner / integrator key — format ps_live_<keyId>_<secret>. Partner keys are issued by PredictStreet; a user can also create keys bound to their own wallet from their account settings in the web app. Never ship to a browser. multi_wallet partners must additionally send X-User-Wallet: 0x<40-hex> on every authenticated request to declare the acting wallet. See the API keys guide for scope taxonomy, partner kinds, rate limits, and rotation procedure.

Query Parameters

from
string
required

ISO-8601 inclusive lower bound. Compared against trade modifiedAt = GREATEST(createdAt, settledAt) — same expression the /partner/trades feed's ?modifiedSince= filter uses. This is a deliberate alignment: a partner's local trade set (built by pulling ?modifiedSince=) and the server-side recon aggregate describe the EXACT same set of trades over the same window. Partners reconciling MUST compute their local fingerprint over trades whose CURRENT modifiedAt falls in [from, to) (i.e. use the latest copy of each trade in their warehouse).

Example:

"2026-05-09T00:00:00Z"

to
string
required

ISO-8601 exclusive upper bound. Window length capped at 24 hours — partners must paginate by hour/day for longer audits. Comparison is on modifiedAt; see from for the full alignment rationale.

Example:

"2026-05-10T00:00:00Z"

Response

200 - application/json
window
object
required
totals
object
required
fingerprint
object
required
computedAt
string
required

Server-side Date.now() at which this snapshot was computed. Live windows (where to > computedAt) recompute on every call (60s cache); past windows cache for 1 hour.