Prefer Streaming for Real-Time UpdatesThis polling API is subject to rate limits. For production applications that need continuous order and trade updates, use the gRPC Order Stream instead. The streaming API provides real-time execution reports as they happen. Endpoints
| Method | Endpoint | Description |
|---|
POST | /v1/report/orders/search | Search orders with filters |
POST | /v1/report/trades/search | Search trades with filters |
POST | /v1/report/executions/search | Search executions with filters |
POST | /v1/report/orders/csv | Export orders to CSV |
POST | /v1/report/trades/csv | Export trades to CSV |
POST | /v1/report/executions/csv | Export executions to CSV |
POST | /v1/report/trades/stats | Get aggregated trade statistics |
No Participant ID Required for Trade StatsThe /v1/report/trades/stats endpoint only requires Auth0 JWT authentication with read:reports scope. You do not need to provide the x-participant-id header or complete KYC onboarding to access aggregated trade statistics.Note: Other report endpoints (orders search, trades search, etc.) still require participant_id.
When to Use
| Use Case | Recommended API |
|---|
| Real-time order status updates | gRPC Order Stream |
| Real-time fill notifications | gRPC Order Stream |
| Historical order lookup | REST Orders Search (this API) |
| End-of-day reconciliation | REST Reports Export |
| Audit and compliance reports | REST Reports Export |
Streaming First ArchitectureFor any use case requiring real-time order or trade updates, use the streaming API. Use the REST Report API only for:
- Historical data queries
- One-time lookups
- Batch exports for reporting
Search vs Export
- Search endpoints (
/v1/report/orders/search, /v1/report/trades/search, /v1/report/executions/search): Return paginated JSON results for programmatic access
- Export endpoints (
/v1/report/orders/csv, /v1/report/trades/csv, /v1/report/executions/csv): Return CSV file streams for spreadsheet analysis and reporting
Common Filters
| Filter | Description |
|---|
symbols | Filter by trading symbols |
accounts | Filter by trading accounts |
startTime / endTime | Date range filter |
states | Order states (NEW, FILLED, CANCELED, etc.) |
sides | BUY or SELL |
