Skip to main content
GET
Get order events
Response JSON below is an illustrative testnet snapshot, not a live mainnet result. Use the selected server and its network-specific addresses for actual requests.
Events are scoped to the resting order owner and ordered newest first by their canonical source position. filled means an active maker order was completely executed: the final fill left updatedSize equal to "0". Partial executions and passive-liquidity fills are not included. A fill belongs to the resting maker’s history, not the taker’s, unless they are the same user. This endpoint is completion-oriented history. The Exchange Gateway userOrders stream’s trade event is different: it includes both partial and complete fills. A frontend can recognize a completion from that stream when the trade’s updatedSize is zero.
string
required
Unsigned decimal Kuru user ID.
integer
default:"100"
Page size from 1 through 500.
string
Opaque exclusive continuation cursor from pagination.nextCursor.
string
Optional lowercase 20-byte market filter.
integer
Inclusive Unix time in seconds.
integer
Inclusive Unix time in seconds. When both bounds are present, to must be greater than from.
integer | null
required
Feed epoch containing globalUserSeq.
string | null
required
Finalized user sequence covered by the materialized response.
array
required
Finalized order events ordered newest first.
string
required
created, filled, cancelled, or rab-reduced.
string
required
integer
required
string
required
string
required
string
required
Resting-order owner. This matches the path userId.
string
required
Account that caused the mutation; the taker for filled.
string
required
string | null
required
boolean
required
Side of the resting order.
string
required
Order price in market price precision (pp).
string | null
required
Initial size for created, final execution quantity for filled, removed size for cancelled, and null for rab-reduced. Values use the market’s native size precision. For filled, this is not the sum of earlier partial fills.
string | null
required
Remaining size for created and rab-reduced; always "0" for filled; null for cancelled.
string | null
required
Optional reduce-after block captured when the order was created.
integer
required
Maker fee rate snapshotted for created, or the actual maker rate for the terminal execution in filled; other event kinds carry zero. The denominator is 10,000,000.
integer
required
Block proposal time in Unix seconds.
string
required
string | null
required
integer | null
required
integer | null
required
string | null
required
Opaque continuation cursor, or null when no continuation is available.
When both cursor fields are non-null, the response provides the finalized user sequence cut associated with the materialized history. Pagination cursors are exclusive and retain the original response’s feed epoch and user sequence. Illustrative completed-order entry (the enclosing response is unchanged):

Path Parameters

userId
integer
required

Query Parameters

marketAddress
string
limit
integer
cursor
string
from
integer
to
integer

Response

200

Order events