News Flash RSS

Breaking Headlines

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, Top News RSS, and 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.

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.

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.

circle-check

Translation quality

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

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:

circle-check

chevron-rightTechnical specification for developers starts belowhashtag

Section 5-12 is documentation for developers.

5. RSS URL & Languages

Base URL

16 Language URLs

Language
Code
URL

English

en

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

简体中文

zh-CN

https://api.ns3.ai/feed/news-flash?lang=zh-CN

繁體中文

zh-TW

https://api.ns3.ai/feed/news-flash?lang=zh-TW

한국어

ko

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

日本語

ja

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

Русский

ru

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

Türkçe

tr

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

Deutsch

de

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

Español

es

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

Français

fr

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

Tiếng Việt

vi

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

ไทย

th

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

Bahasa Indonesia

id

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

हिन्दी

hi

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

Italiano

it

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

Português

pt

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

lang is a required parameter.


6. Item Field Specification

This feed returns the latest 100 breaking headlines.

6.1 Core Fields

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:

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.

Value
Excluded

1

Removes crypto/macro news (major exchange listing news only)

2

Removes major exchange listing news (crypto/macro news only)

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


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.

Feed scope: Latest 100 items.

HTTP error handling

Status
Meaning
Recommended action

200

Success

Process feed normally

304

Not Modified

Use cached version (when conditional request headers are supported)

400

Bad Request (e.g., invalid lang code)

Check parameter values

500, 502, 503

Server error

Retry after 30-60 seconds. Do not retry immediately in a tight loop.

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


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 provides follow-up reporting and in-depth analysis of the same event. News Flash delivers the breaking headline, then 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 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.

Last updated