Skip to main content



The OpenBB Terminal is a Command Line Interface (CLI) application. Functions (commands) are called through the keyboard with results returned as charts, tables, or text. Charts and tables (if enabled) are displayed in a new window, and are fully interactive, while text prints directly to the Terminal screen. Commands are grouped into menus, with a menu or sub-menu being visually distinguishable from a function by the, >, on the far left of the screen. The color of the text can be altered under the /settings menu.

Navigating through the Terminal menus is similar to following down a path, or traversing folders from any operating system's command line prompt. The /home screen is the main path where everything begins, and the menus are paths branched from the main. Instead of C:\Users\OpenBB\Documents, it is, /stocks/options. Instead of, cd .., two periods - .. - returns to the menu one level back towards the home screen.


Absolute paths are also valid to-and-from any point. From the /stocks/options menu, go directly to /crypto. By itself, /, returns to the home level.

The Home Screen

Auto Complete

The OpenBB Terminal is equipped with an auto completion engine that presents choices based on the current menu. Whenever you start typing, the prompt will appear. When the function contains arguments, pressing the space bar after typing the command will present the list of available arguments. This functionality dramatically reduces the number of key strokes required to perform tasks and, in many cases, eliminates the need to consult the help dialogue for reminders. Choices - where they are bound by a defined list - are searchable with the up and down arrow keys.

Auto Complete

Help Dialogues

-h or --help

A help dialogue for any function at the current location is printed to the screen by typing -h after the command. The information returned contains a short description of the function and all accepted arguments. For an example, the /news function:

news -h
usage: news [-t TERM [TERM ...]] [-s SOURCES] [-h] [--export EXPORT] [--sheet-name SHEET_NAME [SHEET_NAME ...]] [-l LIMIT]

display news articles based on term and data sources

-t TERM [TERM ...], --term TERM [TERM ...]
search for a term on the news
-s SOURCES, --sources SOURCES
sources from where to get news from (separated by comma)
-h, --help show this help message
--export EXPORT Export raw data into csv, json, xlsx
--sheet-name SHEET_NAME [SHEET_NAME ...]
Name of excel sheet to save data to. Only valid for .xlsx files.
-l LIMIT, --limit LIMIT
Number of entries to show in data.

For more information and examples, use 'about news' to access the related guide.

To search for news containing the term, "Federal Reserve", try this command:

/news --term Federal Reserve


about is a global function that opens a browser to the OpenBB documentation pages at the specific command or menu.

/about stocks

The command above will open a browser to Introduction to the Stocks menu.


support is a global function for submitting a new request for support, a general question, or a bug report. The command will pre-populate a form with key information, like the command or menu name specific to the issue. Use the up and down arrow keys to browse and select the appropriate item for the ticket. Naturally, this command has a help dialogue.

support -h
Submit your support request

-c {search,load,quote,tob,candle,news,resources,codes,ta,ba,qa,disc,dps,scr,sia,ins,gov,res,dd,fa,bt,ca,options,th,forecast}, --command {generic,search,load,quote,tob,candle,news,resources,codes,ta,ba,qa,disc,dps,scr,sia,ins,gov,res,dd,fa,bt,ca,options,th,forecast}
Command that needs support (default: None)
--msg MSG [MSG ...], -m MSG [MSG ...]
Message to send. Enclose it with double quotes (default: )
--type {bug,suggestion,question,generic}, -t {bug,suggestion,question,generic}
Support ticket type (default: generic)
-h, --help show this help message (default: False)


support search --type question --msg "How do I find stocks from India with OpenBB?"

Support Auto Complete

The command opens a browser window to a pre-populated form on the OpenBB website. If you are signed-in to the Hub, all that is left to do is click Submit.

Submit Form

An answer to this question is: search --country india --exchange-country india


Tips for submitting a support request:

  • Tell us what version number is installed.
  • Tell us what operating system and version the machine has.
  • What is the installation type? Installer, Source, PyPi, Docker, other?
  • Tell us the command and parameter combination causing the error.
  • Tell us what symbol (ticker) is, or was trying to be, loaded.
  • Show us the complete error message.
  • Let us know any contextual information that will help us replicate and accurately identify the problem.

The Main Menu

The main menu, or the home screen, contains both menus and commands. Some of these commands are global, meaning they can be called from any location within the OpenBB Terminal. Refer to the in-depth introduction guides for each menu, for example, Forecast

Function KeyTypeIs Global?Description
aboutFunctionYesOpens a browser page to the documentation pages at the function or menu.
accountMenu-Manage your OpenBB account.
alternativeMenu-Alternative data sets.
cryptoMenu-Digital assets.
econometricsMenu-Econometrics and custom data sets.
economyMenu-The broad economy.
etfMenu-Exchange-Traded Funds.
exeFunctionNoExecute OpenBB Routine Scripts.
featflagsMenu-Enable/disable Terminal behaviours.
fixedincomeMenu-Central Bank and corporate bond rates and indexes.
forecastMenu-Time series forecasting and machine learning.
forexMenu-Currency pairs.
fundsMenu-Mutual funds.
futuresMenu-Commodity and financial futures.
keysMenu-Set and test API keys for data sources.
introFunctionNoAn in-Terminal introduction.
newsFunctionNoFind news articles by term and source.
portfolioMenu-Portfolio and risk analysis.
recordFunctionYesStarts recording an OpenBB Routine Script.
settingsMenu-Adjust Terminal settings.
sourcesMenu-Set preferred default sources.
stopFunctionYesStop recording the OpenBB Routine Script and save to the OpenBBUserData folder.
supportFunctionYesReport a bug or create a support ticket with OpenBB.
surveyFunctionNoTake a short user survey to help us improve.
updateFunctionNoAttempt to update (Only for Github cloned repository installations)
wikiFunctionYesQuery the Wikipedia API for a term or phrase.

Additional Global Commands

The commands listed below are not displayed on any Terminal menu, but are available from any location in the Terminal.

Function KeyDescription
clsClears the Terminal screen.
exitQuits the Terminal.
help, h, ?Prints the current menu screen.
quit, q, ..Navigates back one menu towards Home.
reset, rResets the Terminal, opening to the current menu.


Many functions will require obtaining (free or subscription) API keys from various data providers. OpenBB provides methods for consuming these data feeds, but has no control over the quality or quantity of data provided to an end-user. No API Keys are required to get started using the Terminal. See the list of data providers here, along with instructions for entering the credentials into the OpenBB Terminal. Request a feature to let us know what we are missing!

Default Data Sources

The default data source for each function (where multiple sources are available) can be defined within the /sources menu. The available sources for each function are displayed on the right of the menu, and they can be distinguished by the square brackets and distinct font color group. Unless a preference for a particular function is defined, the command will prioritize in the order they are displayed, from left-to-right, on the Terminal screen. To override a preference or default source, select one of the other choices by attaching the, --source, argument to the command syntax. The available sources for the feature will be populated by auto complete when the space bar is pressed after typing --source. This information is also printed with the --help dialogue of a command.

/stocks/load AAPL/fa/income --source Polygon

Selecting a new Data Source

Importing and Exporting Data

Most functions provide a method for exporting the raw data as a CSV, JSON, or XLSX file (with a specific sheet name). Exported data and user-supplied files to import are saved to the OpenBBUserData folder. The folder is located at the root of the operating system's User Account folder. Follow the link for a detailed description.


The OpenBB charting library provides interactive, customizable, charts. Here's an example of displaying weekly candles for AAPL.

/stocks/load AAPL -w/candle

Apple Weekly Chart


The toolbar is located at the bottom of the window, and provides methods for:

  • Panning and zooming.
  • Modifying the title and axis labels.
  • Adjusting the hover read out.
  • Toggling light/dark mode.
  • Annotating and drawing.
  • Exporting raw data.
  • Saving the chart as an image.
  • Adding supplementary external data as an overlay.

The label for each tool is displayed by holding the mouse over it.

Chart Tools

Toggle the toolbar's visibility via the keyboard with, ctrl + h.

Text Tools

Annotate a chart by clicking on the Add Text button, or with the keyboard, ctrl + t.

Annotate Charts

Enter some text, make any adjustments to the options, then submit. Place the crosshairs over the desired data point and click to place the text.

Place Text

After placement, the text can be updated or deleted by clicking on it again.

Delete Annotation

The title of the chart is edited by clicking the button, Change Titles, near the middle center of the toolbar, immediately to the right of the Add Text button.

Draw Tools

The fourth group of icons on the toolbar are for drawing lines and shapes.

  • Edit the colors.
  • Draw a straight line.
  • Draw a freeform line.
  • Draw a circle.
  • Draw a rectangle.
  • Erase a shape.

To draw on the chart, select one of the four drawing buttons and drag the mouse over the desired area. Click on any existing shape to modify it by dragging with the mouse and editing the color, or remove it by clicking the toolbar button, Erase Active Shape. The edit colors button will pop up as a floating icon, and clicking on that will display the color palette.

Edit Colors

Export Tools

The two buttons at the far-right of the toolbar are for saving the raw data or, to save an image file of the chart at the current panned and zoomed view.

Export Tools


The button, Overlay chart from CSV, provides an easy import method for supplementing a chart with additional data. Clicking on the button opens a pop-up dialogue to select the file, column, and whether the overlay should be a bar, candlestick, or line chart. As a candlestick, the CSV file must contain OHLC data. The import window can also be opened with the keyboard, ctrl-o.

Overlay CSV

After choosing the file to overlay, select what to show and then click on Submit.

Overlay Options

Overlay Chart

Cheat Sheet

The image below can be saved and used as a reference.

Group 653


The OpenBB Terminal sports interactive tables which opens in a separate window. They provide methods for searching, sorting, filtering, and exporting directly within the table. Preferences and settings for the tables can be updated directly on the table.

Sorting and Filtering

Columns can be sorted ascending/descending/unsorted, by clicking the controls to the right of each header title. The status of the filtering is shown as a blue indicator.

Sort Columns

The settings button, at the lower-left corner, displays choices for customizing the table. By selecting the Type to be Advanced, columns become filterable.

Table Settings

The columns can be filtered with min/max values or by letters, depending on the content of each column.

Filtered Tables

Selecting Columns and Rows

The table will scroll to the right as far as there are columns. Columns can be removed from the table by clicking the icon to the right of the settings button and unchecking it from the list.

Select Columns

The number of rows per page is defined in the drop down selection near the center, at the bottom.

Rows per Page

Freeze the Index and Column Headers

Right-click on the index name to enable/disable freezing when scrolling to the right. Column headers are frozen by default.

Index Freeze

Exporting Data

At the bottom-right corner of the table window, there is a button for exporting the data. To the left, the drop down selection for Type can be defined as a CSV, XLSX, or PNG file. Exporting the table as a PNG file will create a screenshot of the table at its current view, and data that is not on the screen will not be captured.

Export Data

Cheat Sheet

The image below can be saved and used as a reference.

Chart Intro (5)