Files
OpenBB/website/content/terminal/reference/stocks/fa/earnings.md
DidierRLopes 4ad995fdd0 Docs/terminalpro and improvement (#5622)
* add first iteration of content for Terminal Pro

* Update index.md

* Update dashboards.md

* Update folders.md

* Update grouping.md

* Update report.md

* Update templates.md

* Update quick-start.md

* Update index.md

* Update index.md

* Update home.md

* Update news.md

* Update index.md

* Update index.md

* Update index.md

* Update data-provider.md

* Update chat-with-widget.md

* Update data-manipulation.md

* Update forecasting.md

* fix: images self closing tags

* fix: only pro visitors can see pro

* inter font

* improve SEO content and restructuring

* add new package for toggle on tutorials

* move folder around

* improve main page of each prod

* small updates and improvements

* fix logo above

* small improvement in headtitle for portfolio funcs

* fix typos from OpenAI's GPT-4

* fix _category_ json

* remove generic SEO words

* add script that generates SEO for documentation

* add missing file

* remove sdk warning message

* fix links for andrew

---------

Co-authored-by: jose-donato <zmcdonato@gmail.com>
Co-authored-by: jose-donato <43375532+jose-donato@users.noreply.github.com>
Co-authored-by: andrewkenreich <andrew.kenreich@gmail.com>
2023-10-30 21:01:29 +00:00

104 lines
8.9 KiB
Markdown
Vendored

---
title: earnings
description: This page provides documentation for the 'earnings' function. This tool
prints earnings dates and reported EPS of a company, enabling users to efficiently
track this financial data in a clear format.
keywords:
- docusaurus
- metadata
- earnings
- financial data
- EPS
- parameter
- example
---
import HeadTitle from '@site/src/components/General/HeadTitle.tsx';
<HeadTitle title="stocks/fa/earnings - Reference | OpenBB Terminal Docs" />
Print earnings dates and reported EPS of the company. The following fields are expected: Fiscal Date Ending and Reported EPS. [Source: Alpha Vantage]
### Usage
```python
earnings [-q] [-l LIMIT]
```
---
## Parameters
| Name | Description | Default | Optional | Choices |
| ---- | ----------- | ------- | -------- | ------- |
| b_quarter | Quarter fundamental data flag. | False | True | None |
| limit | Number of latest info | 5 | True | None |
---
## Examples
```python
2022 Feb 16, 05:14 (🦋) /stocks/fa/ $ earnings -l 12
MSFT Earnings
┏━━━━━━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━┓
┃ Fiscal Date Ending ┃ Reported EPS ┃
┡━━━━━━━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━┩
│ 2021-12-31 │ 4.75 │
├────────────────────┼──────────────┤
│ 2021-06-30 │ 7.97 │
├────────────────────┼──────────────┤
│ 2020-06-30 │ 5.75 │
├────────────────────┼──────────────┤
│ 2019-06-30 │ 4.75 │
├────────────────────┼──────────────┤
│ 2018-06-30 │ 3.88 │
├────────────────────┼──────────────┤
│ 2017-06-30 │ 3.31 │
├────────────────────┼──────────────┤
│ 2016-06-30 │ 2.76 │
├────────────────────┼──────────────┤
│ 2015-06-30 │ 2.46 │
├────────────────────┼──────────────┤
│ 2014-06-30 │ 2.63 │
├────────────────────┼──────────────┤
│ 2013-06-30 │ 2.67 │
├────────────────────┼──────────────┤
│ 2012-06-30 │ 2.73 │
├────────────────────┼──────────────┤
│ 2011-06-30 │ 2.69 │
└────────────────────┴──────────────┘
2022 Feb 16, 05:15 (🦋) /stocks/fa/ $ earnings -l 12 -q
MSFT Earnings
┏━━━━━━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━┳━━━━━━━━━━┳━━━━━━━━━━━━━━━━━━━━━┓
┃ Fiscal Date Ending ┃ Reported Date ┃ Reported EPS ┃ Estimated EPS ┃ Surprise ┃ Surprise Percentage ┃
┡━━━━━━━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━━╇━━━━━━━━━━╇━━━━━━━━━━━━━━━━━━━━━┩
│ 2021-12-31 │ 2022-01-25 │ 2.48 │ 2.31 │ 0.17 │ 7.3593 │
├────────────────────┼───────────────┼──────────────┼───────────────┼──────────┼─────────────────────┤
│ 2021-09-30 │ 2021-10-26 │ 2.27 │ 2.081 │ 0.189 │ 9.0822 │
├────────────────────┼───────────────┼──────────────┼───────────────┼──────────┼─────────────────────┤
│ 2021-06-30 │ 2021-07-27 │ 2.17 │ 1.9252 │ 0.2448 │ 12.7156 │
├────────────────────┼───────────────┼──────────────┼───────────────┼──────────┼─────────────────────┤
│ 2021-03-31 │ 2021-04-27 │ 1.95 │ 1.7781 │ 0.1719 │ 9.6676 │
├────────────────────┼───────────────┼──────────────┼───────────────┼──────────┼─────────────────────┤
│ 2020-12-31 │ 2021-01-26 │ 2.03 │ 1.6373 │ 0.3927 │ 23.9846 │
├────────────────────┼───────────────┼──────────────┼───────────────┼──────────┼─────────────────────┤
│ 2020-09-30 │ 2020-10-27 │ 1.82 │ 1.546 │ 0.274 │ 17.7232 │
├────────────────────┼───────────────┼──────────────┼───────────────┼──────────┼─────────────────────┤
│ 2020-06-30 │ 2020-07-22 │ 1.46 │ 1.372 │ 0.088 │ 6.414 │
├────────────────────┼───────────────┼──────────────┼───────────────┼──────────┼─────────────────────┤
│ 2020-03-31 │ 2020-04-29 │ 1.4 │ 1.2688 │ 0.1312 │ 10.3405 │
├────────────────────┼───────────────┼──────────────┼───────────────┼──────────┼─────────────────────┤
│ 2019-12-31 │ 2020-01-29 │ 1.51 │ 1.325 │ 0.185 │ 13.9623 │
├────────────────────┼───────────────┼──────────────┼───────────────┼──────────┼─────────────────────┤
│ 2019-09-30 │ 2019-10-23 │ 1.38 │ 1.2435 │ 0.1365 │ 10.9771 │
├────────────────────┼───────────────┼──────────────┼───────────────┼──────────┼─────────────────────┤
│ 2019-06-30 │ 2019-07-18 │ 1.37 │ 1.2137 │ 0.1563 │ 12.878 │
├────────────────────┼───────────────┼──────────────┼───────────────┼──────────┼─────────────────────┤
│ 2019-03-31 │ 2019-04-24 │ 1.14 │ 0.9985 │ 0.1415 │ 14.1713 │
└────────────────────┴───────────────┴──────────────┴───────────────┴──────────┴─────────────────────┘
```
---