Available Indicators and Countries

This endpoint provides a list of available indicators (such as economic indicators or financial metrics) and the countries for which data is available.

List indicators

Using Requests:

import requests
your_api_key = 'your_api_key'
url = f'https://api.tradingeconomics.com/indicators?c={your_api_key}'
data = requests.get(url).json()
print(data)

Or using our package:

import tradingeconomics as te
te.login('your_api_key')
te.getIndicatorData()

Using Requests:

const axios = require('axios');
(async () => {
    const your_api_key = 'your_api_key'
    const response = await axios.get(`https://api.tradingeconomics.com/indicators?c=${your_api_key}`)
    console.log(response.data)
})()

Or using our package:

const te = require('tradingeconomics');
te.login('your_api_key');
data = te.getIndicatorData().then(function(data){
  console.log(data)  
});

Using Requests:

using (var httpClient = new HttpClient())
{
    using (var request = new HttpRequestMessage(new HttpMethod("GET"), "https://api.tradingeconomics.com/indicators?c=your_api_key"))
    {
        request.Headers.TryAddWithoutValidation("Upgrade-Insecure-Requests", "1");
        var response = await httpClient.SendAsync(request);
        if (response.IsSuccessStatusCode)
        {
            var content = await response.Content.ReadAsStringAsync(); 
            Console.WriteLine(content);
        }
    }
}

Add the flag calendar=1 to show only indicators available on calendar:

import requests
your_api_key = 'your_api_key'
url = f'https://api.tradingeconomics.com/indicators?c={your_api_key}&calendar=1'
data = requests.get(url).json()
print(data)

const axios = require('axios');
(async () => {
    const your_api_key = 'your_api_key'
    const response = await axios.get(`https://api.tradingeconomics.com/indicators?c=${your_api_key}&calendar=1`)
    console.log(response.data)
})()

using (var httpClient = new HttpClient())
{
    using (var request = new HttpRequestMessage(new HttpMethod("GET"), "https://api.tradingeconomics.com/indicators?c=your_api_key&calendar=1"))
    {
        request.Headers.TryAddWithoutValidation("Upgrade-Insecure-Requests", "1");
        var response = await httpClient.SendAsync(request);
        if (response.IsSuccessStatusCode)
        {
            var content = await response.Content.ReadAsStringAsync(); 
            Console.WriteLine(content);
        }
    }
}

The response data format can be configured by appending the &f= parameter to the URL request.

https://api.tradingeconomics.com/indicators?c={your_api_key}&f=json

[
  {
    "Category": "1 Year MLF Rate",
    "CategoryGroup": "Money"
  },
  {
    "Category": "14-Day Reverse Repo Rate",
    "CategoryGroup": "Money"
  },
  {
    "Category": "15 Year Mortgage Rate",
    "CategoryGroup": "Housing"
  }
]

https://api.tradingeconomics.com/indicators?c={your_api_key}&f=csv

Category,CategoryGroup
1 Year MLF Rate,Money
14-Day Reverse Repo Rate,Money
15 Year Mortgage Rate,Housing

https://api.tradingeconomics.com/indicators?c={your_api_key}&f=xml

<ArrayOfIndicator xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/API.Models">
<Indicator>
<Category>1 Year MLF Rate</Category>
<CategoryGroup>Money</CategoryGroup>
</Indicator>
<Indicator>
<Category>14-Day Reverse Repo Rate</Category>
<CategoryGroup>Money</CategoryGroup>
</Indicator>
<Indicator>
<Category>15 Year Mortgage Rate</Category>
<CategoryGroup>Housing</CategoryGroup>
</Indicator>
</ArrayOfIndicator>

https://api.tradingeconomics.com/indicators?c={your_api_key}

Category	CategoryGroup
1 Year MLF Rate	Money
14-Day Reverse Repo Rate	Money
15 Year Mortgage Rate	Housing

List countries

Using Requests:

import requests
your_api_key = 'your_api_key'
url = f'https://api.tradingeconomics.com/country?c={your_api_key}'
data = requests.get(url).json()
print(data)

Or using our package:

te.getAllCountries()

Using Requests:

const axios = require('axios');
(async () => {
    const your_api_key = 'your_api_key'
    const response = await axios.get(`https://api.tradingeconomics.com/country?c=${your_api_key}`)
    console.log(response.data)
})()

Or using our package:

data = te.getAllCountries().then(function(data){
  console.log(data)       
});

Using Requests:

new HttpRequestMessage(new HttpMethod("GET"), "https://api.tradingeconomics.com/country?c=your_api_key");

https://api.tradingeconomics.com/country?c={your_api_key}&f=json

[
  {
    "Country": "Afghanistan",
    "Continent": "Asia",
    "Group": "Asia",
    "ISO3": "AFG",
    "ISO2": "AF"
  },
  {
    "Country": "Albania",
    "Continent": "Europe",
    "Group": "Europe",
    "ISO3": "ALB",
    "ISO2": "AL"
  },
  {
    "Country": "Algeria",
    "Continent": "Africa",
    "Group": "North Africa, OPEC",
    "ISO3": "DZA",
    "ISO2": "DZ"
  }
]

https://api.tradingeconomics.com/country?c={your_api_key}&f=csv

Country,Continent,Group,ISO3,ISO2
Afghanistan,Asia,Asia,AFG,AF
Albania,Europe,Europe,ALB,AL
Algeria,Africa,"North Africa, OPEC",DZA,DZ

https://api.tradingeconomics.com/country?c={your_api_key}&f=xml

<ArrayOfCountryData xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/API.Models">
<CountryData>
<Continent>Asia</Continent>
<Country>Afghanistan</Country>
<Group>Asia</Group>
<ISO2>AF</ISO2>
<ISO3>AFG</ISO3>
</CountryData>
<CountryData>
<Continent>Europe</Continent>
<Country>Albania</Country>
<Group>Europe</Group>
<ISO2>AL</ISO2>
<ISO3>ALB</ISO3>
</CountryData>
<CountryData>
<Continent>Africa</Continent>
<Country>Algeria</Country>
<Group>North Africa, OPEC</Group>
<ISO2>DZ</ISO2>
<ISO3>DZA</ISO3>
</CountryData>
</ArrayOfCountryData>

https://api.tradingeconomics.com/country?c={your_api_key}

Country	Continent	Group	ISO3	ISO2
Afghanistan	Asia	Asia	AFG	AF
Albania	Europe	Europe	ALB	AL
Algeria	Africa	“North Africa, OPEC”	DZA	DZ

Response fields

Fields available in ‘List indicators’

Field	Type	Description	Example
Category	string	Name of the economic or statistical category.	“Auto Exports”,
CategoryGroup	string	Higher-level grouping or classification of the category.	“Trade”

Fields available in ‘List Countries’

Field	Type	Description	Example
Country	string	Full name of the country associated with the data.	“Algeria”
Continent	string	Continent where the country is located.	“Africa”
Group	string	Regional or organizational group(s) the country belongs to.	“North Africa, OPEC”
ISO3	string	ISO 3166-1 alpha-3 code (three-letter country code)	“DZA”
ISO2	string	ISO 3166-1 alpha-2 code (two-letter country code)	“DZ”