Custom Backend

This is a versatile way to connect any data to the OpenBB Terminal. Whether your API is hosted internally or externally, this method provides a standardized structure that OpenBB Terminal Pro widgets can render.

Design and implement your API: Choose your preferred programming language and framework. Ensure that the API can return data in JSON format, which is required for widget integration.

note

Guidelines for JSON Format:

The JSON data should be in a flat structure, meaning that there should be no nested dictionaries or arrays within the individual objects.
Each object should contain key-value pairs where the values are simple data types (e.g., strings, numbers, booleans).
Avoid nesting other objects or arrays inside any of the values. The JSON should resemble the following structure:

Example JSON

[
  {
    "title": "To Kill a Mockingbird",
    "author": "Harper Lee",
    "year": 1960,
    "genre": "Fiction"
  },
  {
    "title": "1984",
    "author": "George Orwell",
    "year": 1949,
    "genre": "Dystopian"
  },
  {
    "title": "The Great Gatsby",
    "author": "F. Scott Fitzgerald",
    "year": 1925,
    "genre": "Classic"
  }
]

Create widgets.json file: This file is your main configuration and defines widget properties such as name, description, category, endpoint, and other information. Each widget will be defined in this file. To view a sample widgets.json file and learn more about what you can do check out the widgets.json docs.

An example structure in your backend might look like below.

  backend/
  ├── main.py
  └── widgets.json

Create endpoints for each widgets.json entry: Your widgets.json file lets OpenBB Terminal know how to display the data but you need to build out the endpoint to supply the data for each widget. Following the structure above, these endpoints would live in the main.py file.
Connect to your API: Once your API is up and running, you can add the custom backend using the OpenBB Terminal Pro interface. You will need to input your main endpoint and the system will read the /widgets.json endpoint to fetch all the necessary settings and configurations. Once connected, all the widgets will appear in your search and ready to be added to any dashboard.

Examples

Our team has created several examples that you can use to quickly get started with Python and FastAPI. For more information, check this open source repository for examples.

Examples​

Examples