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}

Symbol	Date	last	value1	date1	value2	date2	value3	date3	value4	date4	unit	currency	frequency	stock	financialSymbol
005380:ks:assets	3/31/2023 12:00:00 AM	264363574000000.0000	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	251406813000000.0000	6/30/2022 12:00:00 AM	E+00		quarterly	005380:ks	assets
068270:ks:assets	12/31/2022 12:00:00 AM	5891652311250.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	5687913875520.0000	6/30/2022 12:00:00 AM		KRW	quarterly	068270:ks	assets
0981:hk:assets	3/31/2023 12:00:00 AM	45015730000.0000	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	40475723000.0000	6/30/2022 12:00:00 AM		USD	quarterly	0981:hk	assets

/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}

Symbol	Date	last	value1	date1	value2	date2	value3	date3	value4	date4	unit	currency	frequency	stock	financialSymbol
aapl:us:assets	3/31/2023 12:00:00 AM	332160.0000	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	336309.0000	6/30/2022 12:00:00 AM	E+06	USD	quarterly	aapl:us	assets
aapl:us:cash-and-equivalent	3/31/2023 12:00:00 AM	4637.0000	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	14650.0000	6/30/2022 12:00:00 AM	E+06	USD	quarterly	aapl:us	cash-and-equivalent
aapl:us:cost-of-sales	3/31/2023 12:00:00 AM	52860.0000	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	47074.0000	6/30/2022 12:00:00 AM	E+06	USD	quarterly	aapl:us	cost-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

Field	Type	Description	Example
Symbol	string	Unique financial symbol used by Trading Economics	“aapl:us:assets”
Date	string	Trading Economics date and time in UTC	“2022-12-31T00:00:00”
Last	number	Latest reported value for the financial metric	46747.0000
Value1	number	Value for the current quarter	346747.0000
Date1	string	Date of the current quarter	“2022-12-31T00:00:00”
Value2	number	Value for the previous quarter prior to Value1	352755.0000
Date2	string	Date of the quarter prior to Date1	“2022-09-30T00:00:00”
Value3	number	Value for the quarter prior to Value2	336309.0000
Date3	string	Date of the quarter prior to Date2	“2022-06-30T00:00:00”
Value4	number	Value for the quarter prior to Value3	350662.0000
Date4	string	Date of the quarter prior to Date3	“2022-03-31T00:00:00”
Unit	string	Unit of measurement	“E+06”
Currency	string	Reporting currency	“USD”
Frequency	string	Reporting frequency	“quarterly”
Stock	string	Unique stock symbol used by Trading Economics	“aapl:us”
FinancialSymbol	string	Financial category of the metric	“assets”