Skip to main content
GET
Per-MM KPI-bucket feed (keyset-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

from
string
required

ISO-8601 lower bound (inclusive) on bucketStart. Keep constant across a cursor walk.

Example:

"2026-06-11T00:00:00Z"

to
string

ISO-8601 upper bound (exclusive) on bucketStart.

marketMakerId
string

Filter to one market maker id (see /market-makers).

marketSymbol
string

Filter to one market symbol.

cursor
string

Opaque cursor from the previous page. Pass back unchanged.

limit
number
default:500

Page size. Values above 1000 are rejected with 400.

Required range: 1 <= x <= 1000

Response

200 - application/json
buckets
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.