Skip to main content

โ€‹
Overview

Use the News API to read product and market announcements published by Silvana. In this repo, these capabilities are exposed through the NewsService gRPC service. News API is useful for surfacing announcements in client UIs, monitoring product updates from agents, and building notification pipelines around protocol-level events.

โ€‹
API Surface

Below are the News API sections.

โ€‹
News Feed

Use GetNews when you need a point-in-time fetch of recent news items. The request can include filters such as a category, a tag, a result limit, and an optional pagination cursor. The response returns a list of news items with title, body, publication timestamp, optional categories, and optional tags.

โ€‹
Use Cases:

  • render a news section in a dashboard or onboarding flow;
  • batch-import announcements into a notification system;
  • audit which announcements were active at a given time.

โ€‹
Endpoints:

EndpointUse ะกase
GetNewsFetch a paginated list of news items, optionally filtered by category or tag.

โ€‹
Streams

Use StreamNews to subscribe to live news updates. The stream emits each new item as it is published. Filters mirror the unary call so that clients can subscribe to a single category or tag.

โ€‹
Use Cases:

  • show live announcement banners in trading UIs;
  • forward Silvana announcements into Slack, Discord, or alerting pipelines;
  • trigger agents on protocol-level events.

โ€‹
Endpoints:

EndpointUse ะกase
StreamNewsSubscribe to a real-time feed of news items as they are published.

โ€‹
Example flow

A typical news flow looks like this:
  1. Call GetNews once to backfill recent announcements at startup.
  2. Open StreamNews to receive live updates from that point forward.
  3. Optionally filter by category or tag to scope the feed to a specific surface.