summaryrefslogtreecommitdiffstats
path: root/sdk/usage
diff options
context:
space:
mode:
authorgithub-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>2024-03-12 12:35:50 +0000
committergithub-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>2024-03-12 12:35:50 +0000
commit68be54c1462ad83b4b7fb4259c78de25eb1436f3 (patch)
treed86279416b5873573299ed0f3c74b70870883552 /sdk/usage
parent61441a9455b3c4a57d782baf850337644177856b (diff)
Diffstat (limited to 'sdk/usage')
-rw-r--r--sdk/usage/api-keys.html10
-rw-r--r--sdk/usage/basics.html10
2 files changed, 10 insertions, 10 deletions
diff --git a/sdk/usage/api-keys.html b/sdk/usage/api-keys.html
index d800f76c5cb..a38812c8f19 100644
--- a/sdk/usage/api-keys.html
+++ b/sdk/usage/api-keys.html
@@ -7,14 +7,14 @@
<link rel="stylesheet" href="/katex/katex.min.css"><link rel="stylesheet" href="/assets/css/styles.22849d6d.css">
-<link rel="preload" href="/assets/js/runtime~main.ac424b38.js" as="script">
-<link rel="preload" href="/assets/js/main.795a99f0.js" as="script">
+<link rel="preload" href="/assets/js/runtime~main.25ac8ce8.js" as="script">
+<link rel="preload" href="/assets/js/main.ef0d5d38.js" as="script">
</head>
<body class="navigation-with-keyboard">
<script>!function(){function t(t){document.documentElement.setAttribute("data-theme",t)}var e=function(){var t=null;try{t=new URLSearchParams(window.location.search).get("docusaurus-theme")}catch(t){}return t}()||function(){var t=null;try{t=localStorage.getItem("theme")}catch(t){}return t}();t(null!==e?e:"dark")}()</script><div id="__docusaurus">
<div role="region" aria-label="Skip to main content"><a class="skipToContent_fXgn" href="#__docusaurus_skipToContent_fallback">Skip to main content</a></div><nav class="border-b border-grey-600 lg:px-12 header_docs_sdk navbar navbar--fixed-top"><div class="navbar__inner items-center"><div class="navbar__items"><div class="items-center ml-2 flex"><a href="/"><svg viewBox="0 0 271 19" width="271" height="19" fill="none" xmlns="http://www.w3.org/2000/svg"><path fill="#fff" d="M126.316.99V14.33l-1.144-1.11-1.142-1.113-1.144-1.11-1.142-1.114-1.144-1.11-1.145-1.113-1.141-1.11-1.145-1.114-1.142-1.113-1.144-1.11-1.142-1.11-1.144-1.114H110.311v17.788H112.597V4.323l1.144 1.113 1.142 1.113 1.144 1.11 1.142 1.114 1.145 1.11 1.141 1.113 1.145 1.11 1.144 1.114 1.142 1.11 1.144 1.113 1.142 1.113 1.144 1.11 1.142 1.111h1.145V.989h-2.287ZM163.123 7.66h-2.286V.99H147.12v17.79h18.294V7.65h-2.286l-.005.01ZM149.406 6.54V3.213h9.144V7.66h-9.144V6.54Zm13.717 4.447v5.566h-13.717V9.886h13.717v1.102ZM201.057 7.66h-3.427V.99h-13.72v17.79h18.289V7.65l-1.142.01ZM186.196 6.54V3.213h9.148V7.66h-9.148V6.54Zm13.72 4.447v5.566h-13.72V9.886h13.72v1.102ZM89.662.99H73.656v17.787H91.942v-2.22H75.945V12.106H89.656V9.883H75.945V3.213H91.942V.99H89.661ZM16.02.99H.018v17.79h18.291V.99H16.02Zm0 3.336v12.23H2.301V3.213h13.72v1.113ZM52.862.99H36.86v17.79h2.286v-6.673h16.003V.977h-2.287V.99Zm0 3.336v5.565H39.146V3.213h13.716v1.113ZM226.316 10.14h-6.117v8.64h6.141l.992-1v-7l-1.016-.64Zm-.002 1.62v5.94h-5.1v-6.48h5.1v.54ZM240.447 10.14h-7.115v8.64h8.133v-8.64h-1.018Zm0 1.62v5.94h-6.1v-6.48h6.1v.54ZM254.9 10.14H247.465v8.64H255.959V17.7H248.528V11.22H255.959v-1.08H254.9ZM269.404 10.14h-7.444V15h7.448v2.701h-5.853l-1.596.005.001.535v.539h8.505V17.7h-1.061.004H263.555l6.913.066.002-.607-.002-.41-.003-.67.005-1.08h-6.248 6.248l-.002-1.08H263.024v-2.7h7.441v-1.08h-1.061Z"></path></svg></a></div></div><div class="navbar__items navbar__items--right hidden sm:block"><div class="flex items-center"><div class="flex gap-4 mr-12 md:mr-0 ml-4"><button type="button" aria-haspopup="dialog" aria-expanded="false" aria-controls="" data-state="closed" class="bg-grey-900 radix-state-open:text-white hover:border-grey-200 hover:text-grey-200 radix-state-open:border-white border -mt-[0.6px] h-[34px] w-[34px] text-grey-400 border-grey-400 rounded flex items-center justify-center"><svg viewBox="0 0 24 24" width="24" height="24" fill="none" xmlns="http://www.w3.org/2000/svg" class="w-4 h-4"><path d="M21 12.79A9 9 0 1 1 11.21 3 7 7 0 0 0 21 12.79Z" stroke="currentColor" stroke-width="1.5" stroke-linecap="round" stroke-linejoin="round"></path></svg></button></div><div class="searchBox_ZlJk"><div class="flex gap-2"><button type="button" class="DocSearch DocSearch-Button" aria-label="Search"><span class="DocSearch-Button-Container"><svg width="20" height="20" class="DocSearch-Search-Icon" viewBox="0 0 20 20"><path d="M14.386 14.386l4.0877 4.0877-4.0877-4.0877c-2.9418 2.9419-7.7115 2.9419-10.6533 0-2.9419-2.9418-2.9419-7.7115 0-10.6533 2.9418-2.9419 7.7115-2.9419 10.6533 0 2.9419 2.9418 2.9419 7.7115 0 10.6533z" stroke="currentColor" fill="none" fill-rule="evenodd" stroke-linecap="round" stroke-linejoin="round"></path></svg><span class="DocSearch-Button-Placeholder">Search</span></span><span class="DocSearch-Button-Keys"></span></button><a href="https://my.openbb.co/" class="_btn-dark text-xs hover:text-black"><span class="md:hidden">Hub</span><span class="hidden md:inline">OpenBB Hub</span></a></div></div></div></div></div><div role="presentation" class="navbar-sidebar__backdrop"></div></nav><div id="__docusaurus_skipToContent_fallback" class="main-wrapper mainWrapper_z2l0 docsWrapper_BCFX"><button aria-label="Scroll back to top" class="clean-btn theme-back-to-top-button backToTopButton_sjWU" type="button"></button><div class="docPage__5DB"><aside class="theme-doc-sidebar-container docSidebarContainer_b6E3"><div class="sidebarViewport_Xe31"><div class="sidebar_njMd"><nav class="menu thin-scrollbar !px-10 text-sm !pb-10 mt-[40px] menu_Y1UP"><ul class="theme-doc-sidebar-menu menu__list"><li class="theme-doc-sidebar-item-category theme-doc-sidebar-item-category-level-1 menu__list-item menu__list-item--collapsed"><div class="menu__list-item-collapsible"><a class="menu__link menu__link--sublist" aria-expanded="false" href="/platform">OpenBB Platform</a><button aria-label="Toggle the collapsible sidebar category &#x27;OpenBB Platform&#x27;" type="button" class="clean-btn menu__caret"></button></div></li><li class="theme-doc-sidebar-item-category theme-doc-sidebar-item-category-level-1 menu__list-item menu__list-item--collapsed"><div class="menu__list-item-collapsible"><a class="menu__link menu__link--sublist" aria-expanded="false" href="/terminal">OpenBB Terminal</a><button aria-label="Toggle the collapsible sidebar category &#x27;OpenBB Terminal&#x27;" type="button" class="clean-btn menu__caret"></button></div></li><li class="theme-doc-sidebar-item-category theme-doc-sidebar-item-category-level-1 menu__list-item menu__list-item--collapsed"><div class="menu__list-item-collapsible"><a class="menu__link menu__link--sublist" aria-expanded="false" href="/bot">OpenBB Bot</a><button aria-label="Toggle the collapsible sidebar category &#x27;OpenBB Bot&#x27;" type="button" class="clean-btn menu__caret"></button></div></li><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-1"><span class="sidebar-divider"></li><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-1 menuHtmlItem_PEWV menu__list-item sidebar-title">LEGACY</li><li class="theme-doc-sidebar-item-category theme-doc-sidebar-item-category-level-1 menu__list-item"><div class="menu__list-item-collapsible"><a class="menu__link menu__link--sublist menu__link--sublist-caret menu__link--active" aria-expanded="true" href="/sdk">OpenBB SDK</a></div><ul style="display:block;overflow:visible;height:auto" class="menu__list"><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-2 menu__list-item"><a class="menu__link" tabindex="0" href="/sdk">Introduction</a></li><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-2 menu__list-item"><a class="menu__link" tabindex="0" href="/sdk/installation">Installation</a></li><li class="theme-doc-sidebar-item-category theme-doc-sidebar-item-category-level-2 menu__list-item"><div class="menu__list-item-collapsible"><a class="menu__link menu__link--sublist menu__link--active" aria-expanded="true" tabindex="0" href="/sdk/usage">Usage</a><button aria-label="Toggle the collapsible sidebar category &#x27;Usage&#x27;" type="button" class="clean-btn menu__caret"></button></div><ul style="display:block;overflow:visible;height:auto" class="menu__list"><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-3 menu__list-item"><a class="menu__link" tabindex="0" href="/sdk/usage/basics">Basics</a></li><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-3 menu__list-item"><a class="menu__link menu__link--active" aria-current="page" tabindex="0" href="/sdk/usage/api-keys">Setting API Keys</a></li></ul></li><li class="theme-doc-sidebar-item-category theme-doc-sidebar-item-category-level-2 menu__list-item menu__list-item--collapsed"><div class="menu__list-item-collapsible"><a class="menu__link menu__link--sublist" aria-expanded="false" tabindex="0" href="/sdk/data-available">Data Available</a><button aria-label="Toggle the collapsible sidebar category &#x27;Data Available&#x27;" type="button" class="clean-btn menu__caret"></button></div></li><li class="theme-doc-sidebar-item-category theme-doc-sidebar-item-category-level-2 menu__list-item menu__list-item--collapsed"><div class="menu__list-item-collapsible"><a class="menu__link menu__link--sublist" aria-expanded="false" tabindex="0" href="/sdk/reference">Reference</a><button aria-label="Toggle the collapsible sidebar category &#x27;Reference&#x27;" type="button" class="clean-btn menu__caret"></button></div></li><li class="theme-doc-sidebar-item-category theme-doc-sidebar-item-category-level-2 menu__list-item menu__list-item--collapsed"><div class="menu__list-item-collapsible"><a class="menu__link menu__link--sublist" aria-expanded="false" tabindex="0" href="/sdk/faqs">FAQs</a><button aria-label="Toggle the collapsible sidebar category &#x27;FAQs&#x27;" type="button" class="clean-btn menu__caret"></button></div></li><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-2 menu__list-item"><a class="menu__link" tabindex="0" href="/sdk/showcase">Showcase</a></li></ul></li></ul></nav></div></div></aside><main class="docMainContainer_gTbr"><div class="container padding-top--md padding-bottom--lg"><div class="row"><div class="col docItemCol_VOVn"><div class="docItemContainer_Djhp"><article><nav class="theme-doc-breadcrumbs breadcrumbsContainer_Z_bl" aria-label="Breadcrumbs"><ul class="breadcrumbs" itemscope="" itemtype="https://schema.org/BreadcrumbList"><li class="breadcrumbs__item"><a aria-label="Home page" class="breadcrumbs__link" href="/"><svg viewBox="0 0 24 24" class="breadcrumbHomeIcon_YNFT"><path d="M10 19v-5h4v5c0 .55.45 1 1 1h3c.55 0 1-.45 1-1v-7h1.7c.46 0 .68-.57.33-.87L12.67 3.6c-.38-.34-.96-.34-1.34 0l-8.36 7.53c-.34.3-.13.87.33.87H5v7c0 .55.45 1 1 1h3c.55 0 1-.45 1-1z" fill="currentColor"></path></svg></a></li><li class="breadcrumbs__item"><span class="breadcrumbs__link">OpenBB SDK</span><meta itemprop="position" content="1"></li><li itemscope="" itemprop="itemListElement" itemtype="https://schema.org/ListItem" class="breadcrumbs__item"><a class="breadcrumbs__link" itemprop="item" href="/sdk/usage"><span itemprop="name">Usage</span></a><meta itemprop="position" content="2"></li><li itemscope="" itemprop="itemListElement" itemtype="https://schema.org/ListItem" class="breadcrumbs__item breadcrumbs__item--active"><span class="breadcrumbs__link" itemprop="name">Setting API Keys</span><meta itemprop="position" content="3"></li></ul></nav><div class="tocCollapsible_ETCw theme-doc-toc-mobile tocMobile_bxCs"><button type="button" class="clean-btn tocCollapsibleButton_TO0P">On this page</button></div><div class="theme-doc-markdown markdown"><header><h1>Setting API Keys</h1></header><h2 class="anchor anchorWithStickyNavbar_LWe7" id="the-keys-module">The Keys Module<a href="#the-keys-module" class="hash-link" aria-label="Direct link to The Keys Module" title="Direct link to The Keys Module">​</a></h2><p>API (Application Programming Interface) keys are access credentials for obtaining data from a particular source. They are a string of random characters assigned, by the data provider, to an individual account. 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 SDK with the <code>openbb.keys</code> module, using the syntax described in the sections below. Wrapping the command with <code>help()</code> will print the docstrings to the screen. For example:</p><div class="language-console codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#9CDCFE;--prism-background-color:#1E1E1E"><div class="codeBlockContent_m3Ux"><pre tabindex="0" class="prism-code language-console codeBlock_qGQc thin-scrollbar"><code class="codeBlockLines_p187"><span class="token-line" style="color:#9CDCFE"><span class="token plain">help(openbb.keys.reddit)</span><br></span></code></pre><div class="buttonGroup_6DOT"><button type="button" aria-label="Copy code to clipboard" title="Copy" class="clean-btn"><span class="copyButtonIcons_eSgA" aria-hidden="true"><svg viewBox="0 0 24 24" class="copyButtonIcon_y97N"><path fill="currentColor" d="M19,21H8V7H19M19,5H8A2,2 0 0,0 6,7V21A2,2 0 0,0 8,23H19A2,2 0 0,0 21,21V7A2,2 0 0,0 19,5M16,1H4A2,2 0 0,0 2,3V17H4V3H16V1Z"></path></svg><svg viewBox="0 0 24 24" class="copyButtonSuccessIcon_LjdS"><path fill="currentColor" d="M21,7L9,19L3.5,13.5L4.91,12.09L9,16.17L19.59,5.59L21,7Z"></path></svg></span></button></div></div></div><p>Which prints:</p><div class="language-console codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#9CDCFE;--prism-background-color:#1E1E1E"><div class="codeBlockContent_m3Ux"><pre tabindex="0" class="prism-code language-console codeBlock_qGQc thin-scrollbar"><code class="codeBlockLines_p187"><span class="token-line" style="color:#9CDCFE"><span class="token plain"> Set Reddit key</span><br></span><span class="token-line" style="color:#9CDCFE"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#9CDCFE"><span class="token plain"> Parameters</span><br></span><span class="token-line" style="color:#9CDCFE"><span class="token plain"> ----------</span><br></span><span class="token-line" style="color:#9CDCFE"><span class="token plain"> client_id: str</span><br></span><span class="token-line" style="color:#9CDCFE"><span class="token plain"> Client ID</span><br></span><span class="token-line" style="color:#9CDCFE"><span class="token plain"> client_secret: str</span><br></span><span class="token-line" style="color:#9CDCFE"><span class="token plain"> Client secret</span><br></span><span class="token-line" style="color:#9CDCFE"><span class="token plain"> password: str</span><br></span><span class="token-line" style="color:#9CDCFE"><span class="token plain"> User password</span><br></span><span class="token-line" style="color:#9CDCFE"><span class="token plain"> username: str</span><br></span><span class="token-line" style="color:#9CDCFE"><span class="token plain"> User username</span><br></span><span class="token-line" style="color:#9CDCFE"><span class="token plain"> useragent: str</span><br></span><span class="token-line" style="color:#9CDCFE"><span class="token plain"> User useragent</span><br></span><span class="token-line" style="color:#9CDCFE"><span class="token plain"> persist: bool, optional</span><br></span><span class="token-line" style="color:#9CDCFE"><span class="token plain"> If False, api key change will be contained to where it was changed. For example, a Jupyter notebook session.</span><br></span><span class="token-line" style="color:#9CDCFE"><span class="token plain"> If True, api key change will be global, i.e. it will affect terminal environment variables.</span><br></span><span class="token-line" style="color:#9CDCFE"><span class="token plain"> By default, False.</span><br></span><span class="token-line" style="color:#9CDCFE"><span class="token plain"> show_output: bool, optional</span><br></span><span class="token-line" style="color:#9CDCFE"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#9CDCFE"><span class="token plain"> Returns</span><br></span><span class="token-line" style="color:#9CDCFE"><span class="token plain"> -------</span><br></span><span class="token-line" style="color:#9CDCFE"><span class="token plain"> str</span><br></span><span class="token-line" style="color:#9CDCFE"><span class="token plain"> Status of key set</span><br></span><span class="token-line" style="color:#9CDCFE"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#9CDCFE"><span class="token plain"> Examples</span><br></span><span class="token-line" style="color:#9CDCFE"><span class="token plain"> --------</span><br></span><span class="token-line" style="color:#9CDCFE"><span class="token plain"> &gt;&gt;&gt; from openbb_terminal.sdk import openbb</span><br></span><span class="token-line" style="color:#9CDCFE"><span class="token plain"> &gt;&gt;&gt; openbb.keys.reddit(</span><br></span><span class="token-line" style="color:#9CDCFE"><span class="token plain"> client_id=&quot;example_id&quot;,</span><br></span><span class="token-line" style="color:#9CDCFE"><span class="token plain"> client_secret=&quot;example_secret&quot;,</span><br></span><span class="token-line" style="color:#9CDCFE"><span class="token plain"> password=&quot;example_password&quot;,</span><br></span><span class="token-line" style="color:#9CDCFE"><span class="token plain"> username=&quot;example_username&quot;,</span><br></span><span class="token-line" style="color:#9CDCFE"><span class="token plain"> useragent=&quot;example_useragent&quot;</span><br></span><span class="token-line" style="color:#9CDCFE"><span class="token plain"> )</span><br></span></code></pre><div class="buttonGroup_6DOT"><button type="button" aria-label="Copy code to clipboard" title="Copy" class="clean-btn"><span class="copyButtonIcons_eSgA" aria-hidden="true"><svg viewBox="0 0 24 24" class="copyButtonIcon_y97N"><path fill="currentColor" d="M19,21H8V7H19M19,5H8A2,2 0 0,0 6,7V21A2,2 0 0,0 8,23H19A2,2 0 0,0 21,21V7A2,2 0 0,0 19,5M16,1H4A2,2 0 0,0 2,3V17H4V3H16V1Z"></path></svg><svg viewBox="0 0 24 24" class="copyButtonSuccessIcon_LjdS"><path fill="currentColor" d="M21,7L9,19L3.5,13.5L4.91,12.09L9,16.17L19.59,5.59L21,7Z"></path></svg></span></button></div></div></div><p>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.</p><div class="language-console codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#9CDCFE;--prism-background-color:#1E1E1E"><div class="codeBlockContent_m3Ux"><pre tabindex="0" class="prism-code language-console codeBlock_qGQc thin-scrollbar"><code class="codeBlockLines_p187"><span class="token-line" style="color:#9CDCFE"><span class="token plain">openbb.stocks.quote(&quot;AAPL&quot;)</span><br></span><span class="token-line" style="color:#9CDCFE"><span class="token plain">API_KEY_FINANCIALMODELINGPREP not defined. Set API Keys in ~/.openbb_terminal/.env or under keys menu.</span><br></span></code></pre><div class="buttonGroup_6DOT"><button type="button" aria-label="Copy code to clipboard" title="Copy" class="clean-btn"><span class="copyButtonIcons_eSgA" aria-hidden="true"><svg viewBox="0 0 24 24" class="copyButtonIcon_y97N"><path fill="currentColor" d="M19,21H8V7H19M19,5H8A2,2 0 0,0 6,7V21A2,2 0 0,0 8,23H19A2,2 0 0,0 21,21V7A2,2 0 0,0 19,5M16,1H4A2,2 0 0,0 2,3V17H4V3H16V1Z"></path></svg><svg viewBox="0 0 24 24" class="copyButtonSuccessIcon_LjdS"><path fill="currentColor" d="M21,7L9,19L3.5,13.5L4.91,12.09L9,16.17L19.59,5.59L21,7Z"></path></svg></span></button></div></div></div><p>The menu also provides a method for testing the validity of a key upon entry. It can be easy to copy &amp; paste the string with a missing character; so, if the test fails, check that the values were correctly recorded with the command:</p><div class="language-console codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#9CDCFE;--prism-background-color:#1E1E1E"><div class="codeBlockContent_m3Ux"><pre tabindex="0" class="prism-code language-console codeBlock_qGQc thin-scrollbar"><code class="codeBlockLines_p187"><span class="token-line" style="color:#9CDCFE"><span class="token plain">openbb.keys.mykeys(show = True)</span><br></span></code></pre><div class="buttonGroup_6DOT"><button type="button" aria-label="Copy code to clipboard" title="Copy" class="clean-btn"><span class="copyButtonIcons_eSgA" aria-hidden="true"><svg viewBox="0 0 24 24" class="copyButtonIcon_y97N"><path fill="currentColor" d="M19,21H8V7H19M19,5H8A2,2 0 0,0 6,7V21A2,2 0 0,0 8,23H19A2,2 0 0,0 21,21V7A2,2 0 0,0 19,5M16,1H4A2,2 0 0,0 2,3V17H4V3H16V1Z"></path></svg><svg viewBox="0 0 24 24" class="copyButtonSuccessIcon_LjdS"><path fill="currentColor" d="M21,7L9,19L3.5,13.5L4.91,12.09L9,16.17L19.59,5.59L21,7Z"></path></svg></span></button></div></div></div><p><strong>We recommend gradually obtaining keys, when the use of a specific function requires it.</strong></p><h2 class="anchor anchorWithStickyNavbar_LWe7" id="instructions-by-source">Instructions by Source<a href="#instructions-by-source" class="hash-link" aria-label="Direct link to Instructions by Source" title="Direct link to Instructions by Source">​</a></h2><p>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. Include, <code>persist = True</code> in the syntax to permanently store the key on the machine.</p><h3 class="anchor anchorWithStickyNavbar_LWe7" id="alphavantage">AlphaVantage<a href="#alphavantage" class="hash-link" aria-label="Direct link to AlphaVantage" title="Direct link to AlphaVantage">​</a></h3><blockquote><p>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.</p></blockquote><details class="details_lb9f alert alert--info details_r1OI" data-collapsed="true"><summary>Instructions</summary><div><div class="collapsibleContent_i85q"><p>Go to: <a href="https://www.alphavantage.co/support/#api-key" target="_blank" rel="noopener noreferrer">https://www.alphavantage.co/support/#api-key</a></p><p><a href="https://www.alphavantage.co/support/#api-key" target="_blank" rel="noopener noreferrer">AlphaVantage</a></p><p><img loading="lazy" src="https://user-images.githubusercontent.com/46355364/207820936-46c2ba00-81ff-4cd3-98a4-4fa44412996f.png" alt="AlphaVantage" class="img_ev3q"></p><p>Fill out the form, pass Captcha, and click on, &quot;GET FREE API KEY&quot;. The issued key can be entered into the OpenBB SDK with:</p><div class="language-console codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#9CDCFE;--prism-background-color:#1E1E1E"><div class="codeBlockContent_m3Ux"><pre tabindex="0" class="prism-code language-console codeBlock_qGQc thin-scrollbar"><code class="codeBlockLines_p187"><span class="token-line" style="color:#9CDCFE"><span class="token plain">openbb.keys.av(key = &#x27;REPLACE_WITH_KEY&#x27;, persist = True)</span><br></span></code></pre><div class="buttonGroup_6DOT"><button type="button" aria-label="Copy code to clipboard" title="Copy" class="clean-btn"><span class="copyButtonIcons_eSgA" aria-hidden="true"><svg viewBox="0 0 24 24" class="copyButtonIcon_y97N"><path fill="currentColor" d="M19,21H8V7H19M19,5H8A2,2 0 0,0 6,7V21A2,2 0 0,0 8,23H19A2,2 0 0,0 21,21V7A2,2 0 0,0 19,5M16,1H4A2,2 0 0,0 2,3V17H4V3H16V1Z"></path></svg><svg viewBox="0 0 24 24" class="copyButtonSuccessIcon_LjdS"><path fill="currentColor" d="M21,7L9,19L3.5,13.5L4.91,12.09L9,16.17L19.59,5.59L21,7Z"></path></svg></span></button></div></div></div></div></div></details><h3 class="anchor anchorWithStickyNavbar_LWe7" id="binance">Binance<a href="#binance" class="hash-link" aria-label="Direct link to Binance" title="Direct link to Binance">​</a></h3><blockquote><p>Binance cryptocurrency exchange - We operate the worlds biggest bitcoin exchange and altcoin crypto exchange in the world by volume</p></blockquote><details class="details_lb9f alert alert--info details_r1OI" data-collapsed="true"><summary>Instructions</summary><div><div class="collapsibleContent_i85q"><p>Go to: <a href="https://www.binance.com/en/support/faq/how-to-create-api-360002502072" target="_blank" rel="noopener noreferrer">https://www.binance.com/en/support/faq/how-to-create-api-360002502072</a></p><p><img loading="lazy" src="https://user-images.githubusercontent.com/46355364/207839805-f71cf12a-62d2-41cb-ba19-0c35917abc40.png" alt="Binance" class="img_ev3q"></p><p>These instructions should provide clear guidance for obtaining an API Key. Enter the issued credentials into the OpenBB SDK with:</p><div class="language-console codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#9CDCFE;--prism-background-color:#1E1E1E"><div class="codeBlockContent_m3Ux"><pre tabindex="0" class="prism-code language-console codeBlock_qGQc thin-scrollbar"><code class="codeBlockLines_p187"><span class="token-line" style="color:#9CDCFE"><span class="token plain">openbb.keys.binance(</span><br></span><span class="token-line" style="color:#9CDCFE"><span class="token plain"> key = &#x27;REPLACE_WITH_KEY&#x27;,</span><br></span><span class="token-line" style="color:#9CDCFE"><span class="token plain"> secret = &#x27;REPLACE_WITH_SECRET&#x27;,</span><br></span><span class="token-line" style="color:#9CDCFE"><span class="token plain"> persist = True</span><br></span><span class="token-line" style="color:#9CDCFE"><span class="token plain">)</span><br></span></code></pre><div class="buttonGroup_6DOT"><button type="button" aria-label="Copy code to clipboard" title="Copy" class="clean-btn"><span class="copyButtonIcons_eSgA" aria-hidden="true"><svg viewBox="0 0 24 24" class="copyButtonIcon_y97N"><path fill="currentColor" d="M19,21H8V7H19M19,5H8A2,2 0 0,0 6,7V21A2,2 0 0,0 8,23H19A2,2 0 0,0 21,21V7A2,2 0 0,0 19,5M16,1H4A2,2 0 0,0 2,3V17H4V3H16V1Z"></path></svg><svg viewBox="0 0 24 24" class="copyButtonSuccessIcon_LjdS"><path fill="currentColor" d="M21,7L9,19L3.5,13.5L4.91,12.09L9,16.17L19.59,5.59L21,7Z"></path></svg></span></button></div></div></div></div></div></details><h3 class="anchor anchorWithStickyNavbar_LWe7" id="bitquery">Bitquery<a href="#bitquery" class="hash-link" aria-label="Direct link to Bitquery" title="Direct link to Bitquery">​</a></h3><blockquote><p>Bitquery is an API-first product company dedicated to power and solve blockchain data problems using the ground truth of on-chain data.</p></blockquote><details class="details_lb9f alert alert--info details_r1OI" data-collapsed="true"><summary>Instructions</summary><div><div class="collapsibleContent_i85q"><p>Go to: <a href="https://bitquery.io/" target="_blank" rel="noopener noreferrer">https://bitquery.io/</a>&lt;</p><p><img loading="lazy" src="https://user-images.githubusercontent.com/46355364/207840322-5532a3f9-739f-4e28-9839-a58db932882e.png" alt="Bitquery" class="img_ev3q"></p><p>Click &quot;Try GraphQL API&quot;, which opens the following screen:</p><p><img loading="lazy" src="https://user-images.githubusercontent.com/46355364/207840576-2c51a538-dd9b-484d-b11d-40e3e424df62.png" alt="Try GraphQL API" class="img_ev3q"></p><p>After creating an account and verifying the email address, get the value for the key by clicking on the &quot;API Key&quot; tab.</p><p><img loading="lazy" src="https://user-images.githubusercontent.com/46355364/207840833-35c1b12c-9b4b-43fe-a33e-f7b92c43a011.png" alt="Get Bitquery API Key" class="img_ev3q"></p><p>Enter this API key into the OpenBB SDK with:</p><div class="language-console codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#9CDCFE;--prism-background-color:#1E1E1E"><div class="codeBlockContent_m3Ux"><pre tabindex="0" class="prism-code language-console codeBlock_qGQc thin-scrollbar"><code class="codeBlockLines_p187"><span class="token-line" style="color:#9CDCFE"><span class="token plain">openbb.keys.bitquery(key = &#x27;REPLACE_WITH_KEY&#x27;, persist = True)</span><br></span></code></pre><div class="buttonGroup_6DOT"><button type="button" aria-label="Copy code to clipboard" title="Copy" class="clean-btn"><span class="copyButtonIcons_eSgA" aria-hidden="true"><svg viewBox="0 0 24 24" class="copyButtonIcon_y97N"><path fill="currentColor" d="M19,21H8V7H19M19,5H8A2,2 0 0,0 6,7V21A2,2 0 0,0 8,23H19A2,2 0 0,0 21,21V7A2,2 0 0,0 19,5M16,1H4A2,2 0 0,0 2,3V17H4V3H16V1Z"></path></svg><svg viewBox="0 0 24 24" class="copyButtonSuccessIcon_LjdS"><path fill="currentColor" d="M21,7L9,19L3.5,13.5L4.91,12.09L9,16.17L19.59,5.59L21,7Z"></path></svg></span></button></div></div></div></div></div></details><h3 class="anchor anchorWithStickyNavbar_LWe7" id="biztoc">BizToc<a href="#biztoc" class="hash-link" aria-label="Direct link to BizToc" title="Direct link to BizToc">​</a></h3><blockquote><p>BizToc is the one-stop business and finance news hub, encapsulating the top 200 US news providers in real time.</p></blockquote><details class="details_lb9f alert alert--info details_r1OI" data-collapsed="true"><summary>Instructions</summary><div><div class="collapsibleContent_i85q"><p>The BizToc API is hosted on RapidAPI. To set up, go to: <a href="https://rapidapi.com/thma/api/biztoc" target="_blank" rel="noopener noreferrer">https://rapidapi.com/thma/api/biztoc</a>.</p><p><img loading="lazy" src="https://github.com/marban/OpenBBTerminal/assets/18151143/04cdd423-f65e-4ad8-ad5a-4a59b0f5ddda" alt="biztoc0" class="img_ev3q"></p><p>In the top right, select &quot;Sign Up&quot;. After answering some questions, you will be prompted to select one of their plans.</p><p><img loading="lazy" src="https://github.com/marban/OpenBBTerminal/assets/18151143/9f3b72ea-ded7-48c5-aa33-bec5c0de8422" alt="biztoc1" class="img_ev3q"></p><p>After signing up, navigate back to <a href="https://rapidapi.com/thma/api/biztoc" target="_blank" rel="noopener noreferrer">https://rapidapi.com/thma/api/biztoc</a>. If you are logged in, you will see a header called X-RapidAPI-Key.</p><p><img loading="lazy" src="https://github.com/marban/OpenBBTerminal/assets/18151143/0f3b6c91-07e0-447a-90cd-a9e23522929f" alt="biztoc2" class="img_ev3q"></p><p>Copy the key to the clipboard, and enter this key into the OpenBB Terminal with:</p><div class="language-console codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#9CDCFE;--prism-background-color:#1E1E1E"><div class="codeBlockContent_m3Ux"><pre tabindex="0" class="prism-code language-console codeBlock_qGQc thin-scrollbar"><code class="codeBlockLines_p187"><span class="token-line" style="color:#9CDCFE"><span class="token plain">openbb.keys.biztoc(key = &quot;REPLACE_WITH_KEY&quot;, persist=True)</span><br></span></code></pre><div class="buttonGroup_6DOT"><button type="button" aria-label="Copy code to clipboard" title="Copy" class="clean-btn"><span class="copyButtonIcons_eSgA" aria-hidden="true"><svg viewBox="0 0 24 24" class="copyButtonIcon_y97N"><path fill="currentColor" d="M19,21H8V7H19M19,5H8A2,2 0 0,0 6,7V21A2,2 0 0,0 8,23H19A2,2 0 0,0 21,21V7A2,2 0 0,0 19,5M16,1H4A2,2 0 0,0 2,3V17H4V3H16V1Z"></path></svg><svg viewBox="0 0 24 24" class="copyButtonSuccessIcon_LjdS"><path fill="currentColor" d="M21,7L9,19L3.5,13.5L4.91,12.09L9,16.17L19.59,5.59L21,7Z"></path></svg></span></button></div></div></div></div></div></details><h3 class="anchor anchorWithStickyNavbar_LWe7" id="coinmarketcap">CoinMarketCap<a href="#coinmarketcap" class="hash-link" aria-label="Direct link to CoinMarketCap" title="Direct link to CoinMarketCap">​</a></h3><blockquote><p>CoinMarketCap is the world&#x27;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.</p></blockquote><details class="details_lb9f alert alert--info details_r1OI" data-collapsed="true"><summary>Instructions</summary><div><div class="collapsibleContent_i85q"><p>Go to: <a href="https://coinmarketcap.com/api" target="_blank" rel="noopener noreferrer">https://coinmarketcap.com/api</a></p><p><img loading="lazy" src="https://user-images.githubusercontent.com/46355364/207831111-3f09ed75-740e-4121-a67e-6e1f36e8ab9a.png" alt="CoinMarketCap" class="img_ev3q"></p><p>Click on, &quot;Get Your Free API Key Now&quot;, which opens to the page:</p><p><img loading="lazy" src="https://user-images.githubusercontent.com/46355364/207831345-06a48efe-63b2-4804-bcf9-52fa4a73f7db.png" alt="CoinMarketCap" class="img_ev3q"></p><p>Once the account has been created, copy the API key displayed within the dashboard.</p><p><img loading="lazy" src="https://user-images.githubusercontent.com/46355364/207831705-e9f95018-bba7-49a9-b057-3443bc839861.png" alt="CoinMarketCap" class="img_ev3q"></p><p>Enter the API key into the OpenBB SDK with:</p><div class="language-console codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#9CDCFE;--prism-background-color:#1E1E1E"><div class="codeBlockContent_m3Ux"><pre tabindex="0" class="prism-code language-console codeBlock_qGQc thin-scrollbar"><code class="codeBlockLines_p187"><span class="token-line" style="color:#9CDCFE"><span class="token plain">openbb.keys.cmc(key = &#x27;REPLACE_WITH_KEY&#x27;, persist = True)</span><br></span></code></pre><div class="buttonGroup_6DOT"><button type="button" aria-label="Copy code to clipboard" title="Copy" class="clean-btn"><span class="copyButtonIcons_eSgA" aria-hidden="true"><svg viewBox="0 0 24 24" class="copyButtonIcon_y97N"><path fill="currentColor" d="M19,21H8V7H19M19,5H8A2,2 0 0,0 6,7V21A2,2 0 0,0 8,23H19A2,2 0 0,0 21,21V7A2,2 0 0,0 19,5M16,1H4A2,2 0 0,0 2,3V17H4V3H16V1Z"></path></svg><svg viewBox="0 0 24 24" class="copyButtonSuccessIcon_LjdS"><path fill="currentColor" d="M21,7L9,19L3.5,13.5L4.91,12.09L9,16.17L19.59,5.59L21,7Z"></path></svg></span></button></div></div></div></div></div></details><h3 class="anchor anchorWithStickyNavbar_LWe7" id="coinbase">Coinbase<a href="#coinbase" class="hash-link" aria-label="Direct link to Coinbase" title="Direct link to Coinbase">​</a></h3><blockquote><p>Coinbase is a secure online platform for buying, selling, transferring, and storing cryptocurrency.</p></blockquote><details class="details_lb9f alert alert--info details_r1OI" data-collapsed="true"><summary>Instructions</summary><div><div class="collapsibleContent_i85q"><p>Go to: <a href="https://help.coinbase.com/en/exchange/managing-my-account/how-to-create-an-api-key" target="_blank" rel="noopener noreferrer">https://help.coinbase.com/en/exchange/managing-my-account/how-to-create-an-api-key</a></p><p><img loading="lazy" src="https://user-images.githubusercontent.com/46355364/207841901-647f0aef-0c74-454d-b99e-367d784259f0.png" alt="Coinbase" class="img_ev3q"></p><p>Follow the instructions to obtain the credentials for the specific account. Enter the three values into the OpenBB SDK with:</p><div class="language-console codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#9CDCFE;--prism-background-color:#1E1E1E"><div class="codeBlockContent_m3Ux"><pre tabindex="0" class="prism-code language-console codeBlock_qGQc thin-scrollbar"><code class="codeBlockLines_p187"><span class="token-line" style="color:#9CDCFE"><span class="token plain">openbb.keys.coinbase(</span><br></span><span class="token-line" style="color:#9CDCFE"><span class="token plain"> key = &#x27;REPLACE_WITH_KEY&#x27;,</span><br></span><span class="token-line" style="color:#9CDCFE"><span class="token plain"> secret = &#x27;REPLACE_WITH_SECRET&#x27;,</span><br></span><span class="token-line" style="color:#9CDCFE"><span class="token plain"> passphrase = &#x27;REPLACE_WITH_PASSPHRASE&#x27;,</span><br></span><span class="token-line" style="color:#9CDCFE"><span class="token plain"> persist = True</span><br></span><span class="token-line" style="color:#9CDCFE"><span class="token plain">)</span><br></span></code></pre><div class="buttonGroup_6DOT"><button type="button" aria-label="Copy code to clipboard" title="Copy" class="clean-btn"><span class="copyButtonIcons_eSgA" aria-hidden="true"><svg viewBox="0 0 24 24" class="copyButtonIcon_y97N"><path fill="currentColor" d="M19,21H8V7H19M19,5H8A2,2 0 0,0 6,7V21A2,2 0 0,0 8,23H19A2,2 0 0,0 21,21V7A2,2 0 0,0 19,5M16,1H4A2,2 0 0,0 2,3V17H4V3H16V1Z"></path></svg><svg viewBox="0 0 24 24" class="copyButtonSuccessIcon_LjdS"><path fill="currentColor" d="M21,7L9,19L3.5,13.5L4.91,12.09L9,16.17L19.59,5.59L21,7Z"></path></svg></span></button></div></div></div></div></div></details><h3 class="anchor anchorWithStickyNavbar_LWe7" id="coinglass">Coinglass<a href="#coinglass" class="hash-link" aria-label="Direct link to Coinglass" title="Direct link to Coinglass">​</a></h3><blockquote><p>Coinglass is a cryptocurrency futures trading &amp; 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.</p></blockquote><details class="details_lb9f alert alert--info details_r1OI" data-collapsed="true"><summary>Instructions</summary><div><div class="collapsibleContent_i85q"><p>Go to: <a href="https://www.coinglass.com/" target="_blank" rel="noopener noreferrer">https://www.coinglass.com/</a></p><p><img loading="lazy" src="https://user-images.githubusercontent.com/46355364/207844601-8510687a-e54f-49b9-961f-5ef6718f58ab.png" alt="Coinglass" class="img_ev3q"></p><p>Click, &quot;Log in&quot;, and then sign up for an account. This opens the page:</p><p><img loading="lazy" src="https://user-images.githubusercontent.com/46355364/207844637-a9321889-c4d8-4d44-95fe-a6288a17ad19.png" alt="Coinglass" class="img_ev3q"></p><p>With the account created, find the assigned API key within the account profile page. Enter this value into the OpenBB SDK with:</p><div class="language-console codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#9CDCFE;--prism-background-color:#1E1E1E"><div class="codeBlockContent_m3Ux"><pre tabindex="0" class="prism-code language-console codeBlock_qGQc thin-scrollbar"><code class="codeBlockLines_p187"><span class="token-line" style="color:#9CDCFE"><span class="token plain">openbb.keys.coinglass(key = &#x27;REPLACE_WITH_KEY&#x27;, persist = True)</span><br></span></code></pre><div class="buttonGroup_6DOT"><button type="button" aria-label="Copy code to clipboard" title="Copy" class="clean-btn"><span class="copyButtonIcons_eSgA" aria-hidden="true"><svg viewBox="0 0 24 24" class="copyButtonIcon_y97N"><path fill="currentColor" d="M19,21H8V7H19M19,5H8A2,2 0 0,0 6,7V21A2,2 0 0,0 8,23H19A2,2 0 0,0 21,21V7A2,2 0 0,0 19,5M16,1H4A2,2 0 0,0 2,3V17H4V3H16V1Z"></path></svg><svg viewBox="0 0 24 24" class="copyButtonSuccessIcon_LjdS"><path fill="currentColor" d="M21,7L9,19L3.5,13.5L4.91,12.09L9,16.17L19.59,5.59L21,7Z"></path></svg></span></button></div></div></div></div></div></details><h3 class="anchor anchorWithStickyNavbar_LWe7" id="companies-house">Companies House<a href="#companies-ho