Credit Ratings

Country credit ratings, also known as sovereign credit ratings, are assessments of the creditworthiness or credit risk of a country’s government. These ratings are assigned by credit rating agencies, such as Standard & Poor’s (S&P) and Moody’s.

Latest

Using Requests:

import requests
api_key = 'YOUR_API_KEY'
url = f'https://api.tradingeconomics.com/credit-ratings?c={api_key}'
data = requests.get(url).json()
print(data)

Or using our package:

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

Using Requests:

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

Or using our package:

const te = require('tradingeconomics');
te.login('your_api_key');
data = te.getCreditRatings().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/credit-ratings?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);
        }
    }
}

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

/credit-ratings

CountryDateAgencyRatingOutlook
Kazakhstan10/27/2023Moody’sBaa2Positive
Isle of Man10/27/2023Moody’sAa3Stable
Costa Rica10/27/2023S&PBB-Stable

/credit-ratings?f=json

[{"Country":"Kazakhstan","Date":"10/27/2023","Agency":"Moody's","Rating":"Baa2","Outlook":"Positive"},{"Country":"Isle of Man","Date":"10/27/2023","Agency":"Moody's","Rating":"Aa3","Outlook":"Stable"},{"Country":"Costa Rica","Date":"10/27/2023","Agency":"S&P","Rating":"BB-","Outlook":"Stable"}]

/credit-ratings?f=csv

Country,Date,Agency,Rating,Outlook
Kazakhstan,10/27/2023,Moody's,Baa2,Positive
Isle of Man,10/27/2023,Moody's,Aa3,Stable
Costa Rica,10/27/2023,S&P,BB-,Stable

/credit-ratings?f=xml

<ArrayOfRatingsData xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/API.Models">
<RatingsHistoricalData>
<Agency>Moody's</Agency>
<Country>Kazakhstan</Country>
<Date>10/27/2023</Date>
<Outlook>Positive</Outlook>
<Rating>Baa2</Rating>
</RatingsHistoricalData>
<RatingsHistoricalData>
<Agency>Moody's</Agency>
<Country>Isle of Man</Country>
<Date>10/27/2023</Date>
<Outlook>Stable</Outlook>
<Rating>Aa3</Rating>
</RatingsHistoricalData>
<RatingsHistoricalData>
<Agency>S&P</Agency>
<Country>Costa Rica</Country>
<Date>10/27/2023</Date>
<Outlook>Stable</Outlook>
<Rating>BB-</Rating>
</RatingsHistoricalData>
</ArrayOfRatingsData>

By country

Using Requests:

import requests
api_key = 'YOUR_API_KEY'
url = f'https://api.tradingeconomics.com/credit-ratings/country/sweden?c={api_key}'
data = requests.get(url).json()
print(data)

Or using our package:

te.getCreditRatings(country= 'sweden')

With multi countries

te.getCreditRatings(country=['mexico','sweden'])

Using Requests:

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

Or using our package:

data = te.getCreditRatings(country = 'sweden').then(function(data){
  console.log(data)       
});

With multi countries

data = te.getCreditRatings(country = ['mexico', 'sweden']).then(function(data){
  console.log(data)       
});

Using Requests:

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

With multi countries

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

/credit-ratings/country/{country}

CountryDateAgencyRatingOutlook
Sweden4/17/2012DBRSAAAStable
Sweden2/16/2004S&PAAAStable
Sweden4/4/2002Moody’sAaaStable

/credit-ratings/country/{country}?f=json

[{"Country":"Sweden","Date":"4/17/2012","Agency":"DBRS","Rating":"AAA","Outlook":"Stable"},{"Country":"Sweden","Date":"2/16/2004","Agency":"S&P","Rating":"AAA","Outlook":"Stable"},{"Country":"Sweden","Date":"4/4/2002","Agency":"Moody's","Rating":"Aaa","Outlook":"Stable"}]

/credit-ratings/country/{country}?f=csv

Country,Date,Agency,Rating,Outlook
Sweden,4/17/2012,DBRS,AAA,Stable
Sweden,2/16/2004,S&P,AAA,Stable
Sweden,4/4/2002,Moody's,Aaa,Stable

/credit-ratings/country/{country}?f=xml

<ArrayOfRatingsHistoricalData xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/API.Models">
<RatingsHistoricalData>
<Agency>DBRS</Agency>
<Country>Sweden</Country>
<Date>4/17/2012</Date>
<Outlook>Stable</Outlook>
<Rating>AAA</Rating>
</RatingsHistoricalData>
<RatingsHistoricalData>
<Agency>S&P</Agency>
<Country>Sweden</Country>
<Date>2/16/2004</Date>
<Outlook>Stable</Outlook>
<Rating>AAA</Rating>
</RatingsHistoricalData>
<RatingsHistoricalData>
<Agency>Moody's</Agency>
<Country>Sweden</Country>
<Date>4/4/2002</Date>
<Outlook>Stable</Outlook>
<Rating>Aaa</Rating>
</RatingsHistoricalData>
</ArrayOfRatingsHistoricalData>

Historical

Using Requests:

import requests
api_key = 'YOUR_API_KEY'
url = f'https://api.tradingeconomics.com/credit-ratings/historical?d1=2022-01-01&d2=2023-01-01&c={api_key}'
data = requests.get(url).json()
print(data)

Or using our package:

te.getHistoricalCreditRatings(initDate='2022-01-01', 
 endDate='2023-01-01')

Using Requests:

const axios = require('axios');
(async () => {
    const api_key = 'YOUR_API_KEY'
    const response = await axios.get(`https://api.tradingeconomics.com/credit-ratings/historical?d1=2022-01-01&d2=2023-01-01&c=${api_key}`)
    console.log(response.data)
})()

Or using our package:

data = te.getHistoricalCreditRatings(start_date = '2022-01-01', 
    end_date = '2023-01-01').then(function(data){
  console.log(data)       
});

Using Requests:

new HttpRequestMessage(new HttpMethod("GET"), "https://api.tradingeconomics.com/credit-ratings/historical?d1=2022-01-01&d2=2023-01-01&c=your_api_key");

/credit-ratings/historical?d1={yyyy-mm-dd}/d2={yyyy-mm-dd}

CountryDateAgencyRatingOutlook
Mexico7/8/2022Moody’sBaa2Stable
Mexico7/6/2022S&PBBBStable
Sweden4/17/2012DBRSAAAStable

/credit-ratings/historical?d1={yyyy-mm-dd}/d2={yyyy-mm-dd}&f=json

[{"Country":"Mexico","Date":"7/8/2022","Agency":"Moody's","Rating":"Baa2","Outlook":"Stable"},{"Country":"Mexico","Date":"7/6/2022","Agency":"S&P","Rating":"BBB","Outlook":"Stable"},{"Country":"Mexico","Date":"5/6/2021","Agency":"DBRS","Rating":"BBB","Outlook":"Stable"},{"Country":"Mexico","Date":"5/6/2020","Agency":"DBRS","Rating":"BBB","Outlook":"Negative"},
{"Country":"Sweden","Date":"3/8/2004","Agency":"Fitch","Rating":"AAA","Outlook":"Stable"},{"Country":"Sweden","Date":"2/16/2004","Agency":"S&P","Rating":"AAA","Outlook":"Stable"}]

/credit-ratings/historical?d1={yyyy-mm-dd}/d2={yyyy-mm-dd}&f=csv

Country,Date,Agency,Rating,Outlook
Mexico,7/8/2022,Moody's,Baa2,Stable
Mexico,7/6/2022,S&P,BBB,Stable
Mexico,5/6/2021,DBRS,BBB,Stable

/credit-ratings/historical?d1={yyyy-mm-dd}/d2={yyyy-mm-dd}&f=xml

<ArrayOfRatingsHistoricalData xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/API.Models">
<RatingsHistoricalData>
<Agency>Moody's</Agency>
<Country>Mexico</Country>
<Date>7/8/2022</Date>
<Outlook>Stable</Outlook>
<Rating>Baa2</Rating>
</RatingsHistoricalData>
<RatingsHistoricalData>
<Agency>S&P</Agency>
<Country>Mexico</Country>
<Date>7/6/2022</Date>
<Outlook>Stable</Outlook>
<Rating>BBB</Rating>
</RatingsHistoricalData>
<RatingsHistoricalData>
<Agency>DBRS</Agency>
<Country>Mexico</Country>
<Date>5/6/2021</Date>
<Outlook>Stable</Outlook>
<Rating>BBB</Rating>
</RatingsHistoricalData>
</ArrayOfRatingsHistoricalData>

Historical by country and date

Using Requests:

import requests
api_key = 'YOUR_API_KEY'
url = f'https://api.tradingeconomics.com/credit-ratings/historical/country/sweden?d1=2000-01-01&d2=2023-01-01?c={api_key}'
data = requests.get(url).json()
print(data)

Or using our package:

te.getHistoricalCreditRatings(country='sweden', initDate='2000-01-01', 
 endDate='2023-01-01')

Using Requests:

const axios = require('axios');
(async () => {
    const api_key = 'YOUR_API_KEY'
    const response = await axios.get(`https://api.tradingeconomics.com/credit-ratings/historical/country/sweden?d1=2000-01-01&d2=2023-01-01?c=${api_key}`)
    console.log(response.data)
})()

Or using our package:

data = te.getHistoricalCreditRatings(historical = 'sweden', 
 start_date = '2023-01-01', end_date = '2000-01-01').then(function(data){
  console.log(data)       
});

Using Requests:

new HttpRequestMessage(new HttpMethod("GET"), "https://api.tradingeconomics.com/credit-ratings/historical/country/sweden?d1=2000-01-01&d2=2023-01-01?c=your_api_key");

/credit-ratings/historical/country/{country}/d1={yyyy-mm-dd}/d2={yyyy-mm-dd}

CountryDateAgencyRatingOutlook
Sweden4/17/2012DBRSAAAStable
Sweden2/16/2004S&PAAAStable
Sweden4/4/2002Moody’sAaaStable

/credit-ratings/historical/country/{country}/d1={yyyy-mm-dd}/d2={yyyy-mm-dd}?f=json

[{"Country":"Sweden","Date":"4/17/2012","Agency":"DBRS","Rating":"AAA","Outlook":"Stable"},{"Country":"Sweden","Date":"2/16/2004","Agency":"S&P","Rating":"AAA","Outlook":"Stable"},{"Country":"Sweden","Date":"4/4/2002","Agency":"Moody's","Rating":"Aaa","Outlook":"Stable"},{"Country":"Sweden","Date":"7/24/2000","Agency":"S&P","Rating":"AA+","Outlook":"Positive"}]

/credit-ratings/historical/country/{country}/d1={yyyy-mm-dd}/d2={yyyy-mm-dd}?f=csv

Country,Date,Agency,Rating,Outlook
Sweden,4/17/2012,DBRS,AAA,Stable
Sweden,2/16/2004,S&P,AAA,Stable
Sweden,4/4/2002,Moody's,Aaa,Stable

/credit-ratings/historical/country/{country}/d1={yyyy-mm-dd}/d2={yyyy-mm-dd}?f=xml

<ArrayOfRatingsHistoricalData xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/API.Models">
<RatingsHistoricalData>
<Agency>DBRS</Agency>
<Country>Sweden</Country>
<Date>4/17/2012</Date>
<Outlook>Stable</Outlook>
<Rating>AAA</Rating>
</RatingsHistoricalData>
<RatingsHistoricalData>
<Agency>S&P</Agency>
<Country>Sweden</Country>
<Date>2/16/2004</Date>
<Outlook>Stable</Outlook>
<Rating>AAA</Rating>
</RatingsHistoricalData>
<RatingsHistoricalData>
<Agency>Moody's</Agency>
<Country>Sweden</Country>
<Date>4/4/2002</Date>
<Outlook>Stable</Outlook>
<Rating>Aaa</Rating>
</RatingsHistoricalData>
</ArrayOfRatingsHistoricalData>

Response fields

FieldTypeDescriptionExample
CountrystringCountry name“Mexico”
DatestringRelease time and date in UTC“12/19/2013”
AgencystringRating agency“S&P”
RatingstringRating score“BBB+”
OutlookstringRating outlook“Stable”