Documentation Index
Fetch the complete documentation index at: https://docs.polymarket.us/llms.txt
Use this file to discover all available pages before exploring further.
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 |
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 |