# Symbols Brief

## Generate Symbols Brief 

<mark style="color:blue;">`GET`</mark> `https://api.main.finalle.ai/symbols_brief`

Get an AI generated, real-time summarized briefs of symbols latest events.

#### Headers

Include the `X-API-Key`header in order to authenticate:

```json
{  
    "X-API-Key": "YOUR_API_KEY"
}
```

#### Path Parameters

<table><thead><tr><th width="268">Name</th><th>Type</th><th>Description</th></tr></thead><tbody><tr><td>symbols<mark style="color:red;">*</mark></td><td>String</td><td>A comma separated list of symbols to review, maximum is 20 tickers. At least one symbol must be provided.</td></tr><tr><td>period</td><td>String (Enum)</td><td>Specifies the time frame for the brief. Acceptable values are <code>daily</code> for a daily brief (last 24H), <code>12H</code> (for last 12H), and <code>weekly</code> for a weekly brief. Defaults to <code>weekly.</code></td></tr><tr><td>events_amount</td><td>Integer</td><td>Specifies the maximum number of significant events to be reviewed for each symbol. The value can range between 1 and 10, with a default of 5.</td></tr></tbody></table>

{% tabs %}
{% tab title="200: OK Success" %}
On success, returns the briefs for the symbols provided.

```json
{
    "data": {
        "non_supported_input_symbols": "list [string]", // Strings list containing non supported input symbols
        "briefs": [{ // A list of symbols briefs
                "brief": "string", // The brief for the symbol
                "symbol": "string" // The symbol that is briefed
        }],
        "summary": "string" // Summarized brief for all symbols
    },
    "request_id": "YOUR_REQUEST_ID",
    "result": "success"
}
```

**Example**

For the request:&#x20;

`https://api.main.finalle.ai/symbols_brief?symbols=MSFT,TSLA,AAPL&period=weekly`

The output is:

```json
{
    "data": {
        "briefs": [
            {
                "brief": "* MSFT 5 days price change: +1.43%\n* Copilot Evolution aims to enhance user experience by becoming all-knowing assistant.\n* EU accuses Microsoft of antitrust breach over Teams integration with Office.\n* CERT-In warns of Microsoft Edge vulnerabilities, advises upgrading to latest version.\n* MSFT invests $1.5B in G42, boosting US-Middle East relations strategically.\n* Nvidia briefly surpasses Microsoft in market value due to AI dominance.",
                "symbol": "MSFT"
            },
            {
                "brief": "* TSLA 5 days price change: +6.62%\n* Stifel starts bullish on Tesla with 'buy' rating and $265 target.\n* Tesla's Q2 deliveries to fall 4% below estimates, 'Buy' rating maintained.\n* Tesla's legal battle over CEO pay raises stock volatility and investor concerns.\n* Tesla recalls 11,688 Cybertrucks for faulty wiper motors affecting driver visibility.\n* Tesla fights in court to uphold $56B compensation package for Musk.",
                "symbol": "TSLA"
            },
            {
                "brief": "* AAPL 5 days price change: +1.19%\n* Apple's stock surged post Rosenblatt's Buy upgrade due to AI technology.\n* iOS 18 Beta 2 introduces iPhone Mirroring, SharePlay for Mac, and more.\n* iPhone 16 series to feature vertical camera, haptic button, and larger display.\n* EU accuses Apple of breaching competition rules with App Store policies.\n* Apple in talks with Meta to integrate generative AI for enhanced capabilities.",
                "symbol": "AAPL"
            }
        ],
        "non_supported_input_symbols": [],
        "summary": "Last week, GDP growth rate for Q1 came in at 1.4%, slightly below the 2.6% estimated PCE Price Index YoY for May. Looking ahead, key events include Inflation Rate YoY, CPI, and Initial Jobless Claims for June, with estimates of 3.1%, 314.3, and 0.3 respectively, along with Fed Chair Powell's Testimony. The 5 days change for S&P 500 index is +0.10%, whereas Nasdaq index experienced a +1.95% change.\n\nIn recent news, Microsoft has been focused on evolving its AI capabilities with Copilot, aiming to provide users with a comprehensive personal assistant. However, the company is also facing antitrust accusations from the European Union regarding the integration of Teams with its Office suite. On the security front, Microsoft has issued alerts about vulnerabilities in its Edge browser, urging users to update to the latest version. Meanwhile, Tesla has been in the spotlight with Stifel initiating coverage with a 'buy' rating, although Q2 vehicle deliveries are expected to fall short of estimates. The company is also dealing with a legal dispute over CEO Elon Musk's compensation package and a recall of Cybertruck vehicles due to a wiper issue. Lastly, Apple has seen its stock rise following an upgrade from Rosenblatt Securities and has unveiled new iOS updates. However, the company is also facing scrutiny from the EU over its App Store policies and has delayed the rollout of its Apple Intelligence feature in the region."
    },
    "request_id": "YOUR_REQUEST_ID",
    "result": "success"
}
```

{% endtab %}

{% tab title="400: Bad Request Bad Input" %}
Invalid values were supplied for the API request.

**Example:**

For the request:&#x20;

```
https://api.main.finalle.ai/symbols_brief
```

The output will have 400 response status code with the following response:

```json
{
    "result": "fail",
    "error": "Bad request: Bad argument 'symbols' provided: None. Must be non-empty",
    "request_id": "YOUR_REQUEST_ID"
}
```

{% endtab %}

{% tab title="401: Unauthorized Authorization Invalid" %}
The API key supplied for the API request is invalid.

**Example:**

For the request:&#x20;

```
https://api.main.finalle.ai/symbols_brief?symbols=TSLA
```

With the following header:

```json
{  
    "X-API-Key": "SOME_INVALID_API_KEY"
}
```

The output will have 401 response status code with the following response:

```json
{
    "result": "fail",
    "error": "Unauthorized api key: SOME_INVALID_API_KEY",
    "request_id": "YOUR_UNIQUE_REQUEST_ID"
}
```

{% endtab %}

{% tab title="500: Internal Server Error Interval Server Error" %}
Something went wrong on our server.

The output will have 500 response status code with the following response:

```json
{
    "result": "fail",
    "error": "Internal Server Error",
    "request_id": "YOUR_UNIQUE_REQUEST_ID"
}
```

{% endtab %}
{% endtabs %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://api-docs.finalle.ai/endpoints/symbols-brief.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.