Peers
In terms of economic data, peers are typically countries or regions that share similar economic characteristics, such as GDP growth rates, industry composition, demographic profiles, or policy frameworks.
By ticker
Using Requests:
import requests
api_key = 'YOUR_API_KEY'
url = f'https://api.tradingeconomics.com/peers/CPI%20YOY?c={api_key}'
data = requests.get(url).json()
print(data)
Or using our package:
import tradingeconomics as te
te.login('your_api_key')
te.getPeers(ticker='CPI YOY')
Using Requests:
const axios = require('axios');
(async () => {
const api_key = 'YOUR_API_KEY'
const response = await axios.get(`https://api.tradingeconomics.com/peers/CPI%20YOY?c=${api_key}`)
console.log(response.data)
})()
Or using our package:
const te = require('tradingeconomics');
te.login('your_api_key');
data = te.getPeers(ticker = 'CPI YOY').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/peers/CPI%20YOY?c=guest:guest"))
{
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.
Ticker | Peer | Relationship | Country | Category | Title | LatestValueDate | LatestValue | Source | SourceURL | Unit | URL | CategoryGroup | Adjustment | Frequency | HistoricalDataSymbol | CreateDate | FirstValueDate | PreviousValue | PreviousValueDate |
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
CPI YOY | TEDSTACONPRIINDCP | 0 | United States | Consumer Price Index CPI | United States Consumer Price Index (CPI) | 5/31/2023 12:00:00 AM | 304.13 | U.S. Bureau of Labor Statistics | http://www.bls.gov | points | /united-states/consumer-price-index-cpi | Prices | “1982-1984=100, NSA” | Monthly | UNITEDSTACONPRIINDCP | 6/11/2014 9:44:00 AM | 1/31/1950 12:00:00 AM | 303.36 | 4/30/2023 12:00:00 AM |
CPI YOY | UNITEDSTACORCONPRI | 0 | United States | Core Consumer Prices | United States Core Consumer Prices | 5/31/2023 12:00:00 AM | 307.82 | U.S. Bureau of Labor Statistics | http://www.bls.gov | points | /united-states/core-consumer-prices | Prices | “1982-1984=100, SA” | Monthly | UNITEDSTACORCONPRI | 6/18/2013 4:46:00 PM | 1/31/1957 12:00:00 AM | 306.49 | 4/30/2023 12:00:00 AM |
CPI YOY | USACORECPIRATE | 1 | United States | Core Inflation Rate | United States Core Inflation Rate | 5/31/2023 12:00:00 AM | 5.30 | U.S. Bureau of Labor Statistics | https://www.bls.gov | percent | /united-states/core-inflation-rate | Prices | “1982-1984=100, NSA” | Monthly | USACORECPIRATE | 10/2/2012 2:16:00 PM | 2/28/1957 12:00:00 AM | 5.50 | 4/30/2023 12:00:00 AM |
[{"Ticker":"CPI YOY","Peer":"UNITEDSTACONPRIINDCP","Relationship":0,"Country":"United States","Category":"Consumer Price Index CPI","Title":"United States Consumer Price Index (CPI)","LatestValueDate":"2023-08-31T00:00:00","LatestValue":307.03,"Source":"U.S. Bureau of Labor Statistics","SourceURL":"http://www.bls.gov","Unit":"points","URL":"/united-states/consumer-price-index-cpi","CategoryGroup":"Prices","Adjustment":"1982-1984=100, NSA","Frequency":"Monthly","HistoricalDataSymbol":"UNITEDSTACONPRIINDCP","CreateDate":"2014-06-11T09:44:00","FirstValueDate":"1950-01-31T00:00:00","PreviousValue":305.69,"PreviousValueDate":"2023-07-31T00:00:00"},{"Ticker":"CPI YOY","Peer":"UNITEDSTACORCONPRI","Relationship":0,"Country":"United States","Category":"Core Consumer Prices","Title":"United States Core Consumer Prices","LatestValueDate":"2023-08-31T00:00:00","LatestValue":309.66,"Source":"U.S. Bureau of Labor Statistics","SourceURL":"http://www.bls.gov","Unit":"points","URL":"/united-states/core-consumer-prices","CategoryGroup":"Prices","Adjustment":"1982-1984=100, SA","Frequency":"Monthly","HistoricalDataSymbol":"UNITEDSTACORCONPRI","CreateDate":"2013-06-18T16:46:00","FirstValueDate":"1957-01-31T00:00:00","PreviousValue":308.80,"PreviousValueDate":"2023-07-31T00:00:00"},{"Ticker":"CPI YOY","Peer":"USACORECPIRATE","Relationship":1,"Country":"United States","Category":"Core Inflation Rate","Title":"United States Core Inflation Rate","LatestValueDate":"2023-08-31T00:00:00","LatestValue":4.30,"Source":"U.S. Bureau of Labor Statistics","SourceURL":"https://www.bls.gov","Unit":"percent","URL":"/united-states/core-inflation-rate","CategoryGroup":"Prices","Adjustment":"1982-1984=100, NSA","Frequency":"Monthly","HistoricalDataSymbol":"USACORECPIRATE","CreateDate":"2012-10-02T14:16:00","FirstValueDate":"1957-02-28T00:00:00","PreviousValue":4.70,"PreviousValueDate":"2023-07-31T00:00:00"}]
Ticker,Peer,Relationship,Country,Category,Title,LatestValueDate,LatestValue,Source,SourceURL,Unit,URL,CategoryGroup,Adjustment,Frequency,HistoricalDataSymbol,CreateDate,FirstValueDate,PreviousValue,PreviousValueDate
CPI YOY,UNITEDSTACONPRIINDCP,0,United States,Consumer Price Index CPI,United States Consumer Price Index (CPI),8/31/2023 12:00:00 AM,307.03,U.S. Bureau of Labor Statistics,http://www.bls.gov,points,/united-states/consumer-price-index-cpi,Prices,"1982-1984=100, NSA",Monthly,UNITEDSTACONPRIINDCP,6/11/2014 9:44:00 AM,1/31/1950 12:00:00 AM,305.69,7/31/2023 12:00:00 AM
CPI YOY,UNITEDSTACORCONPRI,0,United States,Core Consumer Prices,United States Core Consumer Prices,8/31/2023 12:00:00 AM,309.66,U.S. Bureau of Labor Statistics,http://www.bls.gov,points,/united-states/core-consumer-prices,Prices,"1982-1984=100, SA",Monthly,UNITEDSTACORCONPRI,6/18/2013 4:46:00 PM,1/31/1957 12:00:00 AM,308.80,7/31/2023 12:00:00 AM
CPI YOY,USACORECPIRATE,1,United States,Core Inflation Rate,United States Core Inflation Rate,8/31/2023 12:00:00 AM,4.30,U.S. Bureau of Labor Statistics,https://www.bls.gov,percent,/united-states/core-inflation-rate,Prices,"1982-1984=100, NSA",Monthly,USACORECPIRATE,10/2/2012 2:16:00 PM,2/28/1957 12:00:00 AM,4.70,7/31/2023 12:00:00 AM
<ArrayOfCountryIndicatorPeers xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/API.Models">
<CountryIndicatorPeers>
<Adjustment>1982-1984=100, NSA</Adjustment>
<Category>Consumer Price Index CPI</Category>
<CategoryGroup>Prices</CategoryGroup>
<Country>United States</Country>
<CreateDate>2014-06-11T09:44:00</CreateDate>
<FirstValueDate>1950-01-31T00:00:00</FirstValueDate>
<Frequency>Monthly</Frequency>
<HistoricalDataSymbol>UNITEDSTACONPRIINDCP</HistoricalDataSymbol>
<LatestValue>307.03</LatestValue>
<LatestValueDate>2023-08-31T00:00:00</LatestValueDate>
<Peer>UNITEDSTACONPRIINDCP</Peer>
<PreviousValue>305.69</PreviousValue>
<PreviousValueDate>2023-07-31T00:00:00</PreviousValueDate>
<Relationship>0</Relationship>
<Source>U.S. Bureau of Labor Statistics</Source>
<SourceURL>http://www.bls.gov</SourceURL>
<Ticker>CPI YOY</Ticker>
<Title>United States Consumer Price Index (CPI)</Title>
<URL>/united-states/consumer-price-index-cpi</URL>
<Unit>points</Unit>
</CountryIndicatorPeers>
<CountryIndicatorPeers>
<Adjustment>1982-1984=100, SA</Adjustment>
<Category>Core Consumer Prices</Category>
<CategoryGroup>Prices</CategoryGroup>
<Country>United States</Country>
<CreateDate>2013-06-18T16:46:00</CreateDate>
<FirstValueDate>1957-01-31T00:00:00</FirstValueDate>
<Frequency>Monthly</Frequency>
<HistoricalDataSymbol>UNITEDSTACORCONPRI</HistoricalDataSymbol>
<LatestValue>309.66</LatestValue>
<LatestValueDate>2023-08-31T00:00:00</LatestValueDate>
<Peer>UNITEDSTACORCONPRI</Peer>
<PreviousValue>308.80</PreviousValue>
<PreviousValueDate>2023-07-31T00:00:00</PreviousValueDate>
<Relationship>0</Relationship>
<Source>U.S. Bureau of Labor Statistics</Source>
<SourceURL>http://www.bls.gov</SourceURL>
<Ticker>CPI YOY</Ticker>
<Title>United States Core Consumer Prices</Title>
<URL>/united-states/core-consumer-prices</URL>
<Unit>points</Unit>
</CountryIndicatorPeers>
<CountryIndicatorPeers>
<Adjustment>1982-1984=100, NSA</Adjustment>
<Category>Core Inflation Rate</Category>
<CategoryGroup>Prices</CategoryGroup>
<Country>United States</Country>
<CreateDate>2012-10-02T14:16:00</CreateDate>
<FirstValueDate>1957-02-28T00:00:00</FirstValueDate>
<Frequency>Monthly</Frequency>
<HistoricalDataSymbol>USACORECPIRATE</HistoricalDataSymbol>
<LatestValue>4.30</LatestValue>
<LatestValueDate>2023-08-31T00:00:00</LatestValueDate>
<Peer>USACORECPIRATE</Peer>
<PreviousValue>4.70</PreviousValue>
<PreviousValueDate>2023-07-31T00:00:00</PreviousValueDate>
<Relationship>1</Relationship>
<Source>U.S. Bureau of Labor Statistics</Source>
<SourceURL>https://www.bls.gov</SourceURL>
<Ticker>CPI YOY</Ticker>
<Title>United States Core Inflation Rate</Title>
<URL>/united-states/core-inflation-rate</URL>
<Unit>percent</Unit>
</CountryIndicatorPeers>
</ArrayOfCountryIndicatorPeers>
By country and category
Using Requests:
import requests
api_key = 'YOUR_API_KEY'
url = f'https://api.tradingeconomics.com/peers/country/mexico/inflation%20rate?c={api_key}'
data = requests.get(url).json()
print(data)
Or using our package:
te.getPeers(country='mexico', category='inflation rate')
Using Requests:
const axios = require('axios');
(async () => {
const api_key = 'YOUR_API_KEY'
const response = await axios.get(`https://api.tradingeconomics.com/peers/country/mexico/inflation%20rate?c=${api_key}`)
console.log(response.data)
})()
Or using our package:
data = te.getPeers(country = 'mexico', category = 'inflation rate').then(function(data){
console.log(data)
});
Using Requests:
new HttpRequestMessage(new HttpMethod("GET"), "https://api.tradingeconomics.com/peers/country/mexico/inflation%20rate?c=guest:guest");
/peers/country/(country)/(category)
Ticker | Peer | Relationship | Country | Category | Title | LatestValueDate | LatestValue | Source | SourceURL | Unit | URL | CategoryGroup | Adjustment | Frequency | HistoricalDataSymbol | CreateDate | FirstValueDate | PreviousValue | PreviousValueDate |
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
MEXFRINRDPST | MEXFRINRDPST | -1 | Mexico | Deposit Interest Rate | Deposit Interest Rate in Mexico | 3/31/2023 12:00:00 AM | 4.57 | IMF | http://www.imf.org | percent | /mexico/deposit-interest-rate | inflation rate | Monthly | MEXFRINRDPST | 12/3/2015 2:37:00 PM | 1/31/1976 12:00:00 AM | 4.43 | 2/28/2023 12:00:00 AM | |
MEXICOBANBALSHE | MEXICOBANBALSHE | -1 | Mexico | Banks Balance Sheet | Mexico Banks Balance Sheet | 4/30/2023 12:00:00 AM | 10335903.02 | Banco de México | http://www.banxico.org.mx | MXN Million | /mexico/banks-balance-sheet | inflation rate | NSA | Monthly | MEXICOBANBALSHE | 9/8/2014 3:29:00 PM | 12/31/2000 12:00:00 AM | 10169075.64 | 3/31/2023 12:00:00 AM |
MEXICOBANBALSHE | MEXICOCENBANBALSHE | 0 | Mexico | Central Bank Balance Sheet | Mexico Central Bank Balance Sheet | 5/31/2023 12:00:00 AM | 4537124968.00 | Banco de México | http://www.banxico.org.mx/ | MXN Thousand | /mexico/central-bank-balance-sheet | inflation rate | NSA | Monthly | MEXICOCENBANBALSHE | 8/14/2014 5:50:00 PM | 12/31/1985 12:00:00 AM | 4515771451.00 | 4/30/2023 12:00:00 AM |
/peers/country/(country)/(category)?f=json
[{"Ticker":"MEXFRINRDPST","Peer":"MEXFRINRDPST","Relationship":-1,"Country":"Mexico","Category":"Deposit Interest Rate","Title":"Deposit Interest Rate in Mexico","LatestValueDate":"2023-07-31T00:00:00","LatestValue":4.95,"Source":"IMF","SourceURL":"https://www.imf.org","Unit":"percent","URL":"/mexico/deposit-interest-rate","CategoryGroup":"inflation rate","Adjustment":"","Frequency":"Monthly","HistoricalDataSymbol":"MEXFRINRDPST","CreateDate":"2015-12-03T14:37:00","FirstValueDate":"1976-01-31T00:00:00","PreviousValue":4.63,"PreviousValueDate":"2023-06-30T00:00:00"},{"Ticker":"MEXICOBANBALSHE","Peer":"MEXICOBANBALSHE","Relationship":-1,"Country":"Mexico","Category":"Banks Balance Sheet","Title":"Mexico Banks Balance Sheet","LatestValueDate":"2023-08-31T00:00:00","LatestValue":10702998.84,"Source":"Banco de México","SourceURL":"http://www.banxico.org.mx","Unit":"MXN Million","URL":"/mexico/banks-balance-sheet","CategoryGroup":"inflation rate","Adjustment":"NSA","Frequency":"Monthly","HistoricalDataSymbol":"MEXICOBANBALSHE","CreateDate":"2014-09-08T15:29:00","FirstValueDate":"2000-12-31T00:00:00","PreviousValue":10608854.67,"PreviousValueDate":"2023-07-31T00:00:00"},{"Ticker":"MEXICOBANBALSHE","Peer":"MEXICOCENBANBALSHE","Relationship":0,"Country":"Mexico","Category":"Central Bank Balance Sheet","Title":"Mexico Central Bank Balance Sheet","LatestValueDate":"2023-09-30T00:00:00","LatestValue":4204904816.00,"Source":"Banco de México","SourceURL":"https://www.banxico.org.mx/","Unit":"MXN Thousand","URL":"/mexico/central-bank-balance-sheet","CategoryGroup":"inflation rate","Adjustment":"NSA","Frequency":"Monthly","HistoricalDataSymbol":"MEXICOCENBANBALSHE","CreateDate":"2014-08-14T17:50:00","FirstValueDate":"1985-12-31T00:00:00","PreviousValue":4001809952.00,"PreviousValueDate":"2023-08-31T00:00:00"}]
/peers/country/(country)/(category)?f=csv
Ticker,Peer,Relationship,Country,Category,Title,LatestValueDate,LatestValue,Source,SourceURL,Unit,URL,CategoryGroup,Adjustment,Frequency,HistoricalDataSymbol,CreateDate,FirstValueDate,PreviousValue,PreviousValueDate
MEXFRINRDPST,MEXFRINRDPST,-1,Mexico,Deposit Interest Rate,Deposit Interest Rate in Mexico,7/31/2023 12:00:00 AM,4.95,IMF,https://www.imf.org,percent,/mexico/deposit-interest-rate,inflation rate,,Monthly,MEXFRINRDPST,12/3/2015 2:37:00 PM,1/31/1976 12:00:00 AM,4.63,6/30/2023 12:00:00 AM
MEXICOBANBALSHE,MEXICOBANBALSHE,-1,Mexico,Banks Balance Sheet,Mexico Banks Balance Sheet,8/31/2023 12:00:00 AM,10702998.84,Banco de México,http://www.banxico.org.mx,MXN Million,/mexico/banks-balance-sheet,inflation rate,NSA,Monthly,MEXICOBANBALSHE,9/8/2014 3:29:00 PM,12/31/2000 12:00:00 AM,10608854.67,7/31/2023 12:00:00 AM
MEXICOBANBALSHE,MEXICOCENBANBALSHE,0,Mexico,Central Bank Balance Sheet,Mexico Central Bank Balance Sheet,9/30/2023 12:00:00 AM,4204904816.00,Banco de México,https://www.banxico.org.mx/,MXN Thousand,/mexico/central-bank-balance-sheet,inflation rate,NSA,Monthly,MEXICOCENBANBALSHE,8/14/2014 5:50:00 PM,12/31/1985 12:00:00 AM,4001809952.00,8/31/2023 12:00:00 AM
/peers/country/(country)/(category)?f=xml
<ArrayOfCountryIndicatorPeers xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/API.Models">
<CountryIndicatorPeers>
<Adjustment/>
<Category>Deposit Interest Rate</Category>
<CategoryGroup>inflation rate</CategoryGroup>
<Country>Mexico</Country>
<CreateDate>2015-12-03T14:37:00</CreateDate>
<FirstValueDate>1976-01-31T00:00:00</FirstValueDate>
<Frequency>Monthly</Frequency>
<HistoricalDataSymbol>MEXFRINRDPST</HistoricalDataSymbol>
<LatestValue>4.95</LatestValue>
<LatestValueDate>2023-07-31T00:00:00</LatestValueDate>
<Peer>MEXFRINRDPST</Peer>
<PreviousValue>4.63</PreviousValue>
<PreviousValueDate>2023-06-30T00:00:00</PreviousValueDate>
<Relationship>-1</Relationship>
<Source>IMF</Source>
<SourceURL>https://www.imf.org</SourceURL>
<Ticker>MEXFRINRDPST</Ticker>
<Title>Deposit Interest Rate in Mexico</Title>
<URL>/mexico/deposit-interest-rate</URL>
<Unit>percent</Unit>
</CountryIndicatorPeers>
<CountryIndicatorPeers>
<Adjustment>NSA</Adjustment>
<Category>Banks Balance Sheet</Category>
<CategoryGroup>inflation rate</CategoryGroup>
<Country>Mexico</Country>
<CreateDate>2014-09-08T15:29:00</CreateDate>
<FirstValueDate>2000-12-31T00:00:00</FirstValueDate>
<Frequency>Monthly</Frequency>
<HistoricalDataSymbol>MEXICOBANBALSHE</HistoricalDataSymbol>
<LatestValue>10702998.84</LatestValue>
<LatestValueDate>2023-08-31T00:00:00</LatestValueDate>
<Peer>MEXICOBANBALSHE</Peer>
<PreviousValue>10608854.67</PreviousValue>
<PreviousValueDate>2023-07-31T00:00:00</PreviousValueDate>
<Relationship>-1</Relationship>
<Source>Banco de México</Source>
<SourceURL>http://www.banxico.org.mx</SourceURL>
<Ticker>MEXICOBANBALSHE</Ticker>
<Title>Mexico Banks Balance Sheet</Title>
<URL>/mexico/banks-balance-sheet</URL>
<Unit>MXN Million</Unit>
</CountryIndicatorPeers>
<CountryIndicatorPeers>
<Adjustment>NSA</Adjustment>
<Category>Central Bank Balance Sheet</Category>
<CategoryGroup>inflation rate</CategoryGroup>
<Country>Mexico</Country>
<CreateDate>2014-08-14T17:50:00</CreateDate>
<FirstValueDate>1985-12-31T00:00:00</FirstValueDate>
<Frequency>Monthly</Frequency>
<HistoricalDataSymbol>MEXICOCENBANBALSHE</HistoricalDataSymbol>
<LatestValue>4204904816.00</LatestValue>
<LatestValueDate>2023-09-30T00:00:00</LatestValueDate>
<Peer>MEXICOCENBANBALSHE</Peer>
<PreviousValue>4001809952.00</PreviousValue>
<PreviousValueDate>2023-08-31T00:00:00</PreviousValueDate>
<Relationship>0</Relationship>
<Source>Banco de México</Source>
<SourceURL>https://www.banxico.org.mx/</SourceURL>
<Ticker>MEXICOBANBALSHE</Ticker>
<Title>Mexico Central Bank Balance Sheet</Title>
<URL>/mexico/central-bank-balance-sheet</URL>
<Unit>MXN Thousand</Unit>
</CountryIndicatorPeers>
</ArrayOfCountryIndicatorPeers>
Response fields
Field | Type | Description | Example |
---|---|---|---|
Ticker | string | Ticker code | “CPI YOY” |
Peer | string | Related ticker | “MEXFRINRDPST” |
Relationship | number | -1 - itself, 0 - related, 1 - component, 2 - parent, 3 - derivative | 0 |
Country | string | Country name | “Mexico” |
Category | string | Category name | “Deposit Interest Rate” |
Title | string | Combination of country/category | “Deposit Interest Rate in Mexico” |
LatestValueDate | string | Date of the last released value | “2023-01-31T00:00:00” |
LatestValue | number | Last released value | 4.19 |
Source | string | Source of the data | “IMF” |
SourceURL | string | URL link of the source | “https://www.imf.org” |
Unit | string | Unit of the value | “percent” |
URL | string | Hyperlink at Trading Economics | “/mexico/deposit-interest-rate” |
CategoryGroup | string | Category group name | “inflation rate” |
Adjustment | string | Data description, for example: base period, price adjustment, seasonality | “1982-1984=100, NSA” |
Frequency | string | Frequency of the indicator | “Monthly” |
HistoricalDataSymbol | string | Unique symbol used by Trading Economics | “UNITEDSTACONPRIINDCP” |
CreateDate | string | Time when an indicator was inserted | “2014-06-11T09:44:00” |
FirstValueDate | string | Date of the first value in the historical series | “1950-01-31T00:00:00” |
PreviousValue | number | Previously released value | 300.84 |
PreviousValueDate | string | Date of the previously released value | “2023-02-28T00:00:00” |