Stock Financial Highlights API

getFinancialHighlights

The getFinancialHighlights API provides key financial highlights, ratios and statistics for equities based on symbol. Fields include market capitalization, revenue, net income, revenue growth and earnings per share.

View All APIs

First Name^*

Last Name^*

Email Address^*

Phone^*

Company^*

Role^*

Industry^*

Country^*

What you are looking for?^*

Please provide as much information as possible (e.g. exchanges, markets or other data sources), the APIs you are interested in (e.g. getQuote, getHistory, getChart, getCorporateActions, etc.), and your use case.

Here are some examples: Example #1, Example #2, Example #3.

By submitting this form you are opting in to receive email communications from Barchart for related product, service or company information, updates and announcements. You can unsubscribe at anytime. View our Privacy Policy.

Inputs

symbols^required

A symbol or code that identifies a financial instrument.

Type

list (A comma or semi-colon delimited string.)

Example

GOOG,YHOO

fields^optional

The fields requested.

Type

list (A comma or semi-colon delimited string.)

Example

lastQtrEPS,annualEPS,ttmEPS

Outputs

symbol
always returned

A symbol or code that identifies a financial instrument.

string
A sequence of characters. (example: GOOG)

marketCapitalization
always returned

The total number of outstanding shares multiplied by the current market value. In thousands.

int
A numeric type defining a whole number. (example: 2)

insiderShareholders
always returned

The percent of stock held by insider shareholders.

double
A numeric type defining a number with fractional parts. (example: 2.14)

annualRevenue
always returned

The company's annual revenue.

int
A numeric type defining a whole number. (example: 2)

ttmRevenue
always returned

The company's revenue from the last 12 months.

int
A numeric type defining a whole number. (example: 2)

sharesOutstanding
always returned

The total number of shares outstanding. In thousands.

int
A numeric type defining a whole number. (example: 2)

institutionalShareholders
always returned

The percent of stock held by institutional shareholders.

double
A numeric type defining a number with fractional parts. (example: 2.14)

annualNetIncome
as requested

The company's annual income after taxes but before the payout of common and preferred dividends.

int
A numeric type defining a whole number. (example: 2)

ttmNetIncome
as requested

The net income from the last 12 months.

double
A numeric type defining a number with fractional parts. (example: 2.14)

ttmNetProfitMargin
as requested

Net income dividend by revenue from the previous 12 months.

double
A numeric type defining a number with fractional parts. (example: 2.14)

oneYearReturn
always returned

The percent change in price over a one-year period.

double
A numeric type defining a number with fractional parts. (example: 2.14)

threeYearReturn
always returned

The percent change in price over a three-year period.

double
A numeric type defining a number with fractional parts. (example: 2.14)

fiveYearReturn
always returned

The percent change in price over a five-year period.

double
A numeric type defining a number with fractional parts. (example: 2.14)

fiveYearRevenueGrowth
always returned

The percent growth in revenue over the past 5-years.

double
A numeric type defining a number with fractional parts. (example: 2.14)

fiveYearEarningsGrowth
always returned

The percent growth in earnings over the past 5-years.

double
A numeric type defining a number with fractional parts. (example: 2.14)

fiveYearDividendGrowth
always returned

The percent growth in dividends over the past 5-years.

double
A numeric type defining a number with fractional parts. (example: 2.14)

lastQtrEPS
as requested

The earnings per share for the most recent quarter.

double
A numeric type defining a number with fractional parts. (example: 2.14)

annualEPS
always returned

The earnings per share for the most recent annual period.

double
A numeric type defining a number with fractional parts. (example: 2.14)

ttmEPS
as requested

The earnings per share for the previous 12-months.

double
A numeric type defining a number with fractional parts. (example: 2.14)

annualDividendRate
always returned

The annual dividend amount.

double
A numeric type defining a number with fractional parts. (example: 2.14)

annualDividendYield
always returned

The dividends per share over the trailing one-year period as a percentage of the current stock price.

double
A numeric type defining a number with fractional parts. (example: 2.14)

twelveMonthEPSChg
as requested

The change in earnings per share over the past 12-months.

double
A numeric type defining a number with fractional parts. (example: 2.14)

peRatio
as requested

The current price to earnings ratio.

double
A numeric type defining a number with fractional parts. (example: 2.14)

recentEarnings
as requested

The last reported earnings per share amount.

double
A numeric type defining a number with fractional parts. (example: 2.14)

recentDividends
as requested

The amount of the most recent dividends issued per share.

double
A numeric type defining a number with fractional parts. (example: 2.14)

recentSplit
as requested

The most recent stock split and associated ratio.

string
A sequence of characters. (example: GOOG)

beta
as requested

A measure of the volatility of a security in comparison to the volatility of the market.

double
A numeric type defining a number with fractional parts. (example: 2.14)

weightAlpha
always returned

The weighted alpha of the sector.

double
A numeric type defining a number with fractional parts. (example: 2.14)

Status Code Responses

200

Success

400

Bad Request

The request was invalid, please see the message for more information.

500

Internal Server Error

Something is not working correctly, please contact support.

JSON

GET

GET https://ondemand.websol.barchart.com/getFinancialHighlights.json?apikey=YOUR_API_KEY&symbols=GOOG%2CYHOO&fields=lastQtrEPS%2CannualEPS%2CttmEPS
Host: ondemand.websol.barchart.com

POST

POST https://ondemand.websol.barchart.com/getFinancialHighlights.json
Host: ondemand.websol.barchart.com
Content-Type: application/x-www-form-urlencoded
Content-Length: length

apikey=YOUR_API_KEY&symbols=GOOG%2CYHOO&fields=lastQtrEPS%2CannualEPS%2CttmEPS

Response

{
    "status": {
        "code": 200,
        "message": "Success."
    },
    "results": [
        {
            "symbol": "GOOG",
            "marketCapitalization": 2362023520,
            "insiderShareholders": 0.1299,
            "annualRevenue": 339859,
            "ttmRevenue": 339859000000,
            "sharesOutstanding": 12241000,
            "institutionalShareholders": 27.260000228881836,
            "oneYearReturn": 35.2,
            "threeYearReturn": 31.31,
            "fiveYearReturn": 186.11,
            "fiveYearRevenueGrowth": 124.67,
            "fiveYearEarningsGrowth": 143.7,
            "fiveYearDividendGrowth": 0,
            "lastQtrEPS": 2.12,
            "annualEPS": 7.54,
            "ttmEPS": 7.54,
            "annualDividendRate": 0.80000001,
            "annualDividendYield": 0.42,
            "weightAlpha": 37.26
        },
        {
            "symbol": "YHOO",
            "marketCapitalization": 50400560,
            "insiderShareholders": 0.092,
            "annualRevenue": 5409,
            "ttmRevenue": null,
            "sharesOutstanding": 958550,
            "institutionalShareholders": 82.11000061035156,
            "oneYearReturn": 42.34,
            "threeYearReturn": 50.49,
            "fiveYearReturn": 239.44,
            "fiveYearRevenueGrowth": 3.71,
            "fiveYearEarningsGrowth": -72.29,
            "fiveYearDividendGrowth": 0,
            "lastQtrEPS": 0.1,
            "annualEPS": 0.25,
            "ttmEPS": -0.02,
            "annualDividendRate": 0,
            "annualDividendYield": 0,
            "weightAlpha": null
        }
    ]
}

XML

GET

GET https://ondemand.websol.barchart.com/getFinancialHighlights.xml?apikey=YOUR_API_KEY&symbols=GOOG%2CYHOO&fields=lastQtrEPS%2CannualEPS%2CttmEPS
Host: ondemand.websol.barchart.com

POST

POST https://ondemand.websol.barchart.com/getFinancialHighlights.xml
Host: ondemand.websol.barchart.com
Content-Type: application/x-www-form-urlencoded
Content-Length: length

apikey=YOUR_API_KEY&symbols=GOOG%2CYHOO&fields=lastQtrEPS%2CannualEPS%2CttmEPS

Response

<?xml version="1.0" encoding="utf-8"?>
<getFinancialHighlights>
  <status>
    <code>200</code>
    <message>Success.</message>
  </status>
  <item>
    <symbol>GOOG</symbol>
    <marketCapitalization>2362023520</marketCapitalization>
    <insiderShareholders>0.1299</insiderShareholders>
    <annualRevenue>339859</annualRevenue>
    <ttmRevenue>339859000000</ttmRevenue>
    <sharesOutstanding>12241000</sharesOutstanding>
    <institutionalShareholders>27.260000228882</institutionalShareholders>
    <oneYearReturn>35.2</oneYearReturn>
    <threeYearReturn>31.31</threeYearReturn>
    <fiveYearReturn>186.11</fiveYearReturn>
    <fiveYearRevenueGrowth>124.67</fiveYearRevenueGrowth>
    <fiveYearEarningsGrowth>143.7</fiveYearEarningsGrowth>
    <fiveYearDividendGrowth>0</fiveYearDividendGrowth>
    <lastQtrEPS>2.12</lastQtrEPS>
    <annualEPS>7.54</annualEPS>
    <ttmEPS>7.54</ttmEPS>
    <annualDividendRate>0.80000001</annualDividendRate>
    <annualDividendYield>0.42</annualDividendYield>
    <weightAlpha>37.26</weightAlpha>
  </item>
  <item>
    <symbol>YHOO</symbol>
    <marketCapitalization>50400560</marketCapitalization>
    <insiderShareholders>0.092</insiderShareholders>
    <annualRevenue>5409</annualRevenue>
    <ttmRevenue/>
    <sharesOutstanding>958550</sharesOutstanding>
    <institutionalShareholders>82.110000610352</institutionalShareholders>
    <oneYearReturn>42.34</oneYearReturn>
    <threeYearReturn>50.49</threeYearReturn>
    <fiveYearReturn>239.44</fiveYearReturn>
    <fiveYearRevenueGrowth>3.71</fiveYearRevenueGrowth>
    <fiveYearEarningsGrowth>-72.29</fiveYearEarningsGrowth>
    <fiveYearDividendGrowth>0</fiveYearDividendGrowth>
    <lastQtrEPS>0.1</lastQtrEPS>
    <annualEPS>0.25</annualEPS>
    <ttmEPS>-0.02</ttmEPS>
    <annualDividendRate>0</annualDividendRate>
    <annualDividendYield>0</annualDividendYield>
    <weightAlpha/>
  </item>
</getFinancialHighlights>

CSV

GET

GET https://ondemand.websol.barchart.com/getFinancialHighlights.csv?apikey=YOUR_API_KEY&symbols=GOOG%2CYHOO&fields=lastQtrEPS%2CannualEPS%2CttmEPS
Host: ondemand.websol.barchart.com

POST

POST https://ondemand.websol.barchart.com/getFinancialHighlights.csv
Host: ondemand.websol.barchart.com
Content-Type: application/x-www-form-urlencoded
Content-Length: length

apikey=YOUR_API_KEY&symbols=GOOG%2CYHOO&fields=lastQtrEPS%2CannualEPS%2CttmEPS

Response

symbol,marketCapitalization,insiderShareholders,annualRevenue,ttmRevenue,sharesOutstanding,institutionalShareholders,oneYearReturn,threeYearReturn,fiveYearReturn,fiveYearRevenueGrowth,fiveYearEarningsGrowth,fiveYearDividendGrowth,lastQtrEPS,annualEPS,ttmEPS,annualDividendRate,annualDividendYield,weightAlpha
"GOOG","2362023520","0.1299","339859","339859000000","12241000","27.260000228882","35.2","31.31","186.11","124.67","143.7","0","2.12","7.54","7.54","0.80000001","0.42","37.26"
"YHOO","50400560","0.092","5409","","958550","82.110000610352","42.34","50.49","239.44","3.71","-72.29","0","0.1","0.25","-0.02","0","0",""

PHP

<?php

$ondemand = new SoapClient('https://ondemand.websol.barchart.com/service?wsdl');

$params = [
    'apikey' => 'YOUR_API_KEY',
    'symbols' => 'GOOG,YHOO',
    'fields' => 'lastQtrEPS,annualEPS,ttmEPS',
];

$result = $ondemand->getFinancialHighlights($params);
var_dump($result);

Classic ASP

Dim ondemand
Dim result

Set ondemand = Server.CreateObject("MSSOAP.SoapClient30")
ondemand.ClientProperty("ServerHTTPRequest") = True
ondemand.MSSoapInit("https://ondemand.websol.barchart.com/service?wsdl")

Set result = ondemand.getFinancialHighlights("YOUR_API_KEY", "GOOG,YHOO", "lastQtrEPS,annualEPS,ttmEPS")

Perl

use SOAP::Lite;
use SOAP::WSDL;

my $ondemand = SOAP::Lite
    -> service('https://ondemand.websol.barchart.com/service?wsdl');

my $result = $ondemand->getFinancialHighlights('YOUR_API_KEY', 'GOOG,YHOO', 'lastQtrEPS,annualEPS,ttmEPS');

print $result;

Python

from suds.client import Client
ondemand = Client('https://ondemand.websol.barchart.com/service?wsdl')

result = ondemand.service.getFinancialHighlights('YOUR_API_KEY', 'GOOG,YHOO', 'lastQtrEPS,annualEPS,ttmEPS')

print(result)

Ruby

require 'savon'

ondemand = Savon.client(wsdl: 'https://ondemand.websol.barchart.com/service?wsdl')

response = ondemand.call(
    :getFinancialHighlights,
    message: {
        apikey: 'YOUR_API_KEY',
        symbols: 'GOOG,YHOO',
        fields: 'lastQtrEPS,annualEPS,ttmEPS',
    }
)

response.body