Order Management System REST API - Event Controller

The event/fromdate URL provides access to the events generated by OMS views.

Retrieve events between two timestamps

GET /event/fromdate

Retrieves the events between two timestamps in the event stream for the requested views.

Query Parameters

Parameter	Expected	Description
from	Optional	An ISO8601 date and time. The earliest timestamp to return (exclusive). If omitted, defaults to the beginning of time.
to	Optional	An ISO8601 date and time. The most recent timestamp to return (inclusive). If omitted, defaults to now.
count	Optional	An integer. The maximum number of records to return. If omitted, returns every record.
for	Optional	The SubscriptionType to return events for. Repeat for additional views. If omitted, supplies events for all views.
owner	Optional	The Owner ID to return events for. Repeat for additional owners. If omitted, returns all owners.
account	Optional	A Trading Account ID of the format <owner>/<account> to return events for. Repeat for additional accounts. If omitted, returns all accounts.
snapshot	Optional	True to include starting snapshot events for the requested views. If omitted or false, no snapshot is supplied.

When using the owner and account filters, an event must match a listed owner OR a listed account to be returned.

Eg: owner=A&account=B%2FC will return events for all Accounts with Owner A, plus events for Account B/C.

Response

Code	Status	Description
200	Success	Content is an array of EventMessage objects.
403	Failure	You supplied invalid owner or account values.

Examples

In this example, we retrieve the first 100 Transaction events in the six-month period.

curl --oauth2-bearer $AccessToken http://oms.hub/event/fromdate?from=20250101T000000Z&to=20250601T000000Z&count=100&for=Transactions