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

# News Wire

> Timely market headlines with related securities, timestamps, and live price context.

News Wire delivers a continuously updated stream of market headlines. It combines timestamped coverage with related symbols and price movement so users can quickly understand what changed and which securities may be affected.

<iframe data-widget-embed-slot="news-wire" src="https://h5.ainvest.com/frontPage/regular/widgets-container/news-wire-open-widget-preview.html" title="AInvest News Wire widget preview" style={{ display: "block", width: "100%", height: "min(80vh, 900px)", minHeight: "720px", maxHeight: "900px", border: 0, borderRadius: "12px", overflow: "hidden" }} loading="lazy" allow="clipboard-write; fullscreen" allowFullScreen referrerPolicy="strict-origin-when-cross-origin" />

## Properties

### Common properties

| Name              | Type                         | Required | Default      | Description                                                                |
| ----------------- | ---------------------------- | -------- | ------------ | -------------------------------------------------------------------------- |
| `theme`           | `"light" or "dark"`          | No       | `light`      | Visual theme applied inside the widget iframe.                             |
| `locale`          | `string`                     | No       | `en`         | Locale used by labels, formatting, and component copy when supported.      |
| `colorPreference` | `"GreenForUp" or "RedForUp"` | No       | `GreenForUp` | Controls whether green or red represents positive price movement.          |
| `autoHeight`      | `boolean`                    | No       | `true`       | Enables ResizeObserver-driven iframe height updates through `postMessage`. |

### Widget properties

| Name              | Type      | Required | Default | Description                                                         |
| ----------------- | --------- | -------- | ------- | ------------------------------------------------------------------- |
| `pageSize`        | `number`  | No       | `20`    | Number of news items requested per page. Valid range: `1` to `100`. |
| `pollingEnabled`  | `boolean` | No       | `true`  | Enables periodic refresh for new headlines.                         |
| `pollingInterval` | `number`  | No       | `30000` | Polling interval in milliseconds. Valid range: `5000` to `300000`.  |

## Events

| Event           | Payload                                                                                                | Description                                |
| --------------- | ------------------------------------------------------------------------------------------------------ | ------------------------------------------ |
| `itemClick`     | `{ newsId: string; title: string; sourceUrl: string; source?: string; publishTime: string or number }` | Fired when a news item is clicked.         |
| `stockTagClick` | `{ symbol: string; exchange?: string; name?: string }`                                                 | Fired when a related stock tag is clicked. |
| `itemExposed`   | `{ newsId: string; insertTime?: number }`                                                              | Fired when a news item is exposed.         |
| `signInClick`   | `{}`                                                                                                   | Fired when the sign-in action is clicked.  |

## When to use News Wire

* Trading workspaces where headline speed and ticker context matter
* Symbol pages filtered to company-specific coverage
* Market homepages combining stocks, crypto, and macro news
* Event pages that need timely coverage around scheduled catalysts

## Core experience

Each item should include a readable headline, timestamp, source or content identity where applicable, and related securities. Price movement is supporting context and should never replace the meaning of the headline.

Clearly identify the timezone and whether the feed is live, reconnecting, delayed, or filtered. Preserve already loaded headlines during a reconnect when possible.

## Content and connection states

Support loading, reconnecting, empty-filter, delayed-feed, entitlement, rate-limit, and error states. Do not remove already readable headlines during temporary connection loss.

If no headlines match the current filters, explain the filter state and provide a clear recovery path. Avoid presenting placeholder headlines as real market news.

## Responsive behavior

On narrow screens, prioritize timestamp, headline, and the most relevant symbol. Move secondary price context into a compact metadata row. Headlines should wrap naturally without creating nested horizontal scrolling.

## Accessibility

* Use descriptive link text based on the full headline.
* Include timezone information with timestamps.
* Ensure symbol and price metadata do not interrupt headline reading order.
* Preserve visible focus as new items arrive.
* Avoid aggressive live-region announcements for every headline update.

## Best practices

* Select a feed that matches the page's audience and market scope.
* Keep timestamps and related symbols visually consistent.
* Avoid auto-scrolling when new headlines arrive.
* Open external stories with predictable link behavior.
* Test reconnecting, no-results, rate-limit, and high-frequency update states.

## Related widgets

* [Quick Quote](/widgets/api-reference/quick-quote) adds current price and session context beside headlines.
* [Market Calendar](/widgets/api-reference/market-calendar) pairs real-time coverage with scheduled events.