> ## 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 instrument prices

> Returns a page of instrument prices.



## OpenAPI

````yaml /api-reference/clearing-api/rest-api/cbc-spec.json post /api/price/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/price/get-page:
    post:
      tags:
        - Prices
      summary: Get instrument prices
      description: Returns a page of instrument prices.
      operationId: getInstrumentPrices
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/InstrumentPriceDecoratedQuery'
            example:
              bookmark: null
              queryArgs:
                instrumentPrice:
                  instrumentId:
                    filters:
                      - group: 0
                        operator: EQUALS
                        value: 5678
                  businessDate:
                    filters:
                      - group: 0
                        operator: EQUALS
                        value: '2026-05-30'
              rangeLimit: 50
              paging: NEXT_PAGE
      responses:
        '200':
          description: A page of results.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/InstrumentPriceDecoratedPage'
              example:
                bookmark: eyJsYXN0S2V5IjoiNTY3OC0yMDI2LTA1LTMwIn0=
                content:
                  - instrumentPrice:
                      businessDate: '2026-05-30'
                      instrumentId: 5678
                      priceTag: SETTLEMENT
                      priceType: NORMAL
                      price: 27350.75
                      auditData:
                        lastUpdatedBy: price-feed
                        lastUpdatedAt: '2026-05-30T18:00:01.000Z'
                    instrumentCode: BTCUSD-FUT-JUN26
                  - instrumentPrice:
                      businessDate: '2026-05-30'
                      instrumentId: 5678
                      priceTag: INTRADAY_SETTLEMENT
                      priceType: NORMAL
                      price: 27345
                      auditData:
                        lastUpdatedBy: price-feed
                        lastUpdatedAt: '2026-05-30T14:00:00.000Z'
                    instrumentCode: BTCUSD-FUT-JUN26
                atEnd: true
components:
  schemas:
    InstrumentPriceDecoratedQuery:
      description: Query request for instrument prices.
      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/InstrumentPriceDecoratedQueryArgs'
    InstrumentPriceDecoratedPage:
      description: Page of instrument prices.
      allOf:
        - $ref: '#/components/schemas/PageResponse'
        - type: object
          properties:
            content:
              type: array
              description: Page of instrument prices.
              items:
                $ref: '#/components/schemas/InstrumentPriceDecorated'
    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'
    InstrumentPriceDecoratedQueryArgs:
      type: object
      description: >-
        Filter and sort arguments for instrument prices. All fields are
        optional.
      properties:
        instrumentPrice:
          description: Filters on the instrument price entity.
          allOf:
            - $ref: '#/components/schemas/InstrumentPriceQueryArgs'
        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
    InstrumentPriceDecorated:
      type: object
      description: Instrument price with the resolved instrument code.
      properties:
        instrumentPrice:
          description: Instrument price entity.
          allOf:
            - $ref: '#/components/schemas/InstrumentPrice'
        instrumentCode:
          type: string
          description: Resolved instrument code.
          example: BTCUSD-FUT-JUN26
    Paging:
      type: string
      description: Page direction.
      enum:
        - NEXT_PAGE
        - PREVIOUS_PAGE
      example: NEXT_PAGE
    InstrumentPriceQueryArgs:
      type: object
      description: Filters on the instrument price entity. All fields are optional.
      properties:
        businessDate:
          description: Filter by business date.
          allOf:
            - $ref: '#/components/schemas/LocalDateQueryArg'
        instrumentId:
          description: Filter by instrument ID.
          allOf:
            - $ref: '#/components/schemas/LongQueryArg'
        priceTag:
          description: >-
            Filter by price tag: `REAL_TIME`, `INTRADAY_SETTLEMENT`, or
            `SETTLEMENT`.
          allOf:
            - $ref: '#/components/schemas/PriceTagQueryArg'
        priceType:
          description: 'Filter by price type: `NORMAL`, `CLEAN_BOND`, or `DIRTY_BOND`.'
          allOf:
            - $ref: '#/components/schemas/PriceTypeQueryArg'
        price:
          description: Filter by price value.
          allOf:
            - $ref: '#/components/schemas/BigDecimalQueryArg'
        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'
    InstrumentPrice:
      type: object
      description: Instrument price entity.
      properties:
        businessDate:
          type: string
          format: date
          description: Business date of the price, as `YYYY-MM-DD`.
          example: '2026-05-30'
        instrumentId:
          type: integer
          format: int64
          description: ID of the instrument or asset the price is stored for.
          example: 5678
        priceTag:
          description: >-
            Price tag. `SETTLEMENT` is the official settlement price for a date,
            used in expiration, exercise, and end-of-day margining and
            variation. `INTRADAY_SETTLEMENT` is an official price determined
            during the day, used for intraday margining and variation.
            `REAL_TIME` is used for continuous risk monitoring during the day
            and does not cause settlements or payments.
          allOf:
            - $ref: '#/components/schemas/PriceTag'
          example: SETTLEMENT
        priceType:
          description: >-
            Type of price. `CLEAN_BOND` excludes and `DIRTY_BOND` includes
            accrued interest, for assets such as fixed income. Defaults to
            `NORMAL`.
          allOf:
            - $ref: '#/components/schemas/PriceType'
          example: NORMAL
        price:
          type: number
          description: Price of the instrument or asset.
          example: 27350.75
        auditData:
          description: Audit data.
          allOf:
            - $ref: '#/components/schemas/AuditData'
          example:
            lastUpdatedBy: price-feed
            lastUpdatedAt: '2026-05-30T18:00:01.000Z'
    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'
    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'
    PriceTagQueryArg:
      type: object
      description: Filter and sort argument for a price tag field.
      properties:
        filters:
          type: array
          description: Filter conditions on this field.
          items:
            $ref: '#/components/schemas/PriceTagFilter'
        sorter:
          $ref: '#/components/schemas/Sorter'
    PriceTypeQueryArg:
      type: object
      description: Filter and sort argument for a price type field.
      properties:
        filters:
          type: array
          description: Filter conditions on this field.
          items:
            $ref: '#/components/schemas/PriceTypeFilter'
        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'
    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
    PriceTag:
      type: string
      description: Price tag of the price.
      enum:
        - REAL_TIME
        - INTRADAY_SETTLEMENT
        - SETTLEMENT
    PriceType:
      type: string
      description: Type of the price.
      enum:
        - NORMAL
        - CLEAN_BOND
        - DIRTY_BOND
    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'
    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'
    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
    PriceTagFilter:
      type: object
      description: Filter condition for a price tag 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/PriceTag'
    PriceTypeFilter:
      type: object
      description: Filter condition for a price 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/PriceType'
    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
    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'
    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'
  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.

````