Markets Symbology

The Symbology endpoint provides identifier mappings for market symbols, allowing you to cross-reference Trading Economics symbols against standard industry identifiers such as ISIN, Bloomberg, and Reuters codes. This is useful when integrating with external databases or matching instruments across multiple data sources.

Symbologies by symbol

Using Requests:

import requests
your_api_key = 'your_api_key'
url = f'https://api.tradingeconomics.com/markets/symbology/symbol/aapl:us?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.getMarketsSymbology(symbol = 'aapl:us')

Using Requests:

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

Or using our package:

const te = require('tradingeconomics');
te.login('your_api_key');
data = te.getSymbology(symbol = 'aapl:us').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/markets/symbology/symbol/aapl:us?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.

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

[
  {
    "Symbol": "AAPL:US",
    "Ticker": "AAPL",
    "ISIN": "US0378331005",
    "Name": "Apple",
    "Country": "United States"
  }
]

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

AAPL:US,AAPL,US0378331005,Apple,United States

https://api.tradingeconomics.com/markets/symbology/symbol/{symbol}?c={your_api_key}
SymbolTickerISINNameCountry
AAPL:USAAPLUS0378331005AppleUnited States

Symbologies by country

Using Requests:

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

Or using our package:

te.getMarketsSymbology(country = 'mexico')

Using Requests:

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

Or using our package:

data = te.getSymbology(country = 'mexico').then(function(data){
  console.log(data)     
});

Using Requests:

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

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

[
  {
    "Symbol": "AC:MM",
    "Ticker": "AC",
    "ISIN": "MX01AC100006",
    "Name": "Arca Continental",
    "Country": "Mexico"
  },
  {
    "Symbol": "ALFAA:MM",
    "Ticker": "ALFAA",
    "ISIN": "MXP000511016",
    "Name": "Alfa",
    "Country": "Mexico"
  },
  {
    "Symbol": "ALPEKA:MM",
    "Ticker": "ALPEKA",
    "ISIN": "MX01AL0C0004",
    "Name": "Alpek",
    "Country": "Mexico"
  },
  {
    "Symbol": "ASURB:MM",
    "Ticker": "ASURB",
    "ISIN": "MXP001661018",
    "Name": "Grupo Aeroportuario del Sureste",
    "Country": "Mexico"
  },
  {
    "Symbol": "BIMBOA:MM",
    "Ticker": "BIMBOA",
    "ISIN": "MXP495211262",
    "Name": "Grupo Bimbo",
    "Country": "Mexico"
  },
  {
    "Symbol": "BOLSAA:MM"
  }
]

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

AC:MM,AC,MX01AC100006,Arca Continental,Mexico
ALFAA:MM,ALFAA,MXP000511016,Alfa,Mexico
ALPEKA:MM,ALPEKA,MX01AL0C0004,Alpek,Mexico

https://api.tradingeconomics.com/markets/symbology/country/{country}?c={your_api_key}
SymbolTickerISINNameCountry
AC:MMACMX01AC100006Arca ContinentalMexico
ALFAA:MMALFAAMXP000511016AlfaMexico
ALPEKA:MMALPEKAMX01AL0C0004AlpekMexico

Symbologies by ticker

Using Requests:

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

Or using our package:

te.getMarketsSymbology(ticker = 'aapl')

Using Requests:

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

Or using our package:

data = te.getSymbology(ticker = 'aapl').then(function(data){
  console.log(data)     
});

Using Requests:

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

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

[
  {
    "Symbol": "AAPL:US",
    "Ticker": "AAPL",
    "ISIN": "US0378331005",
    "Name": "Apple",
    "Country": "United States"
  }
]

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

AAPL:US,AAPL,US0378331005,Apple,United States

https://api.tradingeconomics.com/markets/symbology/ticker/{ticker}?c={your_api_key}
SymbolTickerISINNameCountry
AAPL:USAAPLUS0378331005AppleUnited States

Symbologies by ISIN

Using Requests:

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

Or using our package:

te.getMarketsSymbology(isin = 'US0378331005')

Using Requests:

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

Or using our package:

data = te.getSymbology(isin = 'US0378331005').then(function(data){
  console.log(data)     
});

Using Requests:

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

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

[
  {
    "Symbol": "AAPL:US",
    "Ticker": "AAPL",
    "ISIN": "US0378331005",
    "Name": "Apple",
    "Country": "United States"
  }
]

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

AAPL:US,AAPL,US0378331005,Apple,United States

https://api.tradingeconomics.com/markets/symbology/isin/{isin}?c={your_api_key}
SymbolTickerISINNameCountry
AAPL:USAAPLUS0378331005AppleUnited States

Response fields

FieldTypeDescriptionExample
SymbolstringUnique symbol used by Trading Economics“AAPL:US”
TickerstringUnique ticker code used by Trading Economics“AAPL”
ISINstringInternational Securities Identification Number“US0378331005”
NamestringFull company name“Apple”
CountrystringCountry where the company is based“United States”