Order Management System REST API - Trades Controller
The trades/fromdate URL provides access to executed Trades.
Retrieve trades between two timestamps
Section titled “Retrieve trades between two timestamps”GET /trades/fromdate
Retrieves the trades between two timestamps in the event stream for the requested views.
Query Parameters
Section titled “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. |
| 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. |
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
Section titled “Response”| Code | Status | Description |
|---|---|---|
| 200 | Success | Content is an array of ExternalAction objects. |
| 403 | Failure | You supplied invalid owner or account values. |
Examples
Section titled “Examples”In this example, we retrieve the first 100 Trades in the six-month period.
curl --oauth2-bearer $AccessToken http://oms.hub/trades/fromdate?from=20250101T000000Z&to=20250601T000000Z&count=100