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

# News API

# 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:

| **Endpoint** | **Use Сase**                                                                  |
| :----------- | :---------------------------------------------------------------------------- |
| `GetNews`    | Fetch 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:

| **Endpoint** | **Use Сase**                                                       |
| :----------- | :----------------------------------------------------------------- |
| `StreamNews` | Subscribe 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.