> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cdp.coinbase.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Get event trades

> Returns a page of event (prediction market) trades. Uses the same request and response schema as Get derivative trades.



## OpenAPI

````yaml /api-reference/clearing-api/rest-api/cbc-spec.json post /api/trades/get-event-trades
openapi: 3.0.3
info:
  title: Coinbase Clearing REST API
  description: >-
    Read-only queries of Coinbase Clearing LLC (CBC) trades, prices, settlement
    results, event positions, and balances.
  version: 1.0.0
servers:
  - url: https://{host}/cdp-api
    variables:
      host:
        default: host
        description: >-
          Host name for your environment. REST API host names are not published
          yet; environments are described on the Coinbase Clearing Connectivity
          page.
security:
  - bearerAuth: []
tags:
  - name: Trades
    description: Derivative and event trades.
  - name: Prices
    description: Instrument prices.
  - name: Settlement Results
    description: Settlement results for instruments.
  - name: Positions
    description: Event positions.
  - name: Balances
    description: Account balances.
paths:
  /api/trades/get-event-trades:
    post:
      tags:
        - Trades
      summary: Get event trades
      description: >-
        Returns a page of event (prediction market) trades. Uses the same
        request and response schema as Get derivative trades.
      operationId: getEventTrades
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/TradeDecoratedQuery'
            example:
              bookmark: null
              queryArgs:
                trade:
                  instrumentId:
                    filters:
                      - group: 0
                        operator: EQUALS
                        value: 12345
                  tradeDate:
                    filters:
                      - group: 0
                        operator: AFTER_OR_EQUALS
                        value: '2026-01-01'
              rangeLimit: 100
              paging: NEXT_PAGE
      responses:
        '200':
          description: A page of results.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/TradeDecoratedPage'
components:
  schemas:
    TradeDecoratedQuery:
      description: Query request for trades.
      allOf:
        - $ref: '#/components/schemas/PageRequest'
        - type: object
          properties:
            queryArgs:
              description: >-
                Filter and sort arguments. Use `null` to return all results
                unfiltered.
              nullable: true
              allOf:
                - $ref: '#/components/schemas/TradeDecoratedQueryArgs'
    TradeDecoratedPage:
      description: Page of trades.
      allOf:
        - $ref: '#/components/schemas/PageResponse'
        - type: object
          properties:
            content:
              type: array
              description: Page of trades.
              items:
                $ref: '#/components/schemas/TradeDecorated'
    PageRequest:
      type: object
      description: Fields shared by every query request.
      required:
        - rangeLimit
        - paging
      properties:
        bookmark:
          type: string
          nullable: true
          description: >-
            Pagination cursor from the previous response. Use `null` for the
            first page.
          example: null
        rangeLimit:
          type: integer
          format: int32
          description: Maximum number of results per page.
          example: 50
        paging:
          $ref: '#/components/schemas/Paging'
    TradeDecoratedQueryArgs:
      type: object
      description: Filter and sort arguments for trades. All fields are optional.
      properties:
        trade:
          description: Filters on the trade entity.
          allOf:
            - $ref: '#/components/schemas/TradeQueryArgs'
        accountCode:
          description: Filter by resolved account code.
          allOf:
            - $ref: '#/components/schemas/StringQueryArg'
        clearingMemberCode:
          description: Filter by resolved clearing member code.
          allOf:
            - $ref: '#/components/schemas/StringQueryArg'
        instrumentCode:
          description: Filter by resolved instrument code.
          allOf:
            - $ref: '#/components/schemas/StringQueryArg'
        productCode:
          description: Filter by resolved product code.
          allOf:
            - $ref: '#/components/schemas/StringQueryArg'
        eventName:
          description: Filter by resolved event name.
          allOf:
            - $ref: '#/components/schemas/StringQueryArg'
        seriesName:
          description: Filter by resolved series name.
          allOf:
            - $ref: '#/components/schemas/StringQueryArg'
        marketCode:
          description: Filter by resolved market code.
          allOf:
            - $ref: '#/components/schemas/StringQueryArg'
    PageResponse:
      type: object
      description: Fields shared by every query response.
      properties:
        bookmark:
          type: string
          description: Cursor to fetch the next or previous page.
          example: eyJsYXN0S2V5IjoiMTAwMyJ9
        atEnd:
          type: boolean
          description: '`true` when there are no more pages in the current direction.'
          example: false
    TradeDecorated:
      type: object
      description: Trade with resolved codes and names.
      properties:
        trade:
          description: Trade entity.
          allOf:
            - $ref: '#/components/schemas/Trade'
        accountCode:
          type: string
          description: Resolved account code.
          example: ACC-5001
        clearingMemberCode:
          type: string
          description: Resolved clearing member code.
          example: CM-100
        instrumentCode:
          type: string
          description: Resolved instrument code.
          example: BTCUSD-FUT-MAR26
        productCode:
          type: string
          description: Resolved product code. Only applicable to derivative markets.
          example: BTC-FUTURES
          nullable: true
        eventName:
          type: string
          description: Resolved event name. Only applicable to prediction markets.
          example: null
          nullable: true
        seriesName:
          type: string
          description: Resolved series name. Only applicable to prediction markets.
          example: null
          nullable: true
        marketCode:
          type: string
          description: Resolved market code.
          example: CME
    Paging:
      type: string
      description: Page direction.
      enum:
        - NEXT_PAGE
        - PREVIOUS_PAGE
      example: NEXT_PAGE
    TradeQueryArgs:
      type: object
      description: Filters on the trade entity. All fields are optional.
      properties:
        tradeKey:
          description: Filter by trade key.
          allOf:
            - $ref: '#/components/schemas/TradeKeyQueryArgs'
        tradeType:
          description: Filter by trade type.
          allOf:
            - $ref: '#/components/schemas/TradeTypeQueryArg'
        tradeEntryType:
          description: Filter by trade entry type.
          allOf:
            - $ref: '#/components/schemas/TradeEntryTypeQueryArg'
        dealId:
          description: Filter by deal ID.
          allOf:
            - $ref: '#/components/schemas/StringQueryArg'
        memberId:
          description: Filter trades for a specific member.
          allOf:
            - $ref: '#/components/schemas/LongQueryArg'
        accountId:
          description: Filter trades for a specific account.
          allOf:
            - $ref: '#/components/schemas/LongQueryArg'
        subAccount:
          description: Filter by sub-account.
          allOf:
            - $ref: '#/components/schemas/StringQueryArg'
        productId:
          description: Filter by product ID.
          allOf:
            - $ref: '#/components/schemas/LongQueryArg'
        eventId:
          description: Filter by event ID. Typically used with event trades.
          allOf:
            - $ref: '#/components/schemas/LongQueryArg'
        seriesId:
          description: Filter by series ID. Typically used with event trades.
          allOf:
            - $ref: '#/components/schemas/LongQueryArg'
        instrumentId:
          description: Filter trades for a specific instrument.
          allOf:
            - $ref: '#/components/schemas/LongQueryArg'
        currency:
          description: Filter by currency code.
          allOf:
            - $ref: '#/components/schemas/StringQueryArg'
        tradeDate:
          description: Filter by trade date range.
          allOf:
            - $ref: '#/components/schemas/LocalDateQueryArg'
        clearingDate:
          description: Filter by clearing date.
          allOf:
            - $ref: '#/components/schemas/LocalDateQueryArg'
        tradeSide:
          description: Filter by `BUY` or `SELL`.
          allOf:
            - $ref: '#/components/schemas/TradeSideQueryArg'
        positionEffect:
          description: Filter by position effect.
          allOf:
            - $ref: '#/components/schemas/PositionEffectQueryArg'
        price:
          description: Filter by trade price.
          allOf:
            - $ref: '#/components/schemas/BigDecimalQueryArg'
        quantity:
          description: Filter by trade quantity.
          allOf:
            - $ref: '#/components/schemas/BigDecimalQueryArg'
        tradeValue:
          description: Filter by trade value.
          allOf:
            - $ref: '#/components/schemas/MonetaryAmountQueryArgs'
        reference:
          description: Filter by reference.
          allOf:
            - $ref: '#/components/schemas/StringQueryArg'
        marketId:
          description: Filter by market ID.
          allOf:
            - $ref: '#/components/schemas/LongQueryArg'
        reservedQuantity:
          description: Filter by reserved quantity.
          allOf:
            - $ref: '#/components/schemas/BigDecimalQueryArg'
        availableQuantity:
          description: Filter by available quantity.
          allOf:
            - $ref: '#/components/schemas/BigDecimalQueryArg'
        fee:
          description: Filter by fee.
          allOf:
            - $ref: '#/components/schemas/MonetaryAmountQueryArgs'
        tradeStatus:
          description: 'Filter by status: `ACTIVE`, `RESERVED`, or `INACTIVE`.'
          allOf:
            - $ref: '#/components/schemas/TradeStatusQueryArg'
        matchedTimestamp:
          description: Filter by match time.
          allOf:
            - $ref: '#/components/schemas/InstantQueryArg'
        receivedTimestamp:
          description: Filter by receive time.
          allOf:
            - $ref: '#/components/schemas/InstantQueryArg'
        orderId:
          description: Filter by order ID.
          allOf:
            - $ref: '#/components/schemas/StringQueryArg'
        clOrderId:
          description: Filter by customer-assigned order ID.
          allOf:
            - $ref: '#/components/schemas/StringQueryArg'
        sideExecutionId:
          description: Filter by side execution ID.
          allOf:
            - $ref: '#/components/schemas/StringQueryArg'
        customerTypeIndicator:
          description: Filter by customer type indicator.
          allOf:
            - $ref: '#/components/schemas/CustomerTypeIndicatorQueryArg'
        exchangeTradeId:
          description: Filter by exchange trade ID.
          allOf:
            - $ref: '#/components/schemas/StringQueryArg'
        exchangeTradeReportId:
          description: Filter by exchange trade report ID.
          allOf:
            - $ref: '#/components/schemas/StringQueryArg'
        transferId:
          description: Filter by position transfer ID.
          allOf:
            - $ref: '#/components/schemas/StringQueryArg'
        exchange:
          description: Filter by source exchange.
          allOf:
            - $ref: '#/components/schemas/StringQueryArg'
        tradeSource:
          description: 'Filter by source: `EXCHANGE`, `MANUAL`, or `SYSTEM`.'
          allOf:
            - $ref: '#/components/schemas/TradeSourceQueryArg'
        differentialPrice:
          description: Filter by differential price.
          allOf:
            - $ref: '#/components/schemas/BigDecimalQueryArg'
        lastAction:
          description: Filter by last action.
          allOf:
            - $ref: '#/components/schemas/StringQueryArg'
        auditData:
          description: Filter by audit fields.
          allOf:
            - $ref: '#/components/schemas/AuditDataQueryArgs'
    StringQueryArg:
      type: object
      description: Filter and sort argument for a string field.
      properties:
        filters:
          type: array
          description: Filter conditions on this field.
          items:
            $ref: '#/components/schemas/StringFilter'
        sorter:
          $ref: '#/components/schemas/Sorter'
    Trade:
      type: object
      description: Trade entity.
      properties:
        tradeKey:
          description: Unique key of the trade.
          allOf:
            - $ref: '#/components/schemas/TradeKey'
          example:
            tradeId: '1001'
        tradeType:
          description: Type of the trade.
          allOf:
            - $ref: '#/components/schemas/TradeType'
          example: ORIGINAL_TRADE
        tradeEntryType:
          description: Sub-type of the trade, kept on the original trade.
          allOf:
            - $ref: '#/components/schemas/TradeEntryType'
          example: REGULAR_TRADE
        dealId:
          type: string
          description: >-
            Deal ID, shared by all trades in the same deal (match). A deal is
            either a manual deal or a set of trades received from the exchange.
          example: DEAL-2026-0042
        memberId:
          type: integer
          format: int64
          description: ID of the member that owns the trade.
          example: 100
        accountId:
          type: integer
          format: int64
          description: ID of the account the trade is booked on.
          example: 5001
        subAccount:
          type: string
          description: Sub-account of the trade.
          example: HOUSE
        productId:
          description: ID of the product. Only applicable to derivative markets.
          allOf:
            - $ref: '#/components/schemas/OptionalLong'
          nullable: true
          example:
            value: 200
        eventId:
          description: ID of the event. Populated for event (prediction market) trades.
          allOf:
            - $ref: '#/components/schemas/OptionalLong'
          nullable: true
        seriesId:
          description: ID of the series. Populated for event (prediction market) trades.
          allOf:
            - $ref: '#/components/schemas/OptionalLong'
          nullable: true
        instrumentId:
          type: integer
          format: int64
          description: ID of the traded instrument.
          example: 12345
        currency:
          type: string
          description: Code of the currency the trade value is denominated in.
          example: USDC
        tradeDate:
          type: string
          format: date
          description: Business date the trade was placed or matched, as `YYYY-MM-DD`.
          example: '2026-01-15'
        clearingDate:
          type: string
          format: date
          description: >-
            Clearing business date, as `YYYY-MM-DD`. Determined from the trade
            date and when the trade should be cleared.
          example: '2026-01-15'
        tradeSide:
          description: Whether the trade is a buy or a sell.
          allOf:
            - $ref: '#/components/schemas/TradeSide'
          example: BUY
        positionEffect:
          description: Whether the trade opens or closes a position. For information only.
          allOf:
            - $ref: '#/components/schemas/PositionEffect'
          example: OPEN
        price:
          type: number
          description: Trade price.
          example: 142.5
        quantity:
          type: number
          description: >-
            Trade quantity, in absolute terms. The trade side indicates whether
            the quantity is received or delivered. Greater than 0.
          minimum: 0
          exclusiveMinimum: true
          example: 10
        tradeValue:
          description: >-
            Trade value, in absolute terms. The trade side indicates whether it
            is a credit or a debit.
          allOf:
            - $ref: '#/components/schemas/MonetaryAmount'
          example:
            amount: 1425
            currency: USDC
        reference:
          type: string
          nullable: true
          description: >-
            Free-text reference or reason for creating or updating the trade, or
            a value from the trade message.
          example: null
        marketId:
          type: integer
          format: int64
          description: ID of the market the instrument belongs to.
          example: 1
        reservedQuantity:
          type: number
          description: Quantity reserved pending a trade management action.
          example: 0
        availableQuantity:
          type: number
          description: >-
            Quantity still available for further trade management, such as
            allocation or give-up.
          example: 10
        fee:
          description: >-
            Fee amount received on the trade from the exchange, with up to 6
            decimal places.
          allOf:
            - $ref: '#/components/schemas/MonetaryAmount'
          example:
            amount: 1.25
            currency: USDC
        tradeStatus:
          description: >-
            Status of the trade. Indicates which actions can be performed on the
            trade and whether it currently contributes to a position.
          allOf:
            - $ref: '#/components/schemas/TradeStatus'
          example: ACTIVE
        matchedTimestamp:
          type: string
          format: date-time
          description: >-
            Date and time the trade was matched at the exchange, in ISO-8601.
            Set by the user for manual trades.
          example: '2026-01-15T14:30:00.123Z'
        receivedTimestamp:
          type: string
          format: date-time
          description: >-
            Date and time the trade was received by the clearing system, in
            ISO-8601.
          example: '2026-01-15T14:30:00.100Z'
        orderId:
          type: string
          description: Unique ID of the order or trade, when received from the exchange.
          example: ORD-98765
        clOrderId:
          type: string
          description: Order ID assigned by the customer.
          example: CLIENT-ORD-001
        sideExecutionId:
          type: string
          description: Side execution ID, as received in the trade message.
          example: EXEC-54321
        customerTypeIndicator:
          description: Customer type indicator (CTI) of the trade.
          allOf:
            - $ref: '#/components/schemas/CustomerTypeIndicator'
          example: CTI_1
        exchangeTradeId:
          type: string
          description: >-
            Exchange ID that links all trades in a deal. Used to reconcile with
            the exchange.
          example: EXT-DEAL-2026-0042
        exchangeTradeReportId:
          type: string
          nullable: true
          description: >-
            Unique ID from the exchange trade message. Changes with each
            message, including cancellations. Received as a UUIDv7.
          example: null
        transferId:
          type: string
          nullable: true
          description: Position transfer ID. Set when the trade type is `TRANSFER`.
          example: null
        exchange:
          type: string
          description: >-
            Exchange the trade came from, usually a MIC code. Exactly 4
            uppercase letters or digits.
          minLength: 4
          maxLength: 4
          pattern: ^[A-Z0-9]+$
          example: XCME
        tradeSource:
          description: >-
            How the trade entered the clearing system: received from an
            exchange, entered by a clearing operator, or created by the system.
          allOf:
            - $ref: '#/components/schemas/TradeSource'
          example: EXCHANGE
        differentialPrice:
          type: number
          nullable: true
          description: >-
            Price adjustment relative to the settlement price, charged on the
            next settlement run. Only applicable to `BTIC` and `TAS` trades.
          example: null
        refTradeId:
          type: array
          items:
            type: string
          description: >-
            References to the original trades, when trades were created by trade
            management actions or a trade cancellation.
          example: []
        lastAction:
          type: string
          nullable: true
          description: Last action that created or changed the trade.
          example: null
        auditData:
          description: Audit data.
          allOf:
            - $ref: '#/components/schemas/AuditData'
          example:
            lastUpdatedBy: system
            lastUpdatedAt: '2026-01-15T14:30:00.150Z'
    TradeKeyQueryArgs:
      type: object
      description: Filters on the trade key.
      properties:
        tradeId:
          description: Filter by trade ID.
          allOf:
            - $ref: '#/components/schemas/StringQueryArg'
    TradeTypeQueryArg:
      type: object
      description: Filter and sort argument for a trade type field.
      properties:
        filters:
          type: array
          description: Filter conditions on this field.
          items:
            $ref: '#/components/schemas/TradeTypeFilter'
        sorter:
          $ref: '#/components/schemas/Sorter'
    TradeEntryTypeQueryArg:
      type: object
      description: Filter and sort argument for a trade entry type field.
      properties:
        filters:
          type: array
          description: Filter conditions on this field.
          items:
            $ref: '#/components/schemas/TradeEntryTypeFilter'
        sorter:
          $ref: '#/components/schemas/Sorter'
    LongQueryArg:
      type: object
      description: Filter and sort argument for a 64-bit integer field.
      properties:
        filters:
          type: array
          description: Filter conditions on this field.
          items:
            $ref: '#/components/schemas/LongFilter'
        sorter:
          $ref: '#/components/schemas/Sorter'
    LocalDateQueryArg:
      type: object
      description: Filter and sort argument for a date field.
      properties:
        filters:
          type: array
          description: Filter conditions on this field.
          items:
            $ref: '#/components/schemas/LocalDateFilter'
        sorter:
          $ref: '#/components/schemas/Sorter'
    TradeSideQueryArg:
      type: object
      description: Filter and sort argument for a trade side field.
      properties:
        filters:
          type: array
          description: Filter conditions on this field.
          items:
            $ref: '#/components/schemas/TradeSideFilter'
        sorter:
          $ref: '#/components/schemas/Sorter'
    PositionEffectQueryArg:
      type: object
      description: Filter and sort argument for a position effect field.
      properties:
        filters:
          type: array
          description: Filter conditions on this field.
          items:
            $ref: '#/components/schemas/PositionEffectFilter'
        sorter:
          $ref: '#/components/schemas/Sorter'
    BigDecimalQueryArg:
      type: object
      description: Filter and sort argument for a decimal field.
      properties:
        filters:
          type: array
          description: Filter conditions on this field.
          items:
            $ref: '#/components/schemas/BigDecimalFilter'
        sorter:
          $ref: '#/components/schemas/Sorter'
    MonetaryAmountQueryArgs:
      type: object
      description: Filters on a monetary amount.
      properties:
        amount:
          description: Filter by amount.
          allOf:
            - $ref: '#/components/schemas/BigDecimalQueryArg'
        currency:
          description: Filter by currency code.
          allOf:
            - $ref: '#/components/schemas/StringQueryArg'
    TradeStatusQueryArg:
      type: object
      description: Filter and sort argument for a trade status field.
      properties:
        filters:
          type: array
          description: Filter conditions on this field.
          items:
            $ref: '#/components/schemas/TradeStatusFilter'
        sorter:
          $ref: '#/components/schemas/Sorter'
    InstantQueryArg:
      type: object
      description: Filter and sort argument for a timestamp field.
      properties:
        filters:
          type: array
          description: Filter conditions on this field.
          items:
            $ref: '#/components/schemas/InstantFilter'
        sorter:
          $ref: '#/components/schemas/Sorter'
    CustomerTypeIndicatorQueryArg:
      type: object
      description: Filter and sort argument for a customer type indicator field.
      properties:
        filters:
          type: array
          description: Filter conditions on this field.
          items:
            $ref: '#/components/schemas/CustomerTypeIndicatorFilter'
        sorter:
          $ref: '#/components/schemas/Sorter'
    TradeSourceQueryArg:
      type: object
      description: Filter and sort argument for a trade source field.
      properties:
        filters:
          type: array
          description: Filter conditions on this field.
          items:
            $ref: '#/components/schemas/TradeSourceFilter'
        sorter:
          $ref: '#/components/schemas/Sorter'
    AuditDataQueryArgs:
      type: object
      description: Filters on audit fields.
      properties:
        lastUpdatedBy:
          description: Filter by the user who last updated the entity.
          allOf:
            - $ref: '#/components/schemas/StringQueryArg'
        lastUpdatedAt:
          description: Filter by when the entity was last updated.
          allOf:
            - $ref: '#/components/schemas/InstantQueryArg'
    StringFilter:
      type: object
      description: Filter condition for a string field.
      required:
        - group
        - operator
        - value
      properties:
        group:
          type: integer
          format: int32
          description: >-
            Filter group. Filters in the same group are combined with AND;
            groups are combined with OR.
          example: 0
        operator:
          type: string
          description: Filter operator.
          enum:
            - EQUALS
            - NOT_EQUALS
            - CONTAINS
            - STARTS_WITH
            - ENDS_WITH
          example: EQUALS
        value:
          type: string
          description: String value to compare.
          example: ACC-5001
    Sorter:
      type: object
      description: Sort configuration for a field.
      properties:
        priority:
          type: integer
          format: int32
          description: Sort priority. A lower value has a higher priority.
          example: 0
        sortingDirection:
          type: string
          description: Sort direction.
          enum:
            - ASCENDING
            - DESCENDING
          example: DESCENDING
    TradeKey:
      type: object
      description: Unique key of the trade.
      properties:
        tradeId:
          type: string
          description: Unique ID of the trade across all trades in the system.
          example: '1001'
    TradeType:
      type: string
      description: Type of the trade.
      enum:
        - ORIGINAL_TRADE
        - CANCELLATION_TRADE
        - EXPIRATION_TRADE
        - TRANSFER
    TradeEntryType:
      type: string
      description: Sub-type of the trade.
      enum:
        - REGULAR_TRADE
        - BLOCK
        - EFP
        - EFR
        - TAS
        - BTIC
    OptionalLong:
      type: object
      nullable: true
      description: Wrapped 64-bit integer, or `null` when not set.
      properties:
        value:
          type: integer
          format: int64
          description: The value.
          example: 200
    TradeSide:
      type: string
      description: Buy or sell.
      enum:
        - BUY
        - SELL
    PositionEffect:
      type: string
      description: Whether the trade opens or closes a position.
      enum:
        - OPEN
        - CLOSE
    MonetaryAmount:
      type: object
      description: Amount in a currency.
      properties:
        amount:
          type: number
          description: Amount.
          example: 1425
        currency:
          type: string
          description: Currency code.
          example: USDC
    TradeStatus:
      type: string
      description: Current status of the trade.
      enum:
        - ACTIVE
        - RESERVED
        - INACTIVE
    CustomerTypeIndicator:
      type: string
      description: Customer type indicator (CTI).
      enum:
        - CTI_1
        - CTI_2
        - CTI_3
        - CTI_4
    TradeSource:
      type: string
      description: How the trade entered the clearing system.
      enum:
        - EXCHANGE
        - MANUAL
        - SYSTEM
    AuditData:
      type: object
      description: Audit data.
      properties:
        lastUpdatedBy:
          type: string
          description: ID of the user who created or last updated the entity.
          example: system
        lastUpdatedAt:
          type: string
          format: date-time
          description: Date and time when the entity was last updated.
          example: '2026-01-15T14:30:00.150Z'
    TradeTypeFilter:
      type: object
      description: Filter condition for a trade type field.
      required:
        - group
        - operator
        - value
      properties:
        group:
          type: integer
          format: int32
          description: >-
            Filter group. Filters in the same group are combined with AND;
            groups are combined with OR.
          example: 0
        operator:
          type: string
          description: Filter operator.
          enum:
            - EQUALS
            - NOT_EQUALS
          example: EQUALS
        value:
          $ref: '#/components/schemas/TradeType'
    TradeEntryTypeFilter:
      type: object
      description: Filter condition for a trade entry type field.
      required:
        - group
        - operator
        - value
      properties:
        group:
          type: integer
          format: int32
          description: >-
            Filter group. Filters in the same group are combined with AND;
            groups are combined with OR.
          example: 0
        operator:
          type: string
          description: Filter operator.
          enum:
            - EQUALS
            - NOT_EQUALS
          example: EQUALS
        value:
          $ref: '#/components/schemas/TradeEntryType'
    LongFilter:
      type: object
      description: Filter condition for a 64-bit integer field.
      required:
        - group
        - operator
        - value
      properties:
        group:
          type: integer
          format: int32
          description: >-
            Filter group. Filters in the same group are combined with AND;
            groups are combined with OR.
          example: 0
        operator:
          type: string
          description: Filter operator.
          enum:
            - EQUALS
            - NOT_EQUALS
            - GREATER_THAN
            - GREATER_THAN_OR_EQUALS
            - LESS_THAN
            - LESS_THAN_OR_EQUALS
          example: EQUALS
        value:
          type: integer
          format: int64
          description: Integer value to compare.
          example: 12345
    LocalDateFilter:
      type: object
      description: Filter condition for a date field.
      required:
        - group
        - operator
        - value
      properties:
        group:
          type: integer
          format: int32
          description: >-
            Filter group. Filters in the same group are combined with AND;
            groups are combined with OR.
          example: 0
        operator:
          type: string
          description: Filter operator.
          enum:
            - EQUALS
            - NOT_EQUALS
            - AFTER
            - AFTER_OR_EQUALS
            - BEFORE
            - BEFORE_OR_EQUALS
          example: EQUALS
        value:
          type: string
          format: date
          description: Date to compare, as `YYYY-MM-DD`.
          example: '2026-01-01'
    TradeSideFilter:
      type: object
      description: Filter condition for a trade side field.
      required:
        - group
        - operator
        - value
      properties:
        group:
          type: integer
          format: int32
          description: >-
            Filter group. Filters in the same group are combined with AND;
            groups are combined with OR.
          example: 0
        operator:
          type: string
          description: Filter operator.
          enum:
            - EQUALS
            - NOT_EQUALS
          example: EQUALS
        value:
          $ref: '#/components/schemas/TradeSide'
    PositionEffectFilter:
      type: object
      description: Filter condition for a position effect field.
      required:
        - group
        - operator
        - value
      properties:
        group:
          type: integer
          format: int32
          description: >-
            Filter group. Filters in the same group are combined with AND;
            groups are combined with OR.
          example: 0
        operator:
          type: string
          description: Filter operator.
          enum:
            - EQUALS
            - NOT_EQUALS
          example: EQUALS
        value:
          $ref: '#/components/schemas/PositionEffect'
    BigDecimalFilter:
      type: object
      description: Filter condition for a decimal field.
      required:
        - group
        - operator
        - value
      properties:
        group:
          type: integer
          format: int32
          description: >-
            Filter group. Filters in the same group are combined with AND;
            groups are combined with OR.
          example: 0
        operator:
          type: string
          description: Filter operator.
          enum:
            - EQUALS
            - NOT_EQUALS
            - GREATER_THAN
            - GREATER_THAN_OR_EQUALS
            - LESS_THAN
            - LESS_THAN_OR_EQUALS
          example: EQUALS
        value:
          type: number
          description: Decimal number to compare.
          example: 142.5
    TradeStatusFilter:
      type: object
      description: Filter condition for a trade status field.
      required:
        - group
        - operator
        - value
      properties:
        group:
          type: integer
          format: int32
          description: >-
            Filter group. Filters in the same group are combined with AND;
            groups are combined with OR.
          example: 0
        operator:
          type: string
          description: Filter operator.
          enum:
            - EQUALS
            - NOT_EQUALS
          example: EQUALS
        value:
          $ref: '#/components/schemas/TradeStatus'
    InstantFilter:
      type: object
      description: Filter condition for a timestamp field.
      required:
        - group
        - operator
        - value
      properties:
        group:
          type: integer
          format: int32
          description: >-
            Filter group. Filters in the same group are combined with AND;
            groups are combined with OR.
          example: 0
        operator:
          type: string
          description: Filter operator.
          enum:
            - EQUALS
            - NOT_EQUALS
            - AFTER
            - AFTER_OR_EQUALS
            - BEFORE
            - BEFORE_OR_EQUALS
          example: EQUALS
        value:
          type: string
          format: date-time
          description: ISO-8601 date-time to compare.
          example: '2026-01-15T14:30:00.123Z'
    CustomerTypeIndicatorFilter:
      type: object
      description: Filter condition for a customer type indicator field.
      required:
        - group
        - operator
        - value
      properties:
        group:
          type: integer
          format: int32
          description: >-
            Filter group. Filters in the same group are combined with AND;
            groups are combined with OR.
          example: 0
        operator:
          type: string
          description: Filter operator.
          enum:
            - EQUALS
            - NOT_EQUALS
          example: EQUALS
        value:
          $ref: '#/components/schemas/CustomerTypeIndicator'
    TradeSourceFilter:
      type: object
      description: Filter condition for a trade source field.
      required:
        - group
        - operator
        - value
      properties:
        group:
          type: integer
          format: int32
          description: >-
            Filter group. Filters in the same group are combined with AND;
            groups are combined with OR.
          example: 0
        operator:
          type: string
          description: Filter operator.
          enum:
            - EQUALS
            - NOT_EQUALS
          example: EQUALS
        value:
          $ref: '#/components/schemas/TradeSource'
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT
      description: >-
        JWT generated from a Coinbase Developer Platform (CDP) API key. See CDP
        API key JWT authentication.

````