> For the complete documentation index, see [llms.txt](https://docs.metacopier.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.metacopier.io/features/market-news.md).

# Market news

**Market news** collects the financial headlines that matter for the instruments you trade and puts them next to the [Economic calendar](/features/economic-calendar.md). You find it inside a project, in the left-hand menu under **Market news**.

{% hint style="info" %}
Market news is part of your subscription. It unlocks as soon as at least one account is connected to the project.
{% endhint %}

## What an article shows

Every article is condensed into a short headline and a one paragraph summary of at most 150 characters, together with:

* **Currencies:** The ISO codes whose own value the article is about. A currency that only quotes a price is not listed, so gold rising in dollars names gold, not USD.
* **Impact:** High only when the article can move a whole currency or asset class, Medium for scheduled data and company results, otherwise Low.
* **Sentiment:** Bullish, Neutral or Bearish for the main subject of the article, not for the market as a whole.
* **Sentiment per symbol:** The direction for each listed currency and instrument on its own. The yen gaining on the dollar is Bullish for JPY and Bearish for USD.
* **Published:** When the article appeared.

Through the API, `sentimentScore` is the strength of the overall sentiment in \[-1, 1] and always agrees with it: at least 0.2 for Bullish, at most -0.2 for Bearish, in between for Neutral. `sentimentBySymbol` carries the per symbol direction, for example `{"JPY":"BULLISH","USD":"BEARISH"}`. Older articles, summarised before this field was introduced, do not have it.

{% hint style="warning" %}
Headline, summary, impact and sentiment are produced automatically from the incoming articles. They are a restatement, not the original text, and they are not investment advice. Treat them as a fast overview and verify anything you intend to trade on.
{% endhint %}

Articles that are not market relevant (lifestyle, sport, promotions, pure opinion pieces) are dropped before they reach the page.

## Filtering

* **Search** across headline, summary, currencies and category.
* **Category:** Forex, Markets, Indicators, Crypto or General.
* **Impact** and **Sentiment**.
* **Currencies:** Any combination of the currencies you care about. Combined with a sentiment, the sentiment is matched per currency, so JPY with Bullish finds the articles where the yen is bullish.
* **Saved:** Shows only the articles you bookmarked.

Through the API you can also narrow the list to a publication time range with `from` and `to` (ISO-8601 UTC).

## Sentiment per currency

The API endpoint `GET /rest/api/v1/projects/{projectId}/marketNews/sentiment` sums up the per symbol sentiment of all articles published in a range (by default the last 24 hours, at most 31 days). For every currency or instrument it returns how many articles were bullish, neutral and bearish, a score of (bullish - bearish) / articles in \[-1, 1], and the resulting label: at least 0.2 is Bullish, at most -0.2 is Bearish. You can narrow it with `symbols`, a minimum `impact` and a `category`.

Only articles that carry a per symbol sentiment are counted. Like everything on this page it is an automated overview, not investment advice.

## Bookmarks

The bookmark icon on an article keeps it in the **Saved** list. Bookmarks belong to the **project**, not to the individual member, which is the same scope every other news setting has. Saving an article that is already saved is not an error.

## How current the data is

News is refreshed every 15 minutes.

## Getting headlines pushed to you

You do not have to open the page to stay informed. In the [Economic calendar](/features/economic-calendar.md), a **standing rule** with **Also announce market headlines** enabled forwards high impact articles matching its impact and currency settings to your notification channels as they are published. Such a rule needs no lead time, so it can be used for headlines alone.
