> ## Documentation Index > Fetch the complete documentation index at: https://docs.rook.pm/llms.txt > Use this file to discover all available pages before exploring further. # List trades > Retrieve public executions for selected Rook listing_ids, optionally bounded by UTC start/end times. Choose ASC for replay or DESC for the latest records; cursor pagination preserves the filters and order. Records contain execution price, quantity, notional, units, execution/receipt timestamps and trade identity/provenance. Correction records and source identity rules let clients reconcile repeats without inventing executions. These are venue market prints rather than authenticated private fills; use your venue or broker for account execution history. See the [integration guide](/guides/market-data) for the workflow and interpretation of this response. ## OpenAPI ````yaml GET /trades openapi: 3.1.0 info: title: Rook API version: 0.1.0-design description: Markets, settlement relationships, scenarios, payouts and market data. servers: - url: https://api.rook.pm/v1 description: Proposed API origin; not an assertion these operations are callable. security: - ApiKeyBearer: [] tags: - name: Reference data description: Events, unified markets and native-ID resolution. - name: Families and scenarios description: Family scope and versioned scenario columns. - name: Relationships and Combos description: Related-market discovery, selected-set inference and Combo interpretation. - name: Payouts and exposure description: Scoped per-unit payouts and stateless portfolio/candidate calculations. - name: Market data description: Current prices, history, L2 books, prints, statistics and published fees. - name: Fair values description: Future private customer estimates; not Rook forecasts. - name: Coverage and updates description: Supported capabilities and incremental semantic changes. paths: /trades: get: tags: - Market data summary: List trades description: >- Retrieve public executions for selected Rook listing_ids, optionally bounded by UTC start/end times. Choose ASC for replay or DESC for the latest records; cursor pagination preserves the filters and order. Records contain execution price, quantity, notional, units, execution/receipt timestamps and trade identity/provenance. Correction records and source identity rules let clients reconcile repeats without inventing executions. These are venue market prints rather than authenticated private fills; use your venue or broker for account execution history. operationId: listTrades parameters: - name: listing_ids in: query required: true description: >- Rook listing IDs from /markets or /markets:resolve. Select the venue and outcome side explicitly; repeat the query parameter for multiple listings. schema: type: array items: type: string description: Opaque text identifier. Preserve its exact value. minLength: 1 minItems: 1 style: form explode: true example: - lst_pm_fed_dec_2026_cut_yes - name: start_time in: query required: false description: >- UTC start of the requested observation/execution window. Must precede end_time when both are supplied. schema: type: string format: date-time example: '2026-10-19T11:59:00Z' - name: end_time in: query required: false description: >- UTC end of the requested observation/execution window. Must follow start_time when both are supplied. schema: type: string format: date-time example: '2026-10-19T12:00:00Z' - name: order in: query required: false description: >- Execution-time ordering: ASC for chronological replay or DESC for most recent first. Keep unchanged during pagination. schema: type: string enum: - ASC - DESC example: DESC - name: page_size in: query required: false description: >- Requested maximum items; service caps disclosed by coverage. Oversize requests fail explicitly. schema: type: integer minimum: 1 default: 50 - name: page_token in: query required: false description: >- Opaque continuation; reuse the same filters/order. Cursor pins the original snapshot. schema: type: string - name: X-Client-Request-Id in: header required: false schema: type: string description: Caller correlation reference; not an idempotency guarantee. responses: '200': description: Success. content: application/json: schema: $ref: '#/components/schemas/ListTradesResponse' example: items: - listing_id: lst_pm_fed_dec_2026_cut_yes trade_id: trd_cut_10384 source_trade_id: demo-pm-trade-10384 price: '0.41' quantity: '250' notional: '102.50' quote_currency: USDC aggressor: BUY executed_at: '2026-10-19T11:59:52Z' received_at: '2026-10-19T11:59:52.150Z' record_type: EXECUTION identity_method: VENUE next_page_token: null snapshot_id: snap_rates_20261019_120000 as_of: '2026-10-19T12:00:00Z' headers: X-Request-Id: description: Server request trace ID. schema: type: string description: Opaque text identifier. Preserve its exact value. minLength: 1 components: schemas: ListTradesResponse: type: object properties: items: type: array items: $ref: '#/components/schemas/Trade' next_page_token: anyOf: - type: string - type: 'null' snapshot_id: type: string description: Opaque text identifier. Preserve its exact value. minLength: 1 as_of: type: string format: date-time required: - items - next_page_token - snapshot_id - as_of additionalProperties: true Trade: type: object properties: listing_id: type: string minLength: 1 description: >- Rook ID for one outcome listing on one venue; preserves venue provenance. trade_id: type: string description: Opaque text identifier. Preserve its exact value. minLength: 1 source_trade_id: anyOf: - type: string description: Opaque text identifier. Preserve its exact value. minLength: 1 - type: 'null' price: $ref: '#/components/schemas/Decimal' quantity: $ref: '#/components/schemas/Decimal' notional: $ref: '#/components/schemas/Decimal' quote_currency: type: string aggressor: anyOf: - type: string enum: - BUY - SELL - type: 'null' executed_at: type: string format: date-time received_at: anyOf: - type: string format: date-time - type: 'null' record_type: type: string enum: - EXECUTION - CORRECTION - CANCELLATION corrects_trade_id: anyOf: - type: string description: Opaque text identifier. Preserve its exact value. minLength: 1 - type: 'null' identity_method: type: string enum: - VENUE - DERIVED required: - listing_id - trade_id - source_trade_id - price - quantity - quote_currency - executed_at - record_type - identity_method additionalProperties: true Decimal: type: string description: >- Exact base-10 value encoded as a string; no exponent or non-finite values. pattern: ^-?(0|[1-9][0-9]*)(\.[0-9]+)?$ securitySchemes: ApiKeyBearer: type: http scheme: bearer description: >- Proposed server-to-server API key. No client request HMAC signing scheme is specified. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.