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
api_key = 'YOUR_API_KEY'
url = f'https://api.tradingeconomics.com/markets/symbology/symbol/aapl:us?c={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 api_key = 'YOUR_API_KEY'
    const response = await axios.get(`https://api.tradingeconomics.com/markets/symbology/symbol/aapl:us?c=${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=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.

markets/symbology/symbol/{symbol}

SymbolTickerISINNameCountry
AAPL:USAAPLUS0378331005AppleUnited States

markets/symbology/symbol/{symbol}?f=json

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

markets/symbology/symbol/{symbol}?f=csv

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

Symbologies by country

Using Requests:

import requests
api_key = 'YOUR_API_KEY'
url = f'https://api.tradingeconomics.com/markets/symbology/country/mexico?c={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 api_key = 'YOUR_API_KEY'
    const response = await axios.get(`https://api.tradingeconomics.com/markets/symbology/country/mexico?c=${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=guest:guest");

markets/symbology/country/{country}

SymbolTickerISINNameCountry
AC:MMACMX01AC100006Arca ContinentalMexico
ALFAA:MMALFAAMXP000511016AlfaMexico
ALPEKA:MMALPEKAMX01AL0C0004AlpekMexico

markets/symbology/country/{country}?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"
  }
]

markets/symbology/country/{country}?f=csv

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

Symbologies by ticker

Using Requests:

import requests
api_key = 'YOUR_API_KEY'
url = f'https://api.tradingeconomics.com/markets/symbology/ticker/aapl?c={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 api_key = 'YOUR_API_KEY'
    const response = await axios.get(`https://api.tradingeconomics.com/markets/symbology/ticker/aapl?c=${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=guest:guest");

/markets/symbology/ticker/{ticker}

SymbolTickerISINNameCountry
AAPL:USAAPLUS0378331005AppleUnited States

/markets/symbology/ticker/{ticker}?f=json

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

/markets/symbology/ticker/{ticker}?f=csv

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

Symbologies by ISIN

Using Requests:

import requests
api_key = 'YOUR_API_KEY'
url = f'https://api.tradingeconomics.com/markets/symbology/isin/US0378331005?c={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 api_key = 'YOUR_API_KEY'
    const response = await axios.get(`https://api.tradingeconomics.com/markets/symbology/isin/US0378331005?c=${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=guest:guest");

/markets/symbology/isin/{isin}

SymbolTickerISINNameCountry
AAPL:USAAPLUS0378331005AppleUnited States

/markets/symbology/isin/{isin}?f=json

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

/markets/symbology/isin/{isin}?f=csv

AAPL:US,AAPL,US0378331005,Apple,United 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”