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

# Get the market pulse news feed

> Get the market pulse news feed.

 Returns the latest cached snapshot of AI-synthesized, per-asset news
 headlines with sentiment tags, refreshed hourly from the upstream
 pipeline by a background poller. The request path never calls the
 upstream. Public endpoint — no authentication required. Responses carry
 an ETag (the snapshot's generatedAt); clients may send If-None-Match to
 receive 304 when unchanged.



## OpenAPI

````yaml /proto-openapi/api/openapi.yaml get /api/v1/pulse
openapi: 3.0.3
info:
  title: Monaco Protocol API
  description: REST API for the Monaco Protocol hybrid CLOB exchange.
  version: 1.0.0
servers:
  - url: https://staging.apimonaco.xyz
    description: Staging server (Testnet)
security: []
tags:
  - name: AccountsService
  - name: ApplicationsService
  - name: AuthService
  - name: BuildercodeRewardsService
  - name: CopyTradingService
  - name: DelegatedAgentsService
  - name: FaucetService
  - name: FeesService
  - name: HealthService
  - name: ManagedMarketsService
    description: |-
      Wallet-authenticated maker assignments. The signed session must match both
       configured maker user and application. Owner IDs are process fences, never auth.
       Only wallet sessions are supported; delegated-agent sessions receive 403.
  - name: MarginAccountsService
    description: |-
      Current public isolated-margin semantics:
       - a user has one parent margin account per application scope
       - opening orders create or reuse isolated position buckets under that parent
       - parent account creation is handled internally by margin workflows
  - name: MarketService
  - name: OrderbookService
  - name: OrdersService
  - name: PositionsService
    description: |-
      Current public isolated-margin semantics:
       - positions link to a parent margin account and, when applicable, a bucket id
       - opening orders create or reuse isolated position buckets under the parent
       - users can open another isolated position by reusing the parent account with a different market bucket
  - name: PulseService
  - name: SweeperService
  - name: TraderCodeService
  - name: TradesService
  - name: WhitelistService
  - name: WithdrawalsService
paths:
  /api/v1/pulse:
    get:
      tags:
        - PulseService
        - Pulse
      summary: Get the market pulse news feed
      description: |-
        Get the market pulse news feed.

         Returns the latest cached snapshot of AI-synthesized, per-asset news
         headlines with sentiment tags, refreshed hourly from the upstream
         pipeline by a background poller. The request path never calls the
         upstream. Public endpoint — no authentication required. Responses carry
         an ETag (the snapshot's generatedAt); clients may send If-None-Match to
         receive 304 when unchanged.
      operationId: get_pulse
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetPulseResponse'
        '503':
          description: Pulse feed not yet available
components:
  schemas:
    GetPulseResponse:
      type: object
      properties:
        generatedAt:
          example: '2026-07-22T15:17:14Z'
          type: string
          description: >-
            When this snapshot was produced upstream, ISO-8601 UTC; also serves
            as the response ETag value
          nullable: true
        watchlist:
          example:
            - BTC
            - ETH
            - SOL
            - SEI
            - HYPE
          type: array
          items:
            type: string
            minLength: 1
          description: Asset universe this snapshot was synthesized against
          nullable: true
        items:
          type: array
          items:
            $ref: '#/components/schemas/PulseItem'
          description: >-
            Pulse items, pre-sorted: watchlist order first, MARKET last,
            most-recent-first within each asset. Items with unverified figures
            are removed server-side.
          nullable: true
    PulseItem:
      type: object
      properties:
        asset:
          example: SEI
          type: string
          description: Watchlist ticker (e.g. "BTC") or "MARKET" for a cross-asset story
          nullable: true
        sentiment:
          example: Bullish
          type: string
          description: 'Sentiment tag: "Bullish", "Neutral", or "Bearish"'
          nullable: true
        summary:
          example: SEI gained 4% amid ecosystem growth.
          type: string
          description: Synthesized 1-2 sentence summary, at most 240 characters
          nullable: true
        updatedAt:
          example: '2026-07-21T02:15:19'
          type: string
          description: >-
            Timestamp of the most recent source in the cluster, ISO-8601; render
            relative time client-side
          nullable: true
        sources:
          type: array
          items:
            $ref: '#/components/schemas/PulseSource'
          description: Provenance for the item, for attribution links
          nullable: true
    PulseSource:
      type: object
      properties:
        url:
          example: https://coinmarketcap.com/top-stories/6a5f0c340787ae5558351f0f/
          type: string
          description: Source article or post URL
          nullable: true
        author:
          example: CoinMarketCap
          type: string
          description: Source author or publication name
          nullable: true
        source:
          example: news
          type: string
          description: 'Source channel: "twitter" or "news"'
          nullable: true
        createdAt:
          example: '2026-07-21T02:15:19'
          type: string
          description: Source publication time, ISO-8601
          nullable: true
        relevance:
          example: 4
          type: integer
          description: Relevance score, 1 (low) to 5 (high)
          format: uint32
          nullable: true

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.