getFinancialHighlights API

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.

All APIs

Contact Us to Get Access

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

Name / Requirement
Description
Type
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
OK
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": 719784960,
            "insiderShareholders": 0.1392,
            "annualRevenue": 104596,
            "ttmRevenue": null,
            "sharesOutstanding": 694800,
            "institutionalShareholders": 34.43,
            "oneYearReturn": 36.13,
            "threeYearReturn": 92.1,
            "fiveYearReturn": 85.5,
            "fiveYearRevenueGrowth": 138.15,
            "fiveYearEarningsGrowth": 0,
            "fiveYearDividendGrowth": 0,
            "lastQtrEPS": 9.57,
            "annualEPS": 29.87,
            "ttmEPS": 29.870001,
            "annualDividendRate": 0,
            "annualDividendYield": 0,
            "weightAlpha": 36.8
        },
        {
            "symbol": "YHOO",
            "marketCapitalization": 50400560,
            "insiderShareholders": 0.092,
            "annualRevenue": 5409,
            "ttmRevenue": 5409253000,
            "sharesOutstanding": 958550,
            "institutionalShareholders": 82.110001,
            "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>719784960</marketCapitalization>
   <insiderShareholders>0.1392</insiderShareholders>
   <annualRevenue>104596</annualRevenue>
   <ttmRevenue></ttmRevenue>
   <sharesOutstanding>694800</sharesOutstanding>
   <institutionalShareholders>34.43</institutionalShareholders>
   <oneYearReturn>36.13</oneYearReturn>
   <threeYearReturn>92.1</threeYearReturn>
   <fiveYearReturn>85.5</fiveYearReturn>
   <fiveYearRevenueGrowth>138.15</fiveYearRevenueGrowth>
   <fiveYearEarningsGrowth>0</fiveYearEarningsGrowth>
   <fiveYearDividendGrowth>0</fiveYearDividendGrowth>
   <lastQtrEPS>9.57</lastQtrEPS>
   <annualEPS>29.87</annualEPS>
   <ttmEPS>29.870001</ttmEPS>
   <annualDividendRate>0</annualDividendRate>
   <annualDividendYield>0</annualDividendYield>
   <weightAlpha>36.8</weightAlpha>
  </item>
  <item>
   <symbol>YHOO</symbol>
   <marketCapitalization>50400560</marketCapitalization>
   <insiderShareholders>0.092</insiderShareholders>
   <annualRevenue>5409</annualRevenue>
   <ttmRevenue>5409253000</ttmRevenue>
   <sharesOutstanding>958550</sharesOutstanding>
   <institutionalShareholders>82.110001</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></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","719784960","0.1392","104596","","694800","34.43","36.13","92.1","85.5","138.15","0","0","9.57","29.87","29.870001","0","0","36.8"
"YHOO","50400560","0.092","5409","5409253000","958550","82.110001","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 = [
    '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("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('GOOG,YHOO', 'lastQtrEPS,annualEPS,ttmEPS');

print $result;

Python

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

result = client.service.getFinancialHighlights('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: {
        symbols: 'GOOG,YHOO',
        fields: 'lastQtrEPS,annualEPS,ttmEPS',
    }
)

response.body