Skip to main content

Open Source Platform Integration

This section will highlight how you can run the OpenBB Platform locally and integrate 350+ different datasets into the OpenBB Terminal in under 5 minutes.

If you want to learn more about the open source platform, check our documentation.

Connecting Platform API to Terminal

Here's a video that you can use to follow step-by-step instructions.

The steps are also described below:

  1. Download the OpenBB Platform Installer which can be found here.

image-d07ef45c946c1daf95e8619d6a49fb18

Select the right installer based on your OS and architecture. Then install it.

  1. Once installation is complete, find the OpenBB folder that has been created in the installation directory selected. Double click on OpenBB/openbb-api.

image-2-e88086c0317861808057d4dcbd47f93d

  1. A terminal popup should be initiated, and you will be prompted to insert your personal access token (PAT), which can be retrieved from here.

image

Note: This assumes that the user has spent time setting up their API keys here.

image

  1. The OpenBB Platform API should now be up and running.

image-3-89f316d9153aa91e108cebf5cf718609

  1. Finally, you simply need to set up the custom backend on Terminal Pro.
note

If you are using Brave/Safari you will need an HTTPS connection - see how here

image-4-bed5df262173615690d113584755b08a

img

  1. Voila. You are now ready to access 350+ data widgets from your OpenBB Terminal. For free.

image

Advanced - Filter widgets

If you run the steps above, you will have access to a dozen different data vendors and hundreds of different widgets. However, some of these may not work because you haven't set up the API key for the data vendor or you may not be interested to bring some of those widgets into your OpenBB Terminal.

This section will explore how you can filter the platform integration datasets that are made available on the Terminal.

  1. Go to the widgets filter page where you can set the data vendors you are interested and also select the widgets within. Once you are happy you can download the widget_settings.json configuration file by clicking on Download.

image-1-0e1a24b94a7c6ea08d41e30b53f8dc57

  1. In the OpenBB folder that has been created when you installed the Platform. There must be a Settings folder within. This folder should be the destination of your widget setttings file (widget_settings.json), which will serve as the configuration file for your custom backend.

Now, similarly to the previous section, you should:

  • Run OpenBB/openbb-api
  • Set your PAT
  • Refresh the connection inside the "My Data" tab or follow instructions above to add again.

Take into consideration that, if you change the default configurations on the OpenBB Platform settings, the URL (http://127.0.0.1:6900) might differ.

image