API Keys
API (Application Programming Interface) keys are access credentials for obtaining data from a particular data vendor. They are a string of random characters assigned, by the data provider, to an individual account.
Setting API keys through Terminalβ
Most vendors offer a free tier requiring only a valid email address, some will require an account with proper KYC (Know Your Customer). Each source is entered into the Terminal from the /keys
menu with the syntax as described in the sections below. Adding the -h
argument to the command will also display the expected inputs. For example,
(π¦) /keys/ $ reddit -h
usage: reddit [-i CLIENT_ID] [-s CLIENT_SECRET] [-u USERNAME] [-p PASSWORD] [-a USER_AGENT [USER_AGENT ...]] [-h]
Set Reddit API key.
options:
-i CLIENT_ID, --id CLIENT_ID
Client ID (default: None)
-s CLIENT_SECRET, --secret CLIENT_SECRET
Client Secret (default: None)
-u USERNAME, --username USERNAME
Username (default: None)
-p PASSWORD, --password PASSWORD
Password (default: None)
-a USER_AGENT [USER_AGENT ...], --agent USER_AGENT [USER_AGENT ...]
User agent (default: None)
-h, --help show this help message (default: False)
In order to set the API key in the terminal, after obtaining the correct information from reddit, one would enter into the terminal:
(π¦) /keys/ $ reddit -i <YOUR-CLIENT-ID> -s <YOUR-CLIENT-SECRET> -u <USERNAME> -p <PASSWORD> -a <USER-AGENT>
A message similar to the one below will be printed when a function requesting data from an API is called but the key has not yet been entered.
(π¦) /stocks/fa/ $ rot
API_FINNHUB_KEY not defined. Set API Keys in ~/.openbb_terminal/.env or under keys menu.
The menu also provides a method for testing the validity of a key upon entry. It can be easy to copy & paste the string with a missing character; so, if the test fails, check that the values were correctly recorded with the command:
(π¦) /keys/ $ mykeys --show
OpenBB recommends users to gradually obtaining API keys from data vendors based on their needs.
In addition by accessing our data vendor affiliate program you can get discounts upon sign-up.
Supported data vendorsβ
This section covers all API keys listed above and include detailed instructions how to obtain each API key. By clicking on each name, the section will expand and instructions are provided.
AlphaVantageβ
Alpha Vantage provides enterprise-grade financial market data through a set of powerful and developer-friendly data APIs and spreadsheets. From traditional asset classes (e.g., stocks, ETFs, mutual funds) to economic indicators, from foreign exchange rates to commodities, from fundamental data to technical indicators, Alpha Vantage is your one-stop-shop for real-time and historical global market data delivered through cloud-based APIs, Excel, and Google Sheets.
Instructions
Go to: https://www.alphavantage.co/support/#api-key
Fill out the form, pass Captcha, and click on, "GET FREE API KEY". The issued key can be entered into the OpenBB Terminal with:
/keys/av REPLACE_WITH_KEY
Binanceβ
Binance cryptocurrency exchange - We operate the worlds biggest bitcoin exchange and altcoin crypto exchange in the world by volume
Instructions
Go to: https://www.binance.com/en/support/faq/how-to-create-api-360002502072
These instructions should provide clear guidance for obtaining an API Key. Enter the issued credentials into the OpenBB Terminal with:
/keys/binance -k REPLACE_WITH_KEY -s REPLACE_WITH_SECRET
Bitqueryβ
Bitquery is an API-first product company dedicated to power and solve blockchain data problems using the ground truth of on-chain data.
Instructions
Go to: https://bitquery.io/<
Click "Try GraphQL API", which opens the following screen:
After creating an account and verifying the email address, get the value for the key by clicking on the "API Key" tab.
Enter this API key into the OpenBB Terminal by typing:
/keys/bitquery REPLACE_WITH_KEY
BizTocβ
BizToc is the one-stop business and finance news hub, encapsulating the top 200 US news providers in real time.
Instructions
The BizToc API is hosted on RapidAPI. To set up, go to: https://rapidapi.com/thma/api/biztoc.
In the top right, select "Sign Up". After answering some questions, you will be prompted to select one of their plans.
After signing up, navigate back to https://rapidapi.com/thma/api/biztoc. If you are logged in, you will see a header called X-RapidAPI-Key.
Copy the key to the clipboard, and enter this key into the OpenBB Terminal with:
/keys/biztoc REPLACE_WITH_KEY
CoinMarketCapβ
CoinMarketCap is the world's most-referenced price-tracking website for cryptoassets in the rapidly growing cryptocurrency space. Its mission is to make crypto discoverable and efficient globally by empowering retail users with unbiased, high quality and accurate information for drawing their own informed conclusions.
Instructions
Go to: https://coinmarketcap.com/api
Click on, "Get Your Free API Key Now", which opens to the page:
Once the account has been created, copy the API key displayed within the dashboard.
Enter the API key into the OpenBB Terminal by typing:
/keys/cmc REPLACE_WITH_KEY
Coinbaseβ
Coinbase is a secure online platform for buying, selling, transferring, and storing cryptocurrency.
Instructions
Go to: https://help.coinbase.com/en/exchange/managing-my-account/how-to-create-an-api-key
Follow the instructions to obtain the credentials for the specific account. Enter the three values into the OpenBB Terminal by typing:
/keys/coinbase -k REPLACE_WITH_KEY -s REPLACE_WITH_SECRET -p REPLACE_WITH_PASSPHRASE
Coinglassβ
Coinglass is a cryptocurrency futures trading & information platform,where you can find the Bitcoin Liquidations ,Bitcoin open interest, Grayscale Bitcoin TrustοΌBitcoin longs vs shorts ratio and actively compare funding rates for crypto futures.Above all the quantities are shown as per their respective contract value.
Instructions
Go to: https://www.coinglass.com/
Click, "Log in", and then sign up for an account. This opens the page:
With the account created, find the assigned API key within the account profile page. Enter this value into the OpenBB Terminal by typing:
/keys/coinglass REPLACE_WITH_KEY
Crypto Panicβ
CryptoPanic is a news aggregator platform indicating impact on price and market for traders and cryptocurrency enthusiasts.
Instructions
Go to: https://cryptopanic.com/developers/api/
Click on, Sign up, and after creating, the API key will be displayed on the documentation page, "Your free API auth token".
Enter that value in the OpenBB Terminal by typing:
/keys/cpanic REPLACE_WITH_KEY
Databentoβ
Databento eliminates tens of thousands of dollars in upfront expenses per dataset without sacrificing data integrity. We give you the flexibility to pick up real-time full exchange feeds and terabytes of historical data, whenever you need it.
Instructions
Go to: https://docs.databento.com/getting-started
Click on, Sign up, and after creating an account, the API key is found in the account portal.
Enter this into the terminal with:
/keys/databento REPLACE_WITH_KEY
DEGIROβ
DEGIRO is Europe's fastest growing online stock broker. DEGIRO distinguishes itself from its competitors by offering extremely low trading commissions.
Instructions
Go to: https://www.degiro.com/
Click on, "Open an account", and then go through the registration process. After setting up the account, the login credentials can be entered in the OpenBB Terminal with:
/keys/degiro -u USERNAME -p PASSWORD
Instructions for setting up 2FA authorization are here.
EODHDβ
Historical End of Day, Intraday, and Live prices API, with Fundamental Financial data API for more than 120000 stocks, ETFs and funds all over the world.
Instructions
Go to: https://eodhistoricaldata.com/r/?ref=869U7F4J
Clicking on, "Registration", opens the page:
Once registered, the API Key will be next to "API TOKEN".
Enter this string into the OpenBB Terminal by typing:
/keys/eodhd REPLACE_WITH_KEY
Finnhubβ
With the sole mission of democratizing financial data, we are proud to offer a FREE realtime API for stocks, forex and cryptocurrency.
Instructions
Go to: https://finnhub.io/
Click on, "Get free api key", to open the page:
Once the account has been created, find the API key in the account dashboard.
Add this key to the OpenBB Terminal by entering:
/keys/finnhub REPLACE_WITH_KEY
Financial Modeling Prepβ
Enhance your application with our data that goes up to 30 years back in history. Earnings calendar, financial statements, multiple exchanges and more!
Instructions
Go to: https://site.financialmodelingprep.com/developer/docs
Click on, "Get my API KEY here", and sign up for a free account.
With an account created, sign in and navigate to the Dashboard, which shows the assigned token. by pressing the "Dashboard" button which will show the API key.
Enter the key into the OpenBB Terminal with:
/keys/fmp REPLACE_WITH_KEY
FREDβ
FRED is the trusted source for economic data since 1991. Download, graph, and track 819,000 US and international time series from 110 sources.
Instructions
Go to: https://fred.stlouisfed.org
Click on, "My Account", create a new account or sign in with Google:
After completing the sign-up, go to "My Account", and select "API Keys". Then, click on, "Request API Key".
Fill in the box for information about the use-case for FRED, and by clicking, "Request API key", at the bottom of the page, the API key will be issued.
Enter the API key into the OpenBB Terminal with:
/keys/fred REPLACE_WITH_KEY
GitHubβ
GitHub is where over 100 million developers shape the future of software.
Instructions
Go to: https://github.com
Sign up for, or sign in to, GitHub. Once logged in, navigate to the apps page, under account settings.
Select, "New GitHub App":
After creating the app, the key will be issued. Enter this token into the OpenBB Terminal with:
/keys/github REPLACE_WITH_KEY
Glassnodeβ
Glassnode makes blockchain data accessible for everyone. We source and carefully dissect on-chain data, to deliver contextualized and actionable insights.
Instructions
Go to: https://studio.glassnode.com
Click on, "Sign up", and create an account:
After creating an account, navigate to the account settings and generate an API Key.
Enter this key in the OpenBB terminal with:
/keys/glassnode REPLACE_WITH_KEY
Intrinioβ
Intrinio is more than a financial data API provider β we're a real time data partner. That means we're your guide to every step of the financial data.
Instructions
Go to: https://intrinio.com/starter-plan
An API key will be issued with a subscription. Find the token value within the account dashboard, and enter it into the OpenBB Terminal with:
/keys/intrinio REPLACE_WITH_KEY
Messariβ
Gain an edge over the crypto market with professional grade data, tools, and research.
Instructions
Go to: https://messari.io
Click on, "Sign up", and create an account.
After creating the account, navigate to the account page, and click on the tab for, API Access.
Copy the API key and add it to the OpenBB Terminal by entering:
/keys/messari REPLACE_WITH_KEY
News APIβ
News API is a simple, easy-to-use REST API that returns JSON search results for current and historic news articles published by over 80,000 worldwide sources.
Instructions
Go to: https://newsapi.org
Click on, "Get API Key", and fill out the form.
Register for an account and the next screen will provide the API Key.
Add this API key into the OpenBB Terminal by entering:
/keys/news REPLACE_WITH_KEY
Oandaβ
OANDA's Currency Converter allows you to check the latest foreign exchange average bid/ask rates and convert all major world currencies.
Instructions
Go to: https://developer.oanda.com
After creating an account, follow the steps below.
Upon completion of the account setup, enter the credentials into the OpenBB Terminal using the syntax:
/keys/oanda -a REPLACE_WITH_ACCOUNT -t REPLACE_WITH_TOKEN --account_type REPLACE_WITH_LIVE_OR_PRACTICE
OpenAIβ
An API for accessing new AI models developed by OpenAI.
Instructions
Go to: https://openai.com/blog/openai-api
Click sign up and create an account. Once done, you will be logged into the home page:
Click the top right "Personal" button to find the following drop down:
Click View API Keys
. This will take you to the api Keys menu. Then click Create new secret key
:
Then enter the Secret key credentials into the OpenBB Terminal using the syntax:
/keys/openai -k <OPENAI API KEY>
Polygonβ
Live & historical data for US stocks for all 19 exchanges. Instant access to real-time and historical stock market data.
Instructions
Go to: https://polygon.io
Click on, "Get your Free API Key".
After signing up, the API Key is found at the bottom of the account dashboard page.
Enter the key into the OpenBB Terminal by typing:
/keys/polygon REPLACE_WITH_KEY
Quandlβ
The premier source for financial, economic, and alternative datasets, serving investment professionals. Quandlβs platform is used by over 400,000 people, including analysts from the worldβs top hedge funds, asset managers and investment banks.
Instructions
Go to: https://www.quandl.com
Click on, "Sign Up", and register a new account.
Follow the sign-up instructions, and upon completion the API key will be assigned.
Enter the key into the OpenBB Terminal with:
/keys/quandl REPLACE_WITH_KEY
Redditβ
Reddit is a network of communities where people can dive into their interests, hobbies and passions.
Instructions
Sign in to Reddit, and then go to: https://old.reddit.com/prefs/apps/
Scroll down and click on "create application", selecting "script".
Once the application is created, you must register it here
Click on, "Read the full API terms and sign up for usage", and fill out the form.
After submitting the form, check for a confirmation email. The credentials will be displayed here, enter them into the OpenBB Terminal in one line:
/keys/reddit -i REPLACE_WITH_CLIENT_ID -s REPLACE_WITH_CLIENT_SECRET -u REPLACE_WITH_REDDIT_USERNAME -p REPLACE_WITH_REDDIT_PASSWORD -a REPLACE_WITH_USER_AGENT
Robinhoodβ
Robinhood has commission-free investing, and tools to help shape your financial future.
Instructions
Go to: https://robinhood.com/us/en
After registering for an account, it can be added to the OpenBB Terminal with:
/keys/rb -u REPLACE_WITH_USERNAME -p REPLACE_WITH_PASSWORD
The first login will request 2FA authorization from the device connected to the account.
Santimentβ
We provide tools to help you analyze crypto markets and find data-driven opportunities to optimize your investing.
Instructions
Go to: https://app.santiment.net
Click on, "Sign up", and register for an account.
Navigate to the account dashboard and generate a key.
Add it to the OpenBB Terminal by entering:
/keys/santiment REPLACE_WITH_KEY
Stockseraβ
Empowering investors to take advantage of alternative data. We track trending tickers on social media and provide alternative data for easy due-diligence & analysis.
Instructions
Go to: https://stocksera.pythonanywhere.com
Click on, "Log in", and create an account.
Once logged in, navigate to the "Developers" tab and copy the API key.
Add the key to the OpenBB Terminal by entering:
/keys/stocksera REPLACE_WITH_KEY
Token Terminalβ
Token Terminal is a platform that aggregates financial data on the leading blockchains and decentralized applications.
Instructions
Go to: https://tokenterminal.com
Click on, "Log in" and sign up for an account.
Verify the email address, and then navigate go to the "API" tab and copy the API key to the clipboard.
Add the key to the OpenBB Terminal by typing:
/keys/tokenterminal REPLACE_WITH_KEY
Tradierβ
Tradier, the home of active traders. Our open collaboration platform allows investors to truly customize their trading experience like never before.
Instructions
Go to: https://documentation.tradier.com
Click on, "Open Account", to start the sign-up process. After the account has been setup, navigate to Tradier Broker Dash and create the application. Request a sandbox access token, and enter this key into the OpenBB Terminal with:
/keys/tradier REPLACE_WITH_KEY
Twitterβ
From breaking news and entertainment to sports and politics, get the full story with all the live commentary.
Upcoming changes to the Twitter API will deprecate the current functionality, it is uncertain if the current features will continue to work.
Ultima Insightsβ
Ultima Insights offers tools such as the SEC Filing Analyst, Company news monitoring, Industry event watch, and Earnings Call Roundup for comprehensive investment monitoring. It incorporates daily Wall Street-level Qualitative analysis into OpenBB to keep users updated. The News curation system, powered by GPT + LLMs technology, presents relevant news to investors, often before it appears on platforms like Bloomberg. Ultima aims to provide timely and significant information for its users.
Instructions
Go to: https://ultimainsights.ai/openbb
Click on the "Get started" button for Ultima Pro or "Just Want the API Key" to get an Ultima API key for yout OpenBB account. Once you sign-up and confirm you want to start a trial with Ultima, Copy the API key to your clipboard and enter this key into the OpenBB Terminal with:
/keys/ultima REPLACE_WITH_KEY
Whale Alertβ
Whale Alert continuously collects and analyzes billions of blockchain transactions and related-off chain data from hundreds of reliable sources and converts it into an easy to use standardized format. Our world-class analytics and custom high speed database solutions process transactions the moment they are made, resulting in the largest and most up-to-date blockchain dataset in the world.
Instructions
Go to: https://docs.whale-alert.io
Click on, "sign up here".
After creating the account, click on, "Create", to issue the API Key.
Enter the key into the OpenBB Terminal by typing:
/keys/walert REPLACE_WITH_KEY