Skip to main content
GET
Cross-wallet executed-trade feed (incremental, cursor-paginated)

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

modifiedSince
string
required

ISO-8601 timestamp. Returns trades whose effective modification time (GREATEST of createdAt, settledAt) is at or after this value. Required — the partner feed is incremental-only by design to keep pagination keyset-deterministic.

Example:

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

cursor
string

Opaque cursor returned in nextCursor from the previous page. Pass back unchanged. When omitted the page starts at the front of the modifiedSince window.

limit
number
default:50

Page size. Defaults to 50, capped at 300. The partner-tier rate limit (default 600/min) is the real ceiling — small pages with many calls is gentler on the DB than rare giant pages, and the cursor model means a partner who hits nextCursor !== null just fetches the next batch on the next call without losing rows.

Required range: 1 <= x <= 300
marketId
string

Optional market-symbol filter (e.g. WC26-FINAL-ARG-BRA-…). When present, only trades from that one market are returned.

Response

200 - application/json
trades
object[]
required
nextCursor
string | null
required

Opaque cursor for the next page. Pass back unchanged as ?cursor=<value> to continue. NULL when there is no further page in the modifiedSince window.