# News Flash RSS

<figure><img src="https://4099730103-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fypf00vlh3dJz4PJ2Q67s%2Fuploads%2Fn9qaRalCQkqWAkCIzqOC%2FDOC7.png?alt=media&#x26;token=858a617d-17ab-45e7-88da-40340b39ace2" alt=""><figcaption></figcaption></figure>

### 1. Overview

News Flash RSS delivers breaking headlines from paid news services, rewritten by AI and distributed in real time. Each headline is 1–2 sentences, ready to use as push notifications and social media posts.

* **Real-time breaking news**: Delivered as soon as a breaking event occurs.
* **1–2 sentence headlines**: Optimized for push notifications and social media distribution.
* **16 languages**: Every headline is delivered simultaneously in 16 languages.
* **Latest 100 items**: Each RSS URL returns the most recent 100 headlines.
* **Separate pipeline (Pipeline B)**: Operates on entirely different sources and processes from [News RSS](https://docs.ns3.ai/ns3-api/news-rss), [Top News RSS](https://docs.ns3.ai/ns3-api/top-news-rss), and [Daily Market Update RSS](https://docs.ns3.ai/ns3-api/daily-market-update-rss) (Pipeline A).
* **Four categories**: Major crypto news, macro news that can affect crypto markets, major exchange listing news, and price alerts for major assets (BTC, ETH, SOL, BNB, etc.).\
  Examples:\
  `"SEC ends case against Tron founder and crypto billionaire Justin Sun."`\
  `"Brent crude oil price surges to $91, up 25% over the past 7 days."`\
  `"$EIGEN listed on Robinhood spot"`\
  `"Bitcoin falls below $68,000"`

***

### 2. How the Headline Is Generated

News Flash is produced by Pipeline B. Breaking headlines received from paid news services are rewritten by AI and translated into 16 languages.

<figure><img src="https://4099730103-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fypf00vlh3dJz4PJ2Q67s%2Fuploads%2FEWKrOHRmRZEKzFwyxtUF%2Fnews%20flash.png?alt=media&#x26;token=cd52da64-3353-4d11-a5ed-c9538edfbff8" alt=""><figcaption></figcaption></figure>

**Source: Paid breaking news services**

Breaking headlines from paid services such as Bloomberg Terminal and Reuters are used as input.

**AI rewrite**

Each original headline is rewritten into the same facts in a different sentence. Rewrite principles:

* Fact preservation: All facts remain identical to the original.
* Core verb preservation: The main action verb is never replaced with a synonym (suspend ≠ halt, impose ≠ slap).
* Modality preservation: Certainty is never strengthened or weakened ("plans to" ≠ "executes", "may consider" ≠ "is considering").
* Quote preservation: Content inside quotation marks is never changed.
* \[BREAKING] tag: Headlines covering urgent or critical events are prefixed with \[BREAKING].

**Translation: Equivalent Comprehension Transfer**

Each language reader achieves the same level of understanding as an English-reading audience. How something is said may change. What is said never changes.

> News Flash and News RSS are produced by separate pipelines from different sources. News Flash delivers the headline first. When News RSS later publishes reporting and analysis of the same event, the two feeds complement each other: breaking alert first, follow-up reporting and in-depth analysis second.

***

### 3. How RSS Fields Map to UI

This section shows how each RSS field is rendered in the actual NS3 app.

<figure><img src="https://4099730103-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fypf00vlh3dJz4PJ2Q67s%2Fuploads%2FnEYzllFZSxn2An2n4TYJ%2Fnews%20flash-1.png?alt=media&#x26;token=8f8514ed-a26a-4777-90b1-48e58c27ef4d" alt=""><figcaption></figcaption></figure>

| UI Element                         | RSS Field      |
| ---------------------------------- | -------------- |
| ① Breaking headline text           | `title`        |
| ② Publish time ("\[a minute ago]") | `pubDate`      |
| ③ Push notification text           | `title` (same) |

`title` is the product text. What appears in the RSS `title` is exactly what users see in push notifications and the in-app News Flash area.

The RSS feed also includes `media:content` fields, which can provide images or videos alongside breaking headlines.

***

### 4. Validate the Data Yourself

Verify breaking news quality directly before integration.

**Breaking news quality**

The most effective way to evaluate News Flash is to experience it live alongside your existing breaking news sources.

{% hint style="success" %}
Install the NS3 app (App Store / Google Play) and enable push notifications. Compare the News Flash alerts you receive over 48 hours against crypto Twitter (X), Telegram breaking channels, and other sources you currently use.

* [App Store](https://apps.apple.com/us/app/ns3-ai-crypto-news-super-app/id6572281552)
* [Google Play](https://play.google.com/store/apps/details?id=com.sta1.front)
  {% endhint %}

**Translation quality**

Provide a language-specific News Flash RSS to any AI model and ask whether it reads naturally to local financial news readers.

```
https://api.ns3.ai/feed/news-flash?lang=[code]
```

Replace the language code to test any of the 16 supported languages:\
`en · zh-CN · zh-TW · ko · ja · ru · tr · de · es · fr · vi · th · id · hi · it · pt`

Example prompt:

{% hint style="success" %}
Read the breaking headlines at the following URLs, one in English and one in Korean. Compare the two and evaluate whether a Korean-speaking user would get the same level of information as an English-speaking user.\
<https://api.ns3.ai/feed/news-flash?lang=en\\>
<https://api.ns3.ai/feed/news-flash?lang=ko>
{% endhint %}

***

<details>

<summary>Technical specification for developers starts below</summary>

Section 5-12 is documentation for developers.

</details>

### 5. RSS URL & Languages

#### Base URL

```
https://api.ns3.ai/feed/news-flash?lang=en
```

#### 16 Language URLs

<table><thead><tr><th width="169.888916015625">Language</th><th width="99.6666259765625">Code</th><th>URL</th></tr></thead><tbody><tr><td>English</td><td>en</td><td><code>https://api.ns3.ai/feed/news-flash?lang=en</code></td></tr><tr><td>简体中文</td><td>zh-CN</td><td><code>https://api.ns3.ai/feed/news-flash?lang=zh-CN</code></td></tr><tr><td>繁體中文</td><td>zh-TW</td><td><code>https://api.ns3.ai/feed/news-flash?lang=zh-TW</code></td></tr><tr><td>한국어</td><td>ko</td><td><code>https://api.ns3.ai/feed/news-flash?lang=ko</code></td></tr><tr><td>日本語</td><td>ja</td><td><code>https://api.ns3.ai/feed/news-flash?lang=ja</code></td></tr><tr><td>Русский</td><td>ru</td><td><code>https://api.ns3.ai/feed/news-flash?lang=ru</code></td></tr><tr><td>Türkçe</td><td>tr</td><td><code>https://api.ns3.ai/feed/news-flash?lang=tr</code></td></tr><tr><td>Deutsch</td><td>de</td><td><code>https://api.ns3.ai/feed/news-flash?lang=de</code></td></tr><tr><td>Español</td><td>es</td><td><code>https://api.ns3.ai/feed/news-flash?lang=es</code></td></tr><tr><td>Français</td><td>fr</td><td><code>https://api.ns3.ai/feed/news-flash?lang=fr</code></td></tr><tr><td>Tiếng Việt</td><td>vi</td><td><code>https://api.ns3.ai/feed/news-flash?lang=vi</code></td></tr><tr><td>ไทย</td><td>th</td><td><code>https://api.ns3.ai/feed/news-flash?lang=th</code></td></tr><tr><td>Bahasa Indonesia</td><td>id</td><td><code>https://api.ns3.ai/feed/news-flash?lang=id</code></td></tr><tr><td>हिन्दी</td><td>hi</td><td><code>https://api.ns3.ai/feed/news-flash?lang=hi</code></td></tr><tr><td>Italiano</td><td>it</td><td><code>https://api.ns3.ai/feed/news-flash?lang=it</code></td></tr><tr><td>Português</td><td>pt</td><td><code>https://api.ns3.ai/feed/news-flash?lang=pt</code></td></tr></tbody></table>

`lang` is a required parameter.

***

### 6. Item Field Specification

This feed returns the latest 100 breaking headlines.

#### 6.1 Core Fields

```xml
<item>
    <title><![CDATA[Bitcoin falls below $68,000]]></title>
    <link>https://ns3.ai/en/feed</link>
    <guid isPermaLink="true">https://ns3.ai/en/feed</guid>
    <pubDate>Fri, 06 Mar 2026 17:40:02 GMT</pubDate>
</item>
```

```xml
<item>
    <title><![CDATA[[BREAKING] White House official says that the US will seize "all the oil" from Iran.]]></title>
    <link>https://ns3.ai/en/feed</link>
    <guid isPermaLink="true">https://ns3.ai/en/feed</guid>
    <pubDate>Sat, 07 Mar 2026 04:43:12 GMT</pubDate>
    <media:content medium="image" url="https://example.com/image.jpg">
    </media:content>
</item>
```

**`title`**

* Meaning: Breaking headline (1–2 sentences)
* Type: `string` (CDATA-wrapped)
* Use: Push notification text, social media post, in-app breaking display. `title` is the product text.
* Note: Headlines covering urgent or critical events are prefixed with `[BREAKING]`.

**`pubDate`**

* Meaning: Headline publish time
* Type: RFC 822/1123 format
* Use: Timeline ordering, "\[a minute ago]" display, freshness checks

**`link`**

* Value: `https://ns3.ai/en/feed` (fixed)
* Note: All items use the same URL.

**`guid`**

* Value: `https://ns3.ai/en/feed` (fixed, `isPermaLink="true"`)
* Note: All items share the same value. Standard RSS guid-based deduplication does not work. See Section 7.

**`media:content`**

* Meaning: Image or video URL accompanying the headline
* Type: `URL string`, `medium="image"` or `medium="video"`
* Note: **May be missing.** Not all headlines include media.

#### 6.2 Fields Not Included

`description`, `mentionedCoins`, `newsType`, `level`, `rank`, and `insight` are absent from this feed. News Flash is optimized for headline delivery. All content is contained in `title`.

***

### 7. Deduplication & Update Tracking

`guid` is identical across all items (`https://ns3.ai/en/feed`), so standard RSS guid-based deduplication does not work.

**Recommended approach**: Deduplicate using the `pubDate` + `title` combination.

Recommended composite key:

```
newsFlash::<lang>::<pubDate>::<normalizedTitle>
```

Title normalization: lowercase, trim leading/trailing whitespace, collapse consecutive whitespace.

If the same `pubDate` + `title` combination is fetched again, treat it as a re-delivery and safely ignore.

***

### 8. Filtering (URL Parameters)

#### 8.1 Exclude news category: `excludeNews` (single)

News Flash consists of four categories: major crypto news, macro news, and major exchange listing news. Use the `excludeNews` parameter to exclude a specific category.

<table><thead><tr><th width="100.22222900390625">Value</th><th>Excluded</th></tr></thead><tbody><tr><td>1</td><td>Removes crypto/macro news (major exchange listing news only)</td></tr><tr><td>2</td><td>Removes major exchange listing news (crypto/macro news only)</td></tr></tbody></table>

Example: Receive only crypto/macro breaking news, excluding listing news:

```
https://api.ns3.ai/feed/news-flash?lang=en&excludeSources=2
```

***

### 9. Polling & Caching

**Update method**: Headlines are reflected as soon as a breaking event occurs.

**Recommended polling interval**: 10 seconds or faster, depending on your platform's latency requirements and infrastructure capacity. For services where breaking speed is critical (push notifications, trading alerts), faster polling improves user experience.

```
Poll every 10 seconds or faster
(faster intervals recommended for push/trading alert services)
```

**Feed scope**: Latest 100 items.

**HTTP error handling**

<table><thead><tr><th width="150.33331298828125">Status</th><th>Meaning</th><th>Recommended action</th></tr></thead><tbody><tr><td>200</td><td>Success</td><td>Process feed normally</td></tr><tr><td>304</td><td>Not Modified</td><td>Use cached version (when conditional request headers are supported)</td></tr><tr><td>400</td><td>Bad Request (e.g., invalid <code>lang</code> code)</td><td>Check parameter values</td></tr><tr><td>500, 502, 503</td><td>Server error</td><td>Retry after 30-60 seconds. Do not retry immediately in a tight loop.</td></tr></tbody></table>

> If the server is unreachable or returns a non-200 response, continue serving the last successfully fetched feed until the next successful poll.

***

### 10. Timezone & Display

* `pubDate` is provided in GMT (RFC 822/1123).
* Convert to local time for UI display, but keep sorting, deduplication, and freshness checks anchored to UTC.
* Calculate "\[a minute ago]", "\[3 minutes ago]" relative time from `pubDate`.

***

### 11. Implementation Checklist

* [x] Deduplicate using `pubDate` + `title` combination (`guid` is fixed and cannot be used)
* [x] Use `title` directly as push notification and social media text
* [x] Handle missing `media:content` with a no-media layout
* [x] Distinguish image vs video using `media:content` `medium` attribute
* [x] Handle `[BREAKING]` prefix in `title` for priority display
* [x] Set polling interval to 10 seconds or faster
* [x] Convert `pubDate` GMT to local time
* [x] Support 16 languages via `lang` parameter
* [x] Implement `excludeNews` parameter for category filtering
* [x] Account for the feed returning the latest 100 items

***

### 12. FAQ

**Q: Is News RSS's newsType "breaking" the same as News Flash?**

No. newsType "breaking" is a classification assigned by the news analysis AI based on an individual article's importance (Pipeline A). News Flash is a separate feed where AI rewrites headlines from paid breaking news services (Pipeline B). The sources and production processes are entirely different.

**Q: Where can I see in-depth analysis after a breaking headline?**

[News RSS](https://docs.ns3.ai/ns3-api/news-rss) provides follow-up reporting and in-depth analysis of the same event. News Flash delivers the breaking headline, then [News RSS](https://docs.ns3.ai/ns3-api/news-rss) follows with AI Insight (five-section structured analysis).

**Q: Can News Flash contain unconfirmed information?**

News Flash prioritizes speed. Some headlines may reflect early-stage reporting that is later updated as details emerge. For verified in-depth analysis, check [News RSS](https://docs.ns3.ai/ns3-api/news-rss) for follow-up coverage of the same event.

**Q: Should we verify before republishing?**

Cross-checking before quoting, republishing, or adapting is recommended. Breaking information can evolve as details emerge.

**Q: How do I deduplicate when guid is the same for every item?**

Use the `pubDate` + `title` combination as the primary deduplication key. Recommended composite key: `newsFlash::<lang>::<pubDate>::<normalizedTitle>`.

**Q: Can I exclude listing news only?**

Use `excludeNews=2` to remove major exchange listing news and receive only crypto/macro breaking headlines.

**Q: What polling interval is appropriate?**

10 seconds or faster is recommended. For services where breaking speed is critical (push notifications, trading alerts), faster polling improves user experience. Adjust based on your platform's infrastructure capacity.

**Q: How many items does the feed include?**

The latest 100 items.

**Q: What does the \[BREAKING] prefix mean?**

Headlines covering urgent or critical events are prefixed with \[BREAKING]. This can be used to trigger priority display or alert logic in your platform.