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

# List generated channel narrative summaries

> Returns generated channel narrative summaries selected by Source Window overlap. Results expose traderId for continuity but not channel identity or raw source material.



## OpenAPI

````yaml /openapi.json get /api/v1/channel-summaries
openapi: 3.1.0
info:
  title: Centaur API
  version: 1.0.0
  description: >-
    Public, read-only API for Centaur's data over REST with a companion MCP
    surface.
servers:
  - url: https://partners.centaur.io
    description: Current service base URL
security: []
tags:
  - name: System
    description: Health and service metadata endpoints.
  - name: Discovery
    description: Read-only trader and asset directory discovery endpoints.
  - name: Events
    description: >-
      Historical trade-event reads with source, trader, asset, and position
      context.
  - name: Messages
    description: >-
      Read-only access to source messages by message timestamp or Source Message
      ID.
  - name: Channel Summaries
    description: Generated channel narrative summaries selected by Source Window overlap.
  - name: Aggregate Summaries
    description: >-
      Generated aggregate narrative summaries selected by Aggregate Window
      overlap.
  - name: Positions
    description: Read-only position history and open-position live state reads.
  - name: Stats
    description: Read-only aggregate trader and asset stats.
externalDocs:
  description: Canonical Centaur API documentation
  url: https://partners.centaur.io/docs
paths:
  /api/v1/channel-summaries:
    get:
      tags:
        - Channel Summaries
      summary: List generated channel narrative summaries
      description: >-
        Returns generated channel narrative summaries selected by Source Window
        overlap. Results expose traderId for continuity but not channel identity
        or raw source material.
      operationId: listChannelSummaries
      parameters:
        - schema:
            type: string
            format: date-time
            description: >-
              ISO-8601 lower bound for Source Window overlap. A Source Window
              must end after this timestamp.
          required: false
          description: >-
            ISO-8601 lower bound for Source Window overlap. A Source Window must
            end after this timestamp.
          name: startTime
          in: query
        - schema:
            type: string
            format: date-time
            description: >-
              ISO-8601 upper bound for Source Window overlap. A Source Window
              must start before this timestamp.
          required: false
          description: >-
            ISO-8601 upper bound for Source Window overlap. A Source Window must
            start before this timestamp.
          name: endTime
          in: query
        - schema:
            type: integer
            minimum: 1
            maximum: 200
            description: Maximum number of rows to return.
          required: false
          description: Maximum number of rows to return.
          name: limit
          in: query
        - schema:
            type: string
            minLength: 1
            description: Forward pagination cursor from `meta.nextCursor`.
          required: false
          description: Forward pagination cursor from `meta.nextCursor`.
          name: cursor
          in: query
        - schema:
            anyOf:
              - type: boolean
              - type: string
            description: >-
              Include low-signal generated summaries. Defaults to false,
              returning only safe summaries.
          required: false
          description: >-
            Include low-signal generated summaries. Defaults to false, returning
            only safe summaries.
          name: includeLowSignal
          in: query
      responses:
        '200':
          description: Paginated list of generated channel narrative summaries
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    enum:
                      - true
                  data:
                    $ref: '#/components/schemas/ChannelSummariesResponseData'
                  requestId:
                    type: string
                    example: c8e2c6e4-80dd-4ffc-9d66-4e31bf64c6b8
                required:
                  - success
                  - data
                  - requestId
        '400':
          description: Invalid cursor
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
              example:
                success: false
                error:
                  code: INVALID_CURSOR
                  message: Malformed cursor
                requestId: c8e2c6e4-80dd-4ffc-9d66-4e31bf64c6b8
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
              example:
                success: false
                error:
                  code: UNAUTHORIZED
                  message: Unauthorized
                requestId: c8e2c6e4-80dd-4ffc-9d66-4e31bf64c6b8
        '403':
          description: Forbidden
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
              example:
                success: false
                error:
                  code: FORBIDDEN
                  message: Forbidden
                requestId: c8e2c6e4-80dd-4ffc-9d66-4e31bf64c6b8
        '422':
          description: Validation error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
        '503':
          description: Authentication service temporarily unavailable
          headers:
            Retry-After:
              description: Seconds to wait before retrying authentication
              schema:
                type: integer
                minimum: 1
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
              example:
                success: false
                error:
                  code: AUTHENTICATION_UNAVAILABLE
                  message: Authentication is temporarily unavailable
                requestId: c8e2c6e4-80dd-4ffc-9d66-4e31bf64c6b8
      security:
        - ApiKeyAuth: []
components:
  schemas:
    ChannelSummariesResponseData:
      type: object
      properties:
        results:
          type: array
          items:
            $ref: '#/components/schemas/ChannelSummary'
        meta:
          type: object
          properties:
            hasMore:
              type: boolean
            nextCursor:
              type: string
              nullable: true
            appliedTimeRange:
              $ref: '#/components/schemas/AppliedTimeRange'
          required:
            - hasMore
            - nextCursor
            - appliedTimeRange
      required:
        - results
        - meta
    ErrorEnvelope:
      type: object
      properties:
        success:
          type: boolean
          enum:
            - false
        error:
          $ref: '#/components/schemas/Error'
        requestId:
          type: string
          example: c8e2c6e4-80dd-4ffc-9d66-4e31bf64c6b8
      required:
        - success
        - error
        - requestId
    ChannelSummary:
      type: object
      properties:
        id:
          type: string
        traderId:
          type: integer
          description: >-
            Stable trader ID for correlating Generated Channel Narrative
            Summaries from the same trader over time.
        windowStart:
          type: string
          format: date-time
          description: Inclusive UTC start of the source window.
        windowEnd:
          type: string
          format: date-time
          description: Exclusive UTC end of the source window.
        generatedAt:
          type: string
          format: date-time
        status:
          type: string
          enum:
            - safe
            - low_signal
        overview:
          type: string
        keyInsights:
          type: array
          items:
            type: string
          maxItems: 3
        marketBias:
          type: string
          enum:
            - bullish
            - bearish
            - mixed
            - neutral
            - unclear
        mentionedAssets:
          type: array
          items:
            type: object
            properties:
              symbol:
                type: string
              name:
                type: string
                nullable: true
              stance:
                type: string
                enum:
                  - bullish
                  - bearish
                  - mixed
                  - neutral
                  - unclear
              confidence:
                type: string
                enum:
                  - low
                  - medium
                  - high
            required:
              - symbol
              - name
              - stance
              - confidence
          maxItems: 5
      required:
        - id
        - traderId
        - windowStart
        - windowEnd
        - generatedAt
        - status
        - overview
        - keyInsights
        - marketBias
        - mentionedAssets
    AppliedTimeRange:
      type: object
      properties:
        startTime:
          type: string
          nullable: true
          format: date-time
        endTime:
          type: string
          nullable: true
          format: date-time
      required:
        - startTime
        - endTime
    Error:
      type: object
      properties:
        code:
          type: string
          description: Stable machine-readable error code.
          example: UNAUTHORIZED
        message:
          type: string
          description: Human-readable explanation for the failure.
          example: Unauthorized
        details:
          nullable: true
          description: Optional structured details for validation or input failures.
      required:
        - code
        - message
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: x-api-key
      description: API key issued by Centaur.
      x-default: <api-key>

````