CINXE.COM
Trading Economics API Documentation
<!doctype html><html itemscope itemtype=http://schema.org/WebPage lang=en class=no-js><head><meta charset=utf-8><meta name=viewport content="width=device-width,initial-scale=1,shrink-to-fit=no"><meta name=generator content="Hugo 0.111.3"><link rel=alternate type=application/rss+xml href=https://docs.tradingeconomics.com/index.xml><meta name=robots content="index, follow"><link rel=icon href=/icons/TE_docs.svg><title>Trading Economics API Documentation</title><meta name=description content="Trading Economics API Documentation"><meta property="og:title" content><meta property="og:description" content="Trading Economics API Documentation"><meta property="og:type" content="website"><meta property="og:url" content="https://docs.tradingeconomics.com/"><meta itemprop=name content><meta itemprop=description content="Trading Economics API Documentation"><meta name=twitter:card content="summary"><meta name=twitter:title content><meta name=twitter:description content="Trading Economics API Documentation"><link rel=preload href=/scss/main.min.32a3b610ae1d7e4e38f66215bf9fe4eb245d55f29098951b4deb8cc19e834f09.css as=style><link href=/scss/main.min.32a3b610ae1d7e4e38f66215bf9fe4eb245d55f29098951b4deb8cc19e834f09.css rel=stylesheet integrity><script src=https://code.jquery.com/jquery-3.6.3.min.js integrity="sha512-STof4xm1wgkfm7heWqFJVn58Hm3EtS31XFaagaa8VMReCXAkQnJZ+jEy8PCC/iT18dFy95WcExNHFTqLyp72eQ==" crossorigin=anonymous></script> <script defer src=https://unpkg.com/lunr@2.3.9/lunr.min.js integrity=sha384-203J0SNzyqHby3iU6hzvzltrWi/M41wOP5Gu+BiJMz5nwKykbkUx8Kp7iti0Lpli crossorigin=anonymous></script> <script async src="https://www.googletagmanager.com/gtag/js?id=UA-00000000-0"></script> <script>var doNotTrack=!1;if(!doNotTrack){window.dataLayer=window.dataLayer||[];function gtag(){dataLayer.push(arguments)}gtag("js",new Date),gtag("config","UA-00000000-0")}</script></head><body class=td-home><header><nav class="navbar navbar-expand-md td-navbar"><div class=container-fluid id=navbar><button class=navbar-toggler type=button data-mdb-toggle=collapse data-mdb-target=#navbarSupportedContent aria-controls=navbarSupportedContent aria-expanded=false aria-label="Toggle navigation"><svg width="30" height="30" viewBox="0 0 60 59" fill="none" xmlns="http://www.w3.org/2000/svg"><rect width="60" height="59" fill="#f7f8f9"/><path d="M16.8723 42V21.1973H10V17H28.75v4.1973H21.8704V42H16.8723z" fill="#a3aeb4"/><path d="M31.25 42V17H50v4.2292H36.25v5.6392H49.375v4.1151H36.25v6.8039H50V42H31.25z" fill="#263238"/></svg></button><div class="collapse navbar-collapse" id=navbarSupportedContent><a class=navbar-brand href=/><svg width="130" height="35" viewBox="0 0 34.131 9.2604" xmlns="http://www.w3.org/2000/svg"><g fill="#858585" stroke="#858585" stroke-width=".1" aria-label="ECONOMICS"><path d="m1.3315 8.5517V4.7638h2.8086v.64079H2.0963v.83974H3.998v.6382H2.0963v1.0309h2.1162v.6382z"/><path d="m7.2846 7.1591.74156.23513q-.17053.62012-.56844.92242-.39532.29972-1.0051.29972-.75448.0-1.2402-.51418-.48576-.51676-.48576-1.4108.0-.94568.48834-1.4676.48834-.52452 1.2842-.52452.69505.0 1.1291.41083.25838.24288.38757.69763l-.75706.18087q-.067179-.29456-.28164-.46509-.21187-.17053-.51676-.17053-.42116.0-.68471.30231-.26097.30231-.26097.97927.0.7183.25838 1.0232.25838.30489.67179.30489.30489.0.52452-.19379.21962-.19379.31523-.60978z"/><path d="m8.5275 6.681q0-.57878.17312-.97152.12919-.28939.3514-.51935.22479-.22996.49093-.34106.35398-.14986.81649-.14986.83716.0 1.3384.51935.50385.51935.50385 1.4444.0.91726-.49868 1.4366-.49868.51676-1.3333.51676-.84491.0-1.3436-.51418-.49868-.51676-.49868-1.4211zm.78807-.025838q0 .64337.29714.97669.29714.33073.75448.33073t.74931-.32815q.29456-.33073.29456-.9896.0-.65112-.2868-.97152-.28422-.32039-.75706-.32039t-.76223.32556q-.28939.32298-.28939.97669z"/><path d="m12.806 8.5517V4.7638h.74414l1.5503 2.5296V4.7638h.71055v3.7879h-.7674l-1.527-2.4701v2.4701z"/><path d="m16.465 6.681q0-.57878.17312-.97152.12919-.28939.3514-.51935.22479-.22996.49093-.34106.35398-.14986.81649-.14986.83716.0 1.3384.51935.50384.51935.50384 1.4444.0.91726-.49868 1.4366-.49868.51676-1.3333.51676-.84491.0-1.3436-.51418-.49868-.51676-.49868-1.4211zm.78807-.025838q0 .64337.29714.97669.29714.33073.75448.33073t.74931-.32815q.29456-.33073.29456-.9896.0-.65112-.2868-.97152-.28422-.32039-.75706-.32039t-.76223.32556q-.28939.32298-.28939.97669z"/><path d="m20.726 8.5517V4.7638h1.1446l.6873 2.5838.67955-2.5838h1.1472v3.7879h-.71055V5.57l-.75189 2.9817h-.73639L21.43651 5.57v2.9817z"/><path d="m25.121 8.5517V4.7638h.76481v3.7879z"/><path d="m29.038 7.1591.74156.23513q-.17053.62012-.56844.92242-.39532.29972-1.0051.29972-.75448.0-1.2402-.51418-.48576-.51676-.48576-1.4108.0-.94568.48834-1.4676.48834-.52452 1.2842-.52452.69505.0 1.1291.41083.25838.24288.38757.69763l-.75706.18087q-.06718-.29456-.28164-.46509-.21187-.17053-.51676-.17053-.42116.0-.68471.30231-.26097.30231-.26097.97927.0.7183.25838 1.0232.25838.30489.67179.30489.30489.0.52452-.19379.21962-.19379.31523-.60978z"/><path d="m30.242 7.3193.74414-.072347q.06718.37465.2713.55035.2067.1757.55552.1757.36949.0.55552-.15503.18862-.15761.18862-.3669.0-.13436-.0801-.22738-.077514-.095602-.27388-.16536-.13436-.046509-.61237-.16536-.61495-.15245-.863-.37465-.34882-.31264-.34882-.76223.0-.28939.16278-.54002.16536-.25321.47284-.38499.31006-.13178.74672-.13178.71314.0 1.0723.31264.36174.31264.37982.83457l-.76481.03359q-.04909-.29197-.21187-.41858-.1602-.12919-.48317-.12919-.33331.0-.52193.13694-.12144.08785-.12144.23513.0.13436.11369.22996.14469.12144.7028.25321t.82424.27389q.26872.13953.41858.38499.15244.24288.15244.60203.0.32556-.18087.60978t-.5116.42375q-.33073.13694-.82424.13694-.7183.0-1.1033-.33073-.38499-.33331-.45992-.96893z"/></g><g fill="#ddd" stroke="#ddd" stroke-width=".1" aria-label="TRADING"><path d="m1.4629 4.2437V1.4113H.4513V.83459h2.7091v.57671H2.1512v2.8324z"/><path d="m3.607 4.2437V.8346h1.4487q.54648.0.79297.093018.24882.090692.39765.32556.14883.23487.14883.53718.0.3837-.22557.63484-.22557.24882-.67438.31393.22324.13022.36742.28603.1465.1558.393.55345l.41625.66508h-.82321l-.49764-.74182q-.2651-.39765-.36277-.49997-.097668-.10464-.20696-.14185-.1093-.039532-.34649-.039532h-.13953v1.4232zm.68833-1.9673h.50927q.49532.0.61857-.041858t.19301-.14418q.069763-.10232.069763-.2558.0-.17208-.093018-.27673-.090692-.10697-.25812-.13488-.083716-.011627-.50229-.011627h-.53718z"/><path d="m10.118 4.2437h-.74879l-.29766-.77437h-1.3627l-.28138.77437h-.73019L8.02508.8346h.72786zM8.8506 2.8949l-.46974-1.265-.46044 1.265z"/><path d="m10.481.8346h1.2581q.42556.0.6488.065112.29998.088367.51392.31393.21394.22557.32556.55345.11162.32556.11162.8046.0.4209-.10464.72554-.1279.37207-.36509.60229-.17906.17441-.48369.27208-.22789.072089-.60926.072089h-1.2953zm.68833.57671v2.258h.51392q.28835.0.41625-.032556.16743-.041858.27673-.14185.11162-.099994.18138-.32789.06976-.23022.06976-.62554t-.06976-.60694-.19534-.33021q-.12557-.1186-.31858-.16046-.14418-.032556-.56508-.032556z"/><path d="m13.902 4.2437V.8346h.68833v3.4091z"/><path d="m15.253 4.2437V.8346h.66973l1.3953 2.2766V.8346h.6395v3.4091h-.69066l-1.3743-2.2231v2.2231z"/><path d="m20.271 2.9903v-.57438h1.4836v1.3581q-.21627.20929-.62787.36974-.40928.15813-.83018.15813-.53485.0-.9325-.22324-.39765-.22557-.59764-.64182-.19999-.41858-.19999-.90925.0-.53253.22324-.94645.22324-.41393.65345-.63484.32789-.16976.81623-.16976.63484.0.99064.26743.35812.2651.46044.73484l-.68368.1279q-.072088-.25115-.27208-.39532-.19766-.1465-.49532-.1465-.45114.0-.71856.28603-.2651.28603-.2651.84879.0.60694.26975.91157.26975.30231.70693.30231.21627.0.43253-.083716.21859-.086041.3744-.20696v-.43253z"/></g></svg></a></div><form class="td-sidebar__search d-flex align-items-center"><div class="td-search td-search--offline"><div class=td-search__icon></div><input type=search class="td-search__input form-control" placeholder=Search aria-label="Search this site…" autocomplete=off data-offline-search-index-json-src=/offline-search-index.351ad0c8c314c852d63901168e2ee902.json data-offline-search-base-href=/ data-offline-search-max-results=10></div></form><ul class=dark-mode-landing><li style=width:7.5em><div class=container><div class=toggle-mode><div class=icon><i class='fa-solid fa-sun' aria-hidden=true></i></div><div class='toggle-switch form-check form-switch'><label class=switch><input class=form-check-input type=checkbox role=switch id=dark-mode-toggle> <span class='slider round'></span></label></div><div class=icon><i class='fa fa-moon-o' aria-hidden=true></i></div></div></div></li></ul><button class="btn btn-link td-sidebar__toggle d-md-none p-3 ms-3 fas fa-bars" type=button data-bs-toggle=collapse data-bs-target=#td-section-nav aria-controls=td-section-nav aria-expanded=false aria-label="Toggle section navigation"></button><div class=ctrl-right><a href=javascript:void(0) onclick=hideRightMenu() id=menu-toggle aria-label="Hide right menu toggle"><i class="fa fa-indent" aria-hidden=true></i></a></div></div></nav></header><div class="container-fluid td-outer"><div class=td-main><div class=td-content><h1></h1><header class=article-meta></header><body id=landing class=landing><section class="container documentation sections"><div class="row justify-content-center"><div class="col-sm-6 col-md-11 col-lg-9 col-xl-12 col-xxl-12"><p class=resources_title>Documentation</p></div></div><div class="row justify-content-center"><div class="col-xs-12 col-sm-6 col-lg-4 card-holder"><a class=card href=./get_started><div class="landing_image get-started-icon"></div><h5 class=title>Get started</h5><p>Learn how to use Trading Economics API.</p></a></div><div class="col-xs-12 col-sm-6 col-lg-4 card-holder"><a class=card href=.//indicators/snapshot><div class="landing_image indicators-icon"></div><h5 class=title>Indicators</h5><p>Get more than 15,000 dataseries directly from official sources.</p></a></div><div class="col-xs-12 col-sm-6 col-lg-4 card-holder"><a class=card href=.//economic_calendar/snapshot><div class="landing_image calendar-icon"></div><h5 class=title>Economic Calendar</h5><p>Get around 1600 economic events for more than 150 countries a month.</p></a></div><div class="col-xs-12 col-sm-6 col-lg-4 card-holder"><a class=card href=.//markets/snapshot><div class="landing_image markets-icon"></div><h5 class=title>Markets</h5><p>Get a list of available commodities, currencies, indexes or bonds and their latest values.</p></a></div><div class="col-xs-12 col-sm-6 col-lg-4 card-holder"><a class=card href=.//financials/snapshot><div class="landing_image financials-icon"></div><h5 class=title>Financials</h5><p>Get stocks earnings and fundamental information.</p></a></div><div class="col-xs-12 col-sm-6 col-lg-4 card-holder"><a class=card href=.//forecasts/indicators><div class="landing_image forecasts-icon"></div><h5 class=title>Forecasts</h5><p>Get forecasts built using a proprietary global macro model.</p></a></div></div></section><section class="container resources mb-4"><div class="row justify-content-center"><div class="col-sm-6 col-md-11 col-lg-9 col-xl-12 col-xxl-12 pt-5"><p class=resources_title>Resources</p></div></div><div class="row justify-content-center"><div class="col-xs-12 col-sm-6 col-md-4 card-holder"><a href=./excel class="card card-sm" target=_blank rel=noopener><h5 class=title>Excel Add-In</h5><p>The Trading Economics Excel Add-In lets you access our data directly from any spreadsheet.</p></a></div><div class="col-xs-12 col-sm-6 col-md-4 card-holder"><a href=./google-sheet class="card card-sm" target=_blank rel=noopener><h5 class=title>Google Sheets Add-On</h5><p>Add The Trading Economics extension in your Google Sheet project.</p></a></div><div class="col-xs-12 col-sm-6 col-md-4 card-holder"><a href=https://github.com/tradingeconomics/tradingeconomics class="card card-sm" target=_blank rel=noopener><h5 class=title>GitHub Examples</h5><p>Open Source samples available in different programming languages.</p></a></div><div class="col-xs-12 col-sm-6 col-md-4 card-holder"><a href=https://github.com/tradingeconomics/tradingeconomics-python class="card card-sm" target=_blank rel=noopener><h5 class=title>Python Package</h5><p>The Trading Economics Python package makes it easy to integrate our data in any application.</p></a></div><div class="col-xs-12 col-sm-6 col-md-4 card-holder"><a href=https://github.com/tradingeconomics/tradingeconomics-js class="card card-sm" target=_blank rel=noopener><h5 class=title>NodeJS NPM</h5><p>NPM package for NodeJS integration</p></a></div><div class="col-xs-12 col-sm-6 col-md-4 card-holder"><a href=https://github.com/tradingeconomics/tradingeconomics/tree/master/R class="card card-sm" target=_blank rel=noopener><h5 class=title>R library</h5><p>R version of Trading Economics API library</p></a></div><div class="col-xs-12 col-sm-6 col-md-4 card-holder"><a href=https://github.com/tradingeconomics/notebooks class="card card-sm" target=_blank rel=noopener><h5 class=title>Notebooks</h5><p>Collection of Jupyter Notebooks by Trading Economics.</p></a></div><div class="col-xs-12 col-sm-6 col-md-4 card-holder"><a href=https://hub.docker.com/u/tradingeconomics class="card card-sm" target=_blank rel=noopener><h5 class=title>Docker</h5><p>Public Docker containers to get you started with our API faster.</p></a></div><div class="col-xs-12 col-sm-6 col-md-4 card-holder"><a href=./tableau class="card card-sm" target=_blank rel=noopener><h5 class=title>Tableau</h5><p>Interact with Trading Economics data using our plugin for Tableau.</p></a></div><div class="col-xs-12 col-sm-6 col-md-4 card-holder"><a href=https://www.mathworks.com/matlabcentral/fileexchange/101288-trading-economics class="card card-sm" target=_blank rel=noopener><h5 class=title>Matlab</h5><p>Trading Economics data integration with Matlab</p></a></div><div class="col-xs-12 col-sm-6 col-md-4 card-holder"><a href=https://github.com/smartcontractkit/external-adapters-js/tree/develop/packages/sources/tradingeconomics class="card card-sm" target=_blank rel=noopener><h5 class=title>Blockchain</h5><p>Chainlink Oracle External Adapter for Trading Economics</p></a></div></div></section></body><style>#navbar{width:75rem}.ctrl-right,.td-sidebar__toggle,.navbar .td-sidebar__search{display:none!important}#landing{margin-top:2em}</style></div></div><script src=/scripts/functions.js></script> <script src=/scripts/jqueryFunctions.js></script> <link href='https://fonts.googleapis.com/css?family=Roboto' rel=stylesheet><link href=/scss/_dark_project.css rel=stylesheet id=dark-mode-theme disabled><script src=https://kit.fontawesome.com/077204b73e.js crossorigin=anonymous></script><div><footer class="row te-footer"><div><div class=container><div class=row><div class="col-md-2 col-sm-6 col-6"><div class=footerHeader>Indicators</div><a id=ctl00_Footer1_HyperLink6 class=footerItems href=https://tradingeconomics.com/>Homepage</a><br><a id=ctl00_Footer1_HyperLink17 class=footerItems href=https://tradingeconomics.com/countries>Countries</a><br><a id=ctl00_Footer1_HyperLink18 class=footerItems href=https://tradingeconomics.com/indicators>Indicators</a><br><a id=ctl00_Footer1_HyperLink1 class=footerItems href=https://tradingeconomics.com/calendar>Calendar</a><br><a id=ctl00_Footer1_HyperLink2 class=footerItems href=https://tradingeconomics.com/forecasts>Forecasts</a><br><a id=ctl00_Footer1_HyperLink11 class=footerItems href=https://tradingeconomics.com/country-list/rating>Ratings</a></div><div class="col-md-2 col-sm-6 col-6"><div class=footerHeader>Solutions</div><a href="https://tradingeconomics.com/analytics/features.aspx?source=footer"><span class=footerItems>Data Subscriptions</span></a><br><a href="https://tradingeconomics.com/api/?source=footer"><span class=footerItems>API Access</span></a><br><a href=https://tradingeconomics.com/analytics/excel.aspx><span class=footerItems>Excel Add-In</span></a><br><a href=https://developer.tradingeconomics.com/ target=_blank><span class=footerItems>Developer Account</span></a><br><a href=/ target=_blank><span class=footerItems>Documentation</span></a><br><a href="https://tradingeconomics.com/analytics/pricing.aspx?source=footer" target=_blank><span class=footerItems>Pricing</span></a><br><br></div><div class="col-md-2 col-sm-6 col-6"><div class=footerHeader>About Us</div><a id=ctl00_Footer1_HyperLink8 class=footerItems href=https://tradingeconomics.com/api/customers.aspx>Customers</a><br><a id=ctl00_Footer1_HyperLink23 class=footerItems href=https://tradingeconomics.com/careers.aspx>Careers</a><br><a id=ctl00_Footer1_HyperLink21 class=footerItems href=https://tradingeconomics.com/investors.aspx>Investors</a><br><a id=ctl00_Footer1_HyperLink20 class=footerItems href=https://tradingeconomics.com/advertise.aspx>Advertisers</a><br><a id=ctl00_Footer1_HyperLink19 class=footerItems href=https://tradingeconomics.com/about-te.aspx>About us</a><br><a id=ctl00_Footer1_HyperLink9 class=footerItems href=https://tradingeconomics.com/privacy-policy.aspx>Privacy</a></div><div class="col-md-2 col-sm-6 col-6"><div class=footerHeader>Follow Us</div><a href=https://www.twitter.com/teconomics><span class=footerItems>Twitter</span></a><br><a href="https://itunes.apple.com/us/app/trading-economics/id1142178921?mt=8"><span class=footerItems>App Store</span></a><br><a href="https://play.google.com/store/apps/details?id=com.tradingeconomics.calendar"><span class=footerItems>Google Play</span></a><br><a href=https://tradingeconomics.com/rss/><span class=footerItems>RSS</span></a><br><a href=https://github.com/tradingeconomics/tradingeconomics><span class=footerItems>GitHub</span></a><br><br><br></div></div></div><div class="container footer-copyright"><span>Copyright © <span id=year></span> TRADING ECONOMICS<br>All Rights Reserved</span></div></div></footer></div><script>document.getElementById("year").innerHTML=(new Date).getFullYear()</script></div><script src=/js/main.min.2b36c43178e052147a3a1b516562de76944035ca33e816c2f2e455c21b832a2a.js integrity="sha256-KzbEMXjgUhR6OhtRZWLedpRANcoz6BbC8uRVwhuDKio=" crossorigin=anonymous></script> <script src=/js/tabpane-persist.js></script></body></html>