Skip to content

Commit

Permalink
Merge pull request OpenBB-finance#5436 from OpenBB-finance/hotfix/rea…
Browse files Browse the repository at this point in the history
…dme-title

Hotfix/readme title
jmaslek authored Sep 12, 2023
2 parents 63718d9 + 78ffe19 commit a4e04a1
Showing 4 changed files with 78 additions and 57 deletions.
63 changes: 25 additions & 38 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,57 +1,44 @@
<!-- PROJECT SHIELDS -->
<!--
*** I'm using markdown "reference style" links for readability.
*** Reference links are enclosed in brackets [ ] instead of parentheses ( ).
*** See the bottom of this document for the declaration of the reference variables
*** for contributors-url, forks-url, etc. This is an optional, concise syntax you may use.
*** https://www.markdownguide.org/basic-syntax/#reference-style-links
-->

[![Stargazers][stars-shield]][stars-url]
[![Forks][forks-shield]][forks-url]
[![Contributors][contributors-shield]][contributors-url]
[![MIT License][license-shield]][license-url]

[![Issues][issues-shield]][issues-url]
[![Bugs Open][bugs-open-shield]][bugs-open-url]
[![Bugs Closed][bugs-closed-shield]][bugs-closed-url]
<br />
<img src="https://github.com/OpenBB-finance/OpenBBTerminal/blob/main/images/openbb-logo-dark.svg?raw=true#gh-light-mode-only" alt="OpenBB Terminal logo" width="600">
<img src="https://github.com/OpenBB-finance/OpenBBTerminal/blob/main/images/openbb-logo-light.svg?raw=true#gh-dark-mode-only" alt="OpenBB Terminal logo" width="600">
<br />
<br />

[![Twitter](https://img.shields.io/twitter/url/https/twitter.com/openbb_finance.svg?style=social&label=Follow%20%40openbb_finance)](https://twitter.com/openbb_finance)
[![GitHub release](https://img.shields.io/github/release/OpenBB-finance/OpenBBTerminal.svg?maxAge=3600)](https://github.com/OpenBB-finance/OpenBBTerminal/releases)
[![Code style: black](https://img.shields.io/badge/code%20style-black-000000.svg)](https://github.com/psf/black)
[![TODOs](https://badgen.net/https/api.tickgit.com/badgen/github.com/OpenBB-finance/OpenBBTerminal/main)](https://www.tickgit.com/browse?repo=github.com/OpenBB-finance/OpenBBTerminal&branch=main)

![Discord Shield](https://discordapp.com/api/guilds/831165782750789672/widget.png?style=shield)
[![Twitter](https://img.shields.io/twitter/url/https/twitter.com/openbb_finance.svg?style=social&label=Follow%20%40openbb_finance)](https://twitter.com/openbb_finance)

[![Open in Dev Containers](https://img.shields.io/static/v1?label=Dev%20Containers&message=Open&color=blue&logo=visualstudiocode)](https://vscode.dev/redirect?url=vscode://ms-vscode-remote.remote-containers/cloneInVolume?url=https://github.com/OpenBB-finance/OpenBBTerminal)
<a href="https://codespaces.new/OpenBB-finance/OpenBBTerminal">
<img src="https://github.com/codespaces/badge.svg" height="20" />
</a>

[![Open in GitHub Codespaces](https://github.com/codespaces/badge.svg)](https://codespaces.new/OpenBB-finance/OpenBBTerminal)

<!-- PROJECT LOGO -->

| OpenBB is committed to build the future of investment research by focusing on an open source infrastructure accessible to everyone, everywhere. |
|:--:|
| [![openbb.jpg](/images/openbb_gradient.png)](https://openbb.co) |
| Check our website at [openbb.co](https://openbb.co) |

<br />
OpenBB is committed to building the future of investment research by focusing on an open-source infrastructure accessible to everyone, everywhere.

<p align="center">
<h3 align="center">OpenBB Terminal 🚀</h3>
<h4 align="center">Documentation can be found at: https://openbb.co/docs </h4>
<p align="center">Click on the GIF below for a DEMO of the terminal.</p>

<p align="center">
<a href="https://www.youtube.com/watch?v=fqGPK8OVHLk" rel="OpenBB Terminal Demo">
<img src="images/openbb_terminal_illustration.gif" alt="OpenBB Terminal Illustration" width="100%"/>
</a>
<p align="center">Click on the GIF above for a DEMO</p>
</p>

<p align="center">
<a href="https://docs.openbb.co/terminal/installation"><strong>≪ GETTING STARTED</strong></a>
&nbsp · &nbsp <a href="https://github.com/OpenBB-finance/OpenBBTerminal/tree/master/CONTRIBUTING.md"><strong>CONTRIBUTING</strong></a> &nbsp · &nbsp
<a href="https://docs.openbb.co/terminal/installation">
<strong>≪ GETTING STARTED</strong>
</a>
&nbsp · &nbsp
<a href="https://github.com/OpenBB-finance/OpenBBTerminal/tree/master/CONTRIBUTING.md">
<strong>CONTRIBUTING</strong>
</a>
&nbsp · &nbsp
<a href="https://openbb.co/docs">
<strong>DOCUMENTATION</strong>
</a>
&nbsp · &nbsp
<a href="https://docs.openbb.co/terminal">
<strong>SEE FEATURES »</strong></a>
<strong>SEE FEATURES »</strong>
</a>
</p>
</p>

17 changes: 17 additions & 0 deletions images/openbb-logo-dark.svg
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
17 changes: 17 additions & 0 deletions images/openbb-logo-light.svg
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
38 changes: 19 additions & 19 deletions website/content/sdk/usage/basics/index.md
Original file line number Diff line number Diff line change
@@ -28,7 +28,7 @@ The `obb` virtual environment has both `python` and `ipython` as methods for sta
If this doesn't work, there may be an obvious reason why.

- The installation was not completed.
- The terminal being used is different than the one which was used for installation. For example, Miniconda was installed using `CMD.exe` or `Anaconda Prompt`, but the current terminal is PowerShell.
- The terminal being used is different from the one which was used for installation. For example, Miniconda was installed using `CMD.exe` or `Anaconda Prompt`, but the current terminal is PowerShell.

Open the same terminal used for installation and activate the `obb` environment, then enter:

@@ -134,19 +134,19 @@ from openbb_terminal.sdk import openbb

## Navigation

The layout of the OpenBB SDK is similar to the menus in the OpenBB Terminal, with each one represented as a module. Instead of a `/` in the path, it is `.`. For example, `openbb.stocks.gov` is the Government sub-module of `stocks`.
The layout of the OpenBB SDK is similar to the menus in the OpenBB Terminal, with each one represented as a module. Instead of a `/` in the path, it is `.`. For example, `openbb.stocks.gov` is the Government submodule of `stocks`.

![Navigation](https://github.com/OpenBB-finance/OpenBBTerminal/assets/85772166/ad3617fe-b84c-4bbd-9139-2563702849ba)

The attributes for each module - and docstrings for a function - can also be printed directly to the screen, insert a question mark at the end of the string.

```python
```jupyterpython
openbb.stocks.gov.contracts?
```

**Note**: For a regular `python` session, the syntax is: `help(openbb.stocks.gov.contracts)`

```python
```
Signature: openbb.stocks.gov.contracts(symbol: str, past_transaction_days: int = 10) -> pandas.core.frame.DataFrame
Call signature: openbb.stocks.gov.contracts(*args: Any, **kwargs: Any) -> Any
Type: get_contracts
@@ -190,11 +190,11 @@ API keys can be imported to the session by logging in to an [OpenBB Hub account]

Copy the generated token and enter as the value for the `token` parameter, ignoring the email and password fields. By default, the credentials will be forgotten when the SDK session is terminated.

```python
```jupyterpython
openbb.login?
```

```python
```
Signature:
openbb.login(
email: str = '',
@@ -226,7 +226,7 @@ silent : bool
Examples
--------
>>> from openbb_terminal.sdk import openbb
>>> openbb.login(email="your_email", password="your_password")
>>> openbb.login(email="<your email>", password="<your password>")
File: ~/GitHub/OpenBBTerminal/openbb_terminal/core/session/sdk_session.py
Type: function
```
@@ -258,7 +258,7 @@ The majority of parameters accept a string as the input. The docstrings will de
- `openbb.stocks.quote(["SPY", "QQQ", "IWM", "AAPL", "MSFT", "TSLA", "GOOG", "META", "AMZN"])`
- Dates are entered as a string, and follow the format: "YYYY-MM-DD".
- `openbb.stocks.load("SPY", start_date="1994-01-01")`
- When the expected input of a parameter is an integer or float value, they are enertered without quotes.
- When the expected input of a parameter is an integer or float value, they are entered without quotes.
- `limit = 10`
- Boolean arguments are always capitalized.
- True
@@ -315,22 +315,22 @@ max_returns

| | Date | Returns |
|:-----|:--------------------|----------:|
| GSIT | 2023-05-12 00:00:00 | 2.10366 |
| WISA | 2023-03-27 00:00:00 | 0.894737 |
| LMFA | 2023-05-15 00:00:00 | 0.399731 |
| GSIT | 2023-05-12 00:00:00 | 2.10366 |
| WISA | 2023-03-27 00:00:00 | 0.894737 |
| LMFA | 2023-05-15 00:00:00 | 0.399731 |
| OKE | 2023-05-05 00:00:00 | 0.0300176 |
| GETR | 2023-05-12 00:00:00 | 0.450151 |
| MMP | 2023-05-15 00:00:00 | 0.12994 |
| ORMP | 2023-05-15 00:00:00 | 0.106007 |
| MGOL | 2023-03-28 00:00:00 | 0.322957 |
| TIVC | 2023-01-12 00:00:00 | 0.19 |
| REAL | 2023-05-08 00:00:00 | 0.191304 |
| GETR | 2023-05-12 00:00:00 | 0.450151 |
| MMP | 2023-05-15 00:00:00 | 0.12994 |
| ORMP | 2023-05-15 00:00:00 | 0.106007 |
| MGOL | 2023-03-28 00:00:00 | 0.322957 |
| TIVC | 2023-01-12 00:00:00 | 0.19 |
| REAL | 2023-05-08 00:00:00 | 0.191304 |

### OpenBB Figure Objects

Functions returning a chart will have a boolean argument labeled, `external_axes`. When this is set as `True`, and the function's output is assigned to a variable, a Plotly figure object is returned, which can be manipulated accordingly. Copy the block below to see all of the parameters that can be set.
Functions returning a chart will have a boolean argument labeled, `external_axes`. When this is set as `True`, and the function's output is assigned to a variable, a Plotly figure object is returned, which can be manipulated accordingly. Copy the block below to see all the parameters that can be set.

```python
```jupyterpython
data = openbb.stocks.candle("SPY", external_axes = True)
data?
```

0 comments on commit a4e04a1

Please sign in to comment.