Financials

Financial reports are vital documents issued by publicly traded companies, offering critical insights into their financial and operational performance. These reports, which may occur at regular intervals, provide essential information for stakeholders to evaluate the entity’s health. Key indicators commonly found in these reports include earnings per share (EPS), gross profit on sales, market capitalization, sales revenues, price to earnings (PE), and net income

By category

Using Requests:

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

Or using our package:

import tradingeconomics as te
te.login('your_api_key')
te.getFinancialsDataByCategory(category = 'assets')

Using Requests:

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

Or using our package:

const te = require('tradingeconomics');
te.login('your_api_key');
data = te.getFinancialsDataByCategory(category = 'assets').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/financials/category/assets?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.

/financials/category/{category}

SymbolDatelastvalue1date1value2date2value3date3value4date4unitcurrencyfrequencystockfinancialSymbol
005380:ks:assets3/31/2023 12:00:00 AM264363574000000.0000264363574000000.00003/31/2023 12:00:00 AM255742462000000.000012/31/2022 12:00:00 AM267766826000000.00009/30/2022 12:00:00 AM251406813000000.00006/30/2022 12:00:00 AME+00quarterly005380:ksassets
068270:ks:assets12/31/2022 12:00:00 AM5891652311250.00003/31/2023 12:00:00 AM5891652311250.000012/31/2022 12:00:00 AM5901342280130.00009/30/2022 12:00:00 AM5687913875520.00006/30/2022 12:00:00 AMKRWquarterly068270:ksassets
0981:hk:assets3/31/2023 12:00:00 AM45015730000.000045015730000.00003/31/2023 12:00:00 AM43807784000.000012/31/2022 12:00:00 AM41771386000.00009/30/2022 12:00:00 AM40475723000.00006/30/2022 12:00:00 AMUSDquarterly0981:hkassets

/financials/category/{category}?f=json

[{"Symbol":"005380:ks:assets","Date":"2023-03-31T00:00:00","last":264363574000000.0000,"value1":null,"date1":"2023-06-30T00:00:00","value2":264363574000000.0000,"date2":"2023-03-31T00:00:00","value3":255742462000000.0000,"date3":"2022-12-31T00:00:00","value4":267766826000000.0000,"date4":"2022-09-30T00:00:00","unit":"E+00","currency":"KRW","frequency":"quarterly","stock":"005380:ks","financialSymbol":"assets"},{"Symbol":"068270:ks:assets","Date":"2023-06-30T00:00:00","last":6287885319530.0000,"value1":6287885319530.0000,"date1":"2023-06-30T00:00:00","value2":6126910181370.0000,"date2":"2023-03-31T00:00:00","value3":5891652311250.0000,"date3":"2022-12-31T00:00:00","value4":5901342280130.0000,"date4":"2022-09-30T00:00:00","unit":null,"currency":"KRW","frequency":"quarterly","stock":"068270:ks","financialSymbol":"assets"},{"Symbol":"0981:hk:assets","Date":"2023-06-30T00:00:00","last":45844378000.0000,"value1":45844378000.0000,"date1":"2023-06-30T00:00:00","value2":45015730000.0000,"date2":"2023-03-31T00:00:00","value3":43807784000.0000,"date3":"2022-12-31T00:00:00","value4":41771386000.0000,"date4":"2022-09-30T00:00:00","unit":null,"currency":"USD","frequency":"quarterly","stock":"0981:hk","financialSymbol":"assets"}]

/financials/category/{category}?f=csv

005380:ks:assets,3/31/2023 12:00:00 AM,264363574000000.0000,,6/30/2023 12:00:00 AM,264363574000000.0000,3/31/2023 12:00:00 AM,255742462000000.0000,12/31/2022 12:00:00 AM,267766826000000.0000,9/30/2022 12:00:00 AM,E+00,KRW,quarterly,005380:ks,assets
068270:ks:assets,6/30/2023 12:00:00 AM,6287885319530.0000,6287885319530.0000,6/30/2023 12:00:00 AM,6126910181370.0000,3/31/2023 12:00:00 AM,5891652311250.0000,12/31/2022 12:00:00 AM,5901342280130.0000,9/30/2022 12:00:00 AM,,KRW,quarterly,068270:ks,assets
0981:hk:assets,6/30/2023 12:00:00 AM,45844378000.0000,45844378000.0000,6/30/2023 12:00:00 AM,45015730000.0000,3/31/2023 12:00:00 AM,43807784000.0000,12/31/2022 12:00:00 AM,41771386000.0000,9/30/2022 12:00:00 AM,,USD,quarterly,0981:hk,assets

/financials/category/{category}?f=xml

<ArrayOfanyType xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
<anyType xmlns:d2p1="http://schemas.datacontract.org/2004/07/APILib.DB" i:type="d2p1:Markets.FinancialItem">
<d2p1:Date>2023-03-31T00:00:00</d2p1:Date>
<d2p1:Symbol>005380:ks:assets</d2p1:Symbol>
<d2p1:currency>KRW</d2p1:currency>
<d2p1:date1>2023-06-30T00:00:00</d2p1:date1>
<d2p1:date2>2023-03-31T00:00:00</d2p1:date2>
<d2p1:date3>2022-12-31T00:00:00</d2p1:date3>
<d2p1:date4>2022-09-30T00:00:00</d2p1:date4>
<d2p1:financialSymbol>assets</d2p1:financialSymbol>
<d2p1:frequency>quarterly</d2p1:frequency>
<d2p1:last>264363574000000.0000</d2p1:last>
<d2p1:stock>005380:ks</d2p1:stock>
<d2p1:unit>E+00</d2p1:unit>
<d2p1:value1 i:nil="true"/>
<d2p1:value2>264363574000000.0000</d2p1:value2>
<d2p1:value3>255742462000000.0000</d2p1:value3>
<d2p1:value4>267766826000000.0000</d2p1:value4>
</anyType>
<anyType xmlns:d2p1="http://schemas.datacontract.org/2004/07/APILib.DB" i:type="d2p1:Markets.FinancialItem">
<d2p1:Date>2023-06-30T00:00:00</d2p1:Date>
<d2p1:Symbol>068270:ks:assets</d2p1:Symbol>
<d2p1:currency>KRW</d2p1:currency>
<d2p1:date1>2023-06-30T00:00:00</d2p1:date1>
<d2p1:date2>2023-03-31T00:00:00</d2p1:date2>
<d2p1:date3>2022-12-31T00:00:00</d2p1:date3>
<d2p1:date4>2022-09-30T00:00:00</d2p1:date4>
<d2p1:financialSymbol>assets</d2p1:financialSymbol>
<d2p1:frequency>quarterly</d2p1:frequency>
<d2p1:last>6287885319530.0000</d2p1:last>
<d2p1:stock>068270:ks</d2p1:stock>
<d2p1:unit i:nil="true"/>
<d2p1:value1>6287885319530.0000</d2p1:value1>
<d2p1:value2>6126910181370.0000</d2p1:value2>
<d2p1:value3>5891652311250.0000</d2p1:value3>
<d2p1:value4>5901342280130.0000</d2p1:value4>
</anyType>
<anyType xmlns:d2p1="http://schemas.datacontract.org/2004/07/APILib.DB" i:type="d2p1:Markets.FinancialItem">
<d2p1:Date>2023-06-30T00:00:00</d2p1:Date>
<d2p1:Symbol>0981:hk:assets</d2p1:Symbol>
<d2p1:currency>USD</d2p1:currency>
<d2p1:date1>2023-06-30T00:00:00</d2p1:date1>
<d2p1:date2>2023-03-31T00:00:00</d2p1:date2>
<d2p1:date3>2022-12-31T00:00:00</d2p1:date3>
<d2p1:date4>2022-09-30T00:00:00</d2p1:date4>
<d2p1:financialSymbol>assets</d2p1:financialSymbol>
<d2p1:frequency>quarterly</d2p1:frequency>
<d2p1:last>45844378000.0000</d2p1:last>
<d2p1:stock>0981:hk</d2p1:stock>
<d2p1:unit i:nil="true"/>
<d2p1:value1>45844378000.0000</d2p1:value1>
<d2p1:value2>45015730000.0000</d2p1:value2>
<d2p1:value3>43807784000.0000</d2p1:value3>
<d2p1:value4>41771386000.0000</d2p1:value4>
</anyType>
</ArrayOfanyType>

By symbol

List all financials data by stock symbol

Using Requests:

import requests
api_key = 'YOUR_API_KEY'
url = f'https://api.tradingeconomics.com/financials/symbol/aapl:us?c={api_key}'
data = requests.get(url).json()
print(data)

Or using our package:

te.getFinancialsData(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/financials/symbol/aapl:us?c=${api_key}`)
    console.log(response.data)
})()

Or using our package:

data = te.getFinancialsData(symbol = 'aapl:us').then(function(data){
  console.log(data)     
});

Using Requests:

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

/financials/symbol/{symbol}

SymbolDatelastvalue1date1value2date2value3date3value4date4unitcurrencyfrequencystockfinancialSymbol
aapl:us:assets3/31/2023 12:00:00 AM332160.0000332160.00003/31/2023 12:00:00 AM346747.000012/31/2022 12:00:00 AM352755.00009/30/2022 12:00:00 AM336309.00006/30/2022 12:00:00 AME+06USDquarterlyaapl:usassets
aapl:us:cash-and-equivalent3/31/2023 12:00:00 AM4637.00004637.00003/31/2023 12:00:00 AM2627.000012/31/2022 12:00:00 AM5100.00009/30/2022 12:00:00 AM14650.00006/30/2022 12:00:00 AME+06USDquarterlyaapl:uscash-and-equivalent
aapl:us:cost-of-sales3/31/2023 12:00:00 AM52860.000052860.00003/31/2023 12:00:00 AM66822.000012/31/2022 12:00:00 AM52051.00009/30/2022 12:00:00 AM47074.00006/30/2022 12:00:00 AME+06USDquarterlyaapl:uscost-of-sales

/financials/symbol/{symbol}?f=json

[{"Symbol":"aapl:us:assets","Date":"2023-06-30T00:00:00","last":335038.0000,"value1":335038.0000,"date1":"2023-06-30T00:00:00","value2":332160.0000,"date2":"2023-03-31T00:00:00","value3":346747.0000,"date3":"2022-12-31T00:00:00","value4":352755.0000,"date4":"2022-09-30T00:00:00","unit":"E+06","currency":"USD","frequency":"quarterly","stock":"aapl:us","financialSymbol":"assets"},{"Symbol":"aapl:us:cash-and-equivalent","Date":"2023-06-30T00:00:00","last":3071.0000,"value1":3071.0000,"date1":"2023-06-30T00:00:00","value2":4637.0000,"date2":"2023-03-31T00:00:00","value3":2627.0000,"date3":"2022-12-31T00:00:00","value4":5100.0000,"date4":"2022-09-30T00:00:00","unit":"E+06","currency":"USD","frequency":"quarterly","stock":"aapl:us","financialSymbol":"cash-and-equivalent"},{"Symbol":"aapl:us:cost-of-sales","Date":"2023-06-30T00:00:00","last":45384.0000,"value1":45384.0000,"date1":"2023-06-30T00:00:00","value2":52860.0000,"date2":"2023-03-31T00:00:00","value3":66822.0000,"date3":"2022-12-31T00:00:00","value4":52051.0000,"date4":"2022-09-30T00:00:00","unit":"E+06","currency":"USD","frequency":"quarterly","stock":"aapl:us","financialSymbol":"cost-of-sales"}]

/financials/symbol/{symbol}?f=csv

aapl:us:assets,6/30/2023 12:00:00 AM,335038.0000,335038.0000,6/30/2023 12:00:00 AM,332160.0000,3/31/2023 12:00:00 AM,346747.0000,12/31/2022 12:00:00 AM,352755.0000,9/30/2022 12:00:00 AM,E+06,USD,quarterly,aapl:us,assets
aapl:us:cash-and-equivalent,6/30/2023 12:00:00 AM,3071.0000,3071.0000,6/30/2023 12:00:00 AM,4637.0000,3/31/2023 12:00:00 AM,2627.0000,12/31/2022 12:00:00 AM,5100.0000,9/30/2022 12:00:00 AM,E+06,USD,quarterly,aapl:us,cash-and-equivalent
aapl:us:cost-of-sales,6/30/2023 12:00:00 AM,45384.0000,45384.0000,6/30/2023 12:00:00 AM,52860.0000,3/31/2023 12:00:00 AM,66822.0000,12/31/2022 12:00:00 AM,52051.0000,9/30/2022 12:00:00 AM,E+06,USD,quarterly,aapl:us,cost-of-sales

/financials/symbol/{symbol}?f=xml

<ArrayOfanyType xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
<anyType xmlns:d2p1="http://schemas.datacontract.org/2004/07/APILib.DB" i:type="d2p1:Markets.FinancialItem">
<d2p1:Date>2023-06-30T00:00:00</d2p1:Date>
<d2p1:Symbol>aapl:us:assets</d2p1:Symbol>
<d2p1:currency>USD</d2p1:currency>
<d2p1:date1>2023-06-30T00:00:00</d2p1:date1>
<d2p1:date2>2023-03-31T00:00:00</d2p1:date2>
<d2p1:date3>2022-12-31T00:00:00</d2p1:date3>
<d2p1:date4>2022-09-30T00:00:00</d2p1:date4>
<d2p1:financialSymbol>assets</d2p1:financialSymbol>
<d2p1:frequency>quarterly</d2p1:frequency>
<d2p1:last>335038.0000</d2p1:last>
<d2p1:stock>aapl:us</d2p1:stock>
<d2p1:unit>E+06</d2p1:unit>
<d2p1:value1>335038.0000</d2p1:value1>
<d2p1:value2>332160.0000</d2p1:value2>
<d2p1:value3>346747.0000</d2p1:value3>
<d2p1:value4>352755.0000</d2p1:value4>
</anyType>
<anyType xmlns:d2p1="http://schemas.datacontract.org/2004/07/APILib.DB" i:type="d2p1:Markets.FinancialItem">
<d2p1:Date>2023-06-30T00:00:00</d2p1:Date>
<d2p1:Symbol>aapl:us:cash-and-equivalent</d2p1:Symbol>
<d2p1:currency>USD</d2p1:currency>
<d2p1:date1>2023-06-30T00:00:00</d2p1:date1>
<d2p1:date2>2023-03-31T00:00:00</d2p1:date2>
<d2p1:date3>2022-12-31T00:00:00</d2p1:date3>
<d2p1:date4>2022-09-30T00:00:00</d2p1:date4>
<d2p1:financialSymbol>cash-and-equivalent</d2p1:financialSymbol>
<d2p1:frequency>quarterly</d2p1:frequency>
<d2p1:last>3071.0000</d2p1:last>
<d2p1:stock>aapl:us</d2p1:stock>
<d2p1:unit>E+06</d2p1:unit>
<d2p1:value1>3071.0000</d2p1:value1>
<d2p1:value2>4637.0000</d2p1:value2>
<d2p1:value3>2627.0000</d2p1:value3>
<d2p1:value4>5100.0000</d2p1:value4>
</anyType>
<anyType xmlns:d2p1="http://schemas.datacontract.org/2004/07/APILib.DB" i:type="d2p1:Markets.FinancialItem">
<d2p1:Date>2023-06-30T00:00:00</d2p1:Date>
<d2p1:Symbol>aapl:us:cost-of-sales</d2p1:Symbol>
<d2p1:currency>USD</d2p1:currency>
<d2p1:date1>2023-06-30T00:00:00</d2p1:date1>
<d2p1:date2>2023-03-31T00:00:00</d2p1:date2>
<d2p1:date3>2022-12-31T00:00:00</d2p1:date3>
<d2p1:date4>2022-09-30T00:00:00</d2p1:date4>
<d2p1:financialSymbol>cost-of-sales</d2p1:financialSymbol>
<d2p1:frequency>quarterly</d2p1:frequency>
<d2p1:last>45384.0000</d2p1:last>
<d2p1:stock>aapl:us</d2p1:stock>
<d2p1:unit>E+06</d2p1:unit>
<d2p1:value1>45384.0000</d2p1:value1>
<d2p1:value2>52860.0000</d2p1:value2>
<d2p1:value3>66822.0000</d2p1:value3>
<d2p1:value4>52051.0000</d2p1:value4>
</anyType>
</ArrayOfanyType>

Response fields

FieldTypeDescriptionExample
SymbolstringUnique symbol used by Trading Economics“aapl:us:assets”
DatestringTrading Economics date time in UTC“2022-12-31T00:00:00”
LastnumberLastest value46747.0000
Value1numberValue for the current quarter346747.0000
Date1stringDate for the current quarter“2022-12-31T00:00:00”
Value2numberValue for the quarter prior to Value1352755.0000
Date2stringDate for the quarter prior to Date1“2022-09-30T00:00:00”
Value3numberValue for the quarter prior to Value2336309.0000
Date3stringDate for the quarter prior to Date2“2022-06-30T00:00:00”
Value4numberValue for the quarter prior to Value3350662.0000
Date4stringDate for the quarter prior to Date3“2022-03-31T00:00:00”
UnitstringUnit“E+06”
CurrencystringCurrency“USD”
FrequencystringFrequency of the financial“quarterly”
StockstringStock unique symbol used by Trading Economics“aapl:us”
FinancialSymbolstringFinancials category“assets”