Earnings Estimate API

getEarningsEstimates

The getEarningsEstimates API provides per share earnings estimates on 4,500+ rated companies or quarterly and annual periods based on symbol. The getEarningsEstimates API provides you will accurate and reliable data to reduce risk and ensure you're staying ahead.

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. Multiple symbols separated by a comma may be used.

Type

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

Example

IBM,GOOG

fields^optional

Additional fields requested.

Type

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

Example

bid,bidSize,ask,askSize

Outputs

symbol
always returned

A symbol or code that identifies the futures contract.

string
A sequence of characters. (example: GOOG)

symbolName
always returned

The full name of the instrument.

string
A sequence of characters. (example: GOOG)

period
always returned

The period, either quarter or annual, that the estimate pertains to. For example, Q42013 or FY122013.

string
A sequence of characters. (example: GOOG)

averageEstimate
always returned

The average estimated earnings per share based on all analysts.

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

numAnalysts
as requested

The number of analysts providing earnings estimates.

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

highEstimate
as requested

The highest earnings per share estimate amount.

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

lowEstimate
as requested

The lowest earnings per share estimate amount.

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

priorYear
as requested

The average earnings per share estimated last year.

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

growthRateEstimate
as requested

The estimated growth rate in earnings based off of the average estimate (year-over-year).

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

currentQtrExpectedReportDate
as requested

The expected report date for the most recent quarter.

date
A date in the format of YYYY-MM-DD.

expectedEarningsStatus
as requested

Whether the expected earnings information is late or not.

string
A sequence of characters. (example: GOOG)

expectedEarningsSource
as requested

The source of the expected earnings report date.

string
A sequence of characters. (example: GOOG)

dividendType
as requested

Type of dividend payout.

string
A sequence of characters. (example: GOOG)

indicatedAnnualDvnd
as requested

The indicated annual dividend per share for given instrument.

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

dividendStatus
as requested

Whether the dividend data is late or not.

string
A sequence of characters. (example: GOOG)

paymentDate
as requested

The dividend payment date.

date
A date in the format of YYYY-MM-DD.

recordDate
as requested

Date when dividend info was reported

date
A date in the format of YYYY-MM-DD.

declarationDate
as requested

Date when dividend info was announced.

date
A date in the format of YYYY-MM-DD.

exDividendDate
as requested

The last possible date to have owned shares of a stock and still be entitled to the associated dividend.

date
A date in the format of YYYY-MM-DD.

dividendRate
as requested

Last dividend payout amount.

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/getEarningsEstimates.json?apikey=YOUR_API_KEY&symbols=IBM%2CGOOG&fields=bid%2CbidSize%2Cask%2CaskSize
Host: ondemand.websol.barchart.com

POST

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

apikey=YOUR_API_KEY&symbols=IBM%2CGOOG&fields=bid%2CbidSize%2Cask%2CaskSize

Response

{
    "status": {
        "code": 200,
        "message": "Success."
    },
    "results": [
        {
            "symbol": "IBM",
            "symbolName": "International Business Machines",
            "period": "FY 2024-12-31",
            "averageEstimate": 10.12
        },
        {
            "symbol": "IBM",
            "symbolName": "International Business Machines",
            "period": "Qtr 2025-03-31",
            "averageEstimate": 1.59
        },
        {
            "symbol": "IBM",
            "symbolName": "International Business Machines",
            "period": "FY 2025-12-31",
            "averageEstimate": 10.58
        },
        {
            "symbol": "GOOG",
            "symbolName": "Alphabet Cl C",
            "period": "FY 2024-12-31",
            "averageEstimate": 7.99
        },
        {
            "symbol": "GOOG",
            "symbolName": "Alphabet Cl C",
            "period": "Qtr 2025-03-31",
            "averageEstimate": 2.03
        },
        {
            "symbol": "GOOG",
            "symbolName": "Alphabet Cl C",
            "period": "FY 2025-12-31",
            "averageEstimate": 8.92
        }
    ]
}

XML

GET

GET https://ondemand.websol.barchart.com/getEarningsEstimates.xml?apikey=YOUR_API_KEY&symbols=IBM%2CGOOG&fields=bid%2CbidSize%2Cask%2CaskSize
Host: ondemand.websol.barchart.com

POST

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

apikey=YOUR_API_KEY&symbols=IBM%2CGOOG&fields=bid%2CbidSize%2Cask%2CaskSize

Response

<?xml version="1.0" encoding="utf-8"?>
<getEarningsEstimates>
  <status>
    <code>200</code>
    <message>Success.</message>
  </status>
  <item>
    <symbol>IBM</symbol>
    <symbolName>International Business Machines</symbolName>
    <period>FY 2024-12-31</period>
    <averageEstimate>10.12</averageEstimate>
  </item>
  <item>
    <symbol>IBM</symbol>
    <symbolName>International Business Machines</symbolName>
    <period>Qtr 2025-03-31</period>
    <averageEstimate>1.59</averageEstimate>
  </item>
  <item>
    <symbol>IBM</symbol>
    <symbolName>International Business Machines</symbolName>
    <period>FY 2025-12-31</period>
    <averageEstimate>10.58</averageEstimate>
  </item>
  <item>
    <symbol>GOOG</symbol>
    <symbolName>Alphabet Cl C</symbolName>
    <period>FY 2024-12-31</period>
    <averageEstimate>7.99</averageEstimate>
  </item>
  <item>
    <symbol>GOOG</symbol>
    <symbolName>Alphabet Cl C</symbolName>
    <period>Qtr 2025-03-31</period>
    <averageEstimate>2.03</averageEstimate>
  </item>
  <item>
    <symbol>GOOG</symbol>
    <symbolName>Alphabet Cl C</symbolName>
    <period>FY 2025-12-31</period>
    <averageEstimate>8.92</averageEstimate>
  </item>
</getEarningsEstimates>

CSV

GET

GET https://ondemand.websol.barchart.com/getEarningsEstimates.csv?apikey=YOUR_API_KEY&symbols=IBM%2CGOOG&fields=bid%2CbidSize%2Cask%2CaskSize
Host: ondemand.websol.barchart.com

POST

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

apikey=YOUR_API_KEY&symbols=IBM%2CGOOG&fields=bid%2CbidSize%2Cask%2CaskSize

Response

symbol,symbolName,period,averageEstimate
"IBM","International Business Machines","FY 2024-12-31","10.12"
"IBM","International Business Machines","Qtr 2025-03-31","1.59"
"IBM","International Business Machines","FY 2025-12-31","10.58"
"GOOG","Alphabet Cl C","FY 2024-12-31","7.99"
"GOOG","Alphabet Cl C","Qtr 2025-03-31","2.03"
"GOOG","Alphabet Cl C","FY 2025-12-31","8.92"

PHP

<?php

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

$params = [
    'apikey' => 'YOUR_API_KEY',
    'symbols' => 'IBM,GOOG',
    'fields' => 'bid,bidSize,ask,askSize',
];

$result = $ondemand->getEarningsEstimates($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.getEarningsEstimates("YOUR_API_KEY", "IBM,GOOG", "bid,bidSize,ask,askSize")

Perl

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

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

my $result = $ondemand->getEarningsEstimates('YOUR_API_KEY', 'IBM,GOOG', 'bid,bidSize,ask,askSize');

print $result;

Python

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

result = ondemand.service.getEarningsEstimates('YOUR_API_KEY', 'IBM,GOOG', 'bid,bidSize,ask,askSize')

print(result)

Ruby

require 'savon'

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

response = ondemand.call(
    :getEarningsEstimates,
    message: {
        apikey: 'YOUR_API_KEY',
        symbols: 'IBM,GOOG',
        fields: 'bid,bidSize,ask,askSize',
    }
)

response.body