> ## 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 settlement results

> Returns a page of settlement results. A settlement result is the outcome determination for an instrument, with its settlement price, status, and timing.



## OpenAPI

````yaml /api-reference/clearing-api/rest-api/cbc-spec.json post /api/settlement-results/get-page
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/settlement-results/get-page:
    post:
      tags:
        - Settlement Results
      summary: Get settlement results
      description: >-
        Returns a page of settlement results. A settlement result is the outcome
        determination for an instrument, with its settlement price, status, and
        timing.
      operationId: getSettlementResults
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/SettlementResultsDecoratedQuery'
            examples:
              byInstrument:
                summary: Settlement results for an instrument
                value:
                  bookmark: null
                  queryArgs:
                    settlementResults:
                      instrumentId:
                        filters:
                          - group: 0
                            operator: EQUALS
                            value: 5217
                  rangeLimit: 50
                  paging: NEXT_PAGE
              byStatus:
                summary: Settled results for a clearing date
                value:
                  bookmark: null
                  queryArgs:
                    settlementResults:
                      settlementResultsStatus:
                        filters:
                          - group: 0
                            operator: EQUALS
                            value: SETTLED
                      clearingDate:
                        filters:
                          - group: 0
                            operator: EQUALS
                            value: '2026-07-28'
                  rangeLimit: 50
                  paging: NEXT_PAGE
      responses:
        '200':
          description: A page of results.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SettlementResultsDecoratedPage'
              example:
                bookmark: eyJsYXN0S2V5IjoiNTIxNyJ9
                content:
                  - settlementResults:
                      instrumentId: 5217
                      price:
                        value: 1
                        currency: USDC
                      settlementResultsStatus: SETTLED
                      settlementId: SR-2026-0042
                      clearingDate: '2026-07-28'
                      determinationTime: '2026-07-28T16:26:49.000Z'
                      instructionTime: '2026-07-28T16:26:49.000Z'
                      auditData:
                        lastUpdatedBy: system
                        lastUpdatedAt: '2026-07-28T16:26:50.000Z'
                    instrumentCode: PRED-ELECTION-2026
                atEnd: true
components:
  schemas:
    SettlementResultsDecoratedQuery:
      description: Query request for settlement results.
      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/SettlementResultsDecoratedQueryArgs'
    SettlementResultsDecoratedPage:
      description: Page of settlement results.
      allOf:
        - $ref: '#/components/schemas/PageResponse'
        - type: object
          properties:
            content:
              type: array
              description: Page of settlement results.
              items:
                $ref: '#/components/schemas/SettlementResultsDecorated'
    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'
    SettlementResultsDecoratedQueryArgs:
      type: object
      description: >-
        Filter and sort arguments for settlement results. All fields are
        optional.
      properties:
        settlementResults:
          description: Filters on the settlement results entity.
          allOf:
            - $ref: '#/components/schemas/SettlementResultsQueryArgs'
        instrumentCode:
          description: Filter by resolved instrument 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
    SettlementResultsDecorated:
      type: object
      description: Settlement results with the resolved instrument code.
      properties:
        settlementResults:
          description: Settlement results entity.
          allOf:
            - $ref: '#/components/schemas/SettlementResults'
        instrumentCode:
          type: string
          description: Resolved instrument code.
          example: PRED-ELECTION-2026
    Paging:
      type: string
      description: Page direction.
      enum:
        - NEXT_PAGE
        - PREVIOUS_PAGE
      example: NEXT_PAGE
    SettlementResultsQueryArgs:
      type: object
      description: Filters on the settlement results entity. All fields are optional.
      properties:
        instrumentId:
          description: Filter by instrument ID.
          allOf:
            - $ref: '#/components/schemas/LongQueryArg'
        price:
          description: Filter by settlement price.
          allOf:
            - $ref: '#/components/schemas/PriceQueryArgs'
        settlementResultsStatus:
          description: 'Filter by status: `SETTLED`, `RECEIVED`, `RUNNING`, or `FAILED`.'
          allOf:
            - $ref: '#/components/schemas/SettlementResultsStatusQueryArg'
        settlementId:
          description: Filter by settlement ID.
          allOf:
            - $ref: '#/components/schemas/StringQueryArg'
        clearingDate:
          description: Filter by clearing date.
          allOf:
            - $ref: '#/components/schemas/LocalDateQueryArg'
        determinationTime:
          description: Filter by when the outcome was determined.
          allOf:
            - $ref: '#/components/schemas/InstantQueryArg'
        instructionTime:
          description: Filter by when the outcome was instructed for settlement.
          allOf:
            - $ref: '#/components/schemas/InstantQueryArg'
        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'
    SettlementResults:
      type: object
      description: Settlement results entity.
      properties:
        instrumentId:
          type: integer
          format: int64
          description: ID of the instrument the results are stored for.
          example: 5217
        price:
          description: >-
            Settlement price the instrument expires at, typically 0 or 1.
            Greater than or equal to 0.
          allOf:
            - $ref: '#/components/schemas/Price'
          example:
            value: 1
            currency: USDC
        settlementResultsStatus:
          description: Status of the expiration process.
          allOf:
            - $ref: '#/components/schemas/SettlementResultsStatus'
          example: SETTLED
        settlementId:
          type: string
          description: Unique settlement ID.
          example: SR-2026-0042
        clearingDate:
          type: string
          format: date
          description: Clearing date the expiration was triggered in, as `YYYY-MM-DD`.
          example: '2026-07-28'
        determinationTime:
          type: string
          format: date-time
          description: Time when the outcome was determined, in ISO-8601.
          example: '2026-07-28T16:26:49.000Z'
        instructionTime:
          type: string
          format: date-time
          description: Time when the outcome was instructed for settlement, in ISO-8601.
          example: '2026-07-28T16:26:49.000Z'
        auditData:
          description: Audit data.
          allOf:
            - $ref: '#/components/schemas/AuditData'
          example:
            lastUpdatedBy: system
            lastUpdatedAt: '2026-07-28T16:26:50.000Z'
    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'
    PriceQueryArgs:
      type: object
      description: Filters on a settlement price.
      properties:
        value:
          description: Filter by price value.
          allOf:
            - $ref: '#/components/schemas/BigDecimalQueryArg'
        currency:
          description: Filter by currency code.
          allOf:
            - $ref: '#/components/schemas/StringQueryArg'
    SettlementResultsStatusQueryArg:
      type: object
      description: Filter and sort argument for a settlement result status field.
      properties:
        filters:
          type: array
          description: Filter conditions on this field.
          items:
            $ref: '#/components/schemas/SettlementResultsStatusFilter'
        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'
    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'
    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
    Price:
      type: object
      description: Price in a currency.
      properties:
        value:
          type: number
          description: Price value.
          example: 1
        currency:
          type: string
          description: Currency code.
          example: USDC
    SettlementResultsStatus:
      type: string
      description: Status of the settlement result.
      enum:
        - SETTLED
        - RECEIVED
        - RUNNING
        - FAILED
    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'
    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
    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'
    SettlementResultsStatusFilter:
      type: object
      description: Filter condition for a settlement result 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/SettlementResultsStatus'
    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'
    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'
    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
  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.

````