Logo
AXION

Earnings History

Sign In
GET/earnings/:ticker/history

Returns historical quarterly earnings data including actual EPS, analyst estimates, earnings surprise (difference and percentage), and the corresponding fiscal quarter. Typically covers the last 4-8 quarters.

Path Parameters

ParameterTypeRequiredDescription
tickerstringRequiredStock ticker symbol (e.g., "AAPL", "MSFT")

Examples:

https://api.axionquant.com/earnings/AAPL/history
https://api.axionquant.com/earnings/MSFT/history

Key Response Fields

epsActual

Reported earnings per share (actual)

epsEstimate

Consensus analyst EPS estimate

epsDifference

Actual minus estimate

surprisePercent

Percentage surprise (decimal format)

quarter

Fiscal quarter end date (ISO 8601)

period

Relative period indicator (e.g., "0q" for most recent, "-1q" for previous)

|

Earnings History (Apple)

Request

Sample code
1from axion import Axion
2client = Axion(api_key='axn_123')
3
4history = client.earnings.history('AAPL')
5print(history)

Response

[
  {
    "epsActual": 2.4,
    "epsEstimate": 2.34102,
    "epsDifference": 0.06,
    "surprisePercent": 0.0252,
    "quarter": "2024-12-31T00:00:00.000Z",
    "currency": "USD",
    "period": "-4q"
  },
  {
    "epsActual": 1.65,
    "epsEstimate": 1.62253,
    "epsDifference": 0.03,
    "surprisePercent": 0.016900001,
    "quarter": "2025-03-31T00:00:00.000Z",
    "currency": "USD",
    "period": "-3q"
  }
]
GET/earnings/:ticker/trend

Provides forward-looking earnings estimates and analyst sentiment for upcoming quarters. Includes EPS and revenue estimates (average, low, high), year-ago comparisons, recent estimate revisions, and EPS trend over the last 90 days.

Path Parameters

ParameterTypeRequiredDescription
tickerstring RequiredStock ticker symbol

Examples:

https://api.axionquant.com/earnings/AAPL/trend
https://api.axionquant.com/earnings/MSFT/trend

Key Response Fields

period

Fiscal period ("0q" = current quarter, "+1q" = next quarter, "0y" = current fiscal year, "LTG" = long-term growth)

endDate

Fiscal period end date

growth

Estimated earnings growth rate (decimal)

earningsEstimate

Object containing EPS estimate details: avg, low, high, yearAgoEps, numberOfAnalysts, growth

revenueEstimate

Object containing revenue estimate details (similar structure)

epsTrend

EPS estimates over time (current, 7d ago, 30d ago, 60d ago, 90d ago)

epsRevisions

Count of upward/downward revisions in the last 7/30 days

|

Earnings Trend (Apple)

Request

Sample code
1from axion import Axion
2client = Axion(api_key='axn_123')
3
4trend = client.earnings.trend('AAPL')
5print(trend)

Response (abbreviated)

[
  {
    "period": "0q",
    "endDate": "2025-12-31T00:00:00.000Z",
    "growth": 0.1103,
    "earningsEstimate": {
      "avg": 2.66574,
      "low": 2.51,
      "high": 2.8,
      "yearAgoEps": 2.4,
      "numberOfAnalysts": 29,
      "growth": 0.1107
    },
    "revenueEstimate": {
      "avg": 138253076640,
      "low": 136679500000,
      "high": 142741000000,
      "numberOfAnalysts": 29,
      "yearAgoRevenue": 124300000000,
      "growth": 0.1123
    },
    "epsTrend": {
      "current": 2.66574,
      "7daysAgo": 2.66367,
      "30daysAgo": 2.66153,
      "60daysAgo": 2.48232,
      "90daysAgo": 2.492
    },
    "epsRevisions": {
      "upLast7days": 1,
      "upLast30days": 1,
      "downLast30days": 0,
      "downLast7Days": 0
    }
  }
]
GET/earnings/:ticker/index

Returns earnings growth estimates for the S&P 500 index (or other benchmark) for comparison against the company's own estimates. Useful for contextualizing company performance within the broader market.

Note: The :ticker parameter is required but currently the endpoint always returns data for the S&P 500 (symbol "SP5"). Future versions may support other indices.

Path Parameters

ParameterTypeRequiredDescription
tickerstringRequiredStock ticker symbol (used for context)

Examples:

https://api.axionquant.com/earnings/AAPL/index
https://api.axionquant.com/earnings/MSFT/index

Key Response Fields

symbol

Index symbol (currently "SP5" for S&P 500)

estimates[].period

Period code: "0q" (current quarter), "+1q" (next quarter), "0y" (current year), "+1y" (next year), "LTG" (long-term growth)

estimates[].growth

Estimated earnings growth rate for the index (decimal)

|

Index Earnings Trend (S&P 500)

Request

Sample code
1from axion import Axion
2client = Axion(api_key='axn_123')
3
4index = client.earnings.index('AAPL')
5print(index)

Response

{
  "symbol": "SP5",
  "estimates": [
    {
      "period": "0q",
      "growth": 0.1524
    },
    {
      "period": "+1q",
      "growth": 0.070300005
    },
    {
      "period": "0y",
      "growth": 0.109
    },
    {
      "period": "+1y",
      "growth": 0.1487
    },
    {
      "period": "LTG",
      "growth": 0.122
    }
  ]
}

SEC Filings API

The Filings API provides direct access to the U.S. Securities and Exchange Commission (SEC) EDGAR database. Retrieve company filings by ticker, form type, year, and quarter. All endpoints return metadata including filing dates, accession numbers, and direct URLs to the original SEC filings. Data is sourced in real-time from the SEC and covers all publicly traded companies.

GET/filings/:ticker

Retrieves the most recent SEC filings for a specific company. By default returns the latest 20 filings, with optional filtering by form type. Returns a flat array of filing objects.

Path Parameters

ParameterTypeRequiredDescription
tickerstringRequiredStock ticker symbol

Query Parameters

ParameterTypeRequiredDescription
limitintegerOptionalMaximum number of filings to return (default: 20, max: 100)
formstringOptional

Filter by specific SEC form type (case-insensitive)

view all values

Examples:

https://api.axionquant.com/filings/AAPL
https://api.axionquant.com/filings/AAPL?limit=50&form=10-K

Key Response Fields

[].cik

Central Index Key (CIK) - unique SEC identifier

[].form

SEC form type

[].filingDate

Date filed with the SEC

[].accessionNumber

SEC accession number

[].documentId

Base64-encoded SEC document URL for fetching the document text

[].url

Direct SEC EDGAR URL

|

Recent Apple Filings

Request

Sample code
1from axion import Axion
2client = Axion(api_key='axn_123')
3
4filings = client.filings.recent(
5    'AAPL',
6    form='10-K',
7    limit=10
8)
9print(filings)

Response

[
  {
    "cik": 320193,
    "form": "4",
    "filingDate": "2026-01-15",
    "accessionNumber": "000032019326000015",
    "documentId": "aHR0cHM6Ly93d3cuc2VjLmdvdi9BcmNoaXZlcy9lZGdhci9kYXRhLzMyMDE5My8wMDAwMzIwMTkzMjYwMDAwMTUvaW5kZXguaHRtbA==",
    "url": "https://www.sec.gov/Archives/edgar/data/320193/000032019326000015-index.html"
  },
  {
    "cik": 320193,
    "form": "10-Q",
    "filingDate": "2026-01-12",
    "accessionNumber": "000032019326000006",
    "documentId": "aHR0cHM6Ly93d3cuc2VjLmdvdi9BcmNoaXZlcy9lZGdhci9kYXRhLzMyMDE5My8wMDAwMzIwMTkzMjYwMDAwMDYvYWFwbC0yMDI1MTIyNy5odG0=",
    "url": "https://www.sec.gov/Archives/edgar/data/320193/000032019326000006/aapl-20251227.htm"
  },
  {
    "cik": 320193,
    "form": "8-K",
    "filingDate": "2026-01-10",
    "accessionNumber": "000032019326000005",
    "documentId": "aHR0cHM6Ly93d3cuc2VjLmdvdi9BcmNoaXZlcy9lZGdhci9kYXRhLzMyMDE5My8wMDAwMzIwMTkzMjYwMDAwMDUvYWFwbC0yMDI2MDEyOS5odG0=",
    "url": "https://www.sec.gov/Archives/edgar/data/320193/000032019326000005/aapl-20260129.htm"
  }
]
GET/filings/:ticker/:formType

Retrieves SEC filings of a specific form type for a given company within a date range. Requires a start date, with an optional end date (defaults to today). Returns filing metadata including direct URLs to the SEC EDGAR website.

Path Parameters

ParameterTypeRequiredDescription
tickerstringRequiredStock ticker symbol (e.g., "AAPL", "MSFT", "NVDA")
formTypestringRequiredSEC form type (e.g., "10-K", "10-Q", "4", "8-K"). Case-insensitive.

Query Parameters

ParameterTypeRequiredDescription
startDatestring (YYYY-MM-DD)RequiredStart date for the filing period.
endDatestring (YYYY-MM-DD)OptionalEnd date for the filing period. Defaults to today if not provided.

Examples:

https://api.axionquant.com/filings/AAPL/10-K?startDate=2024-01-01&endDate=2024-12-31
https://api.axionquant.com/filings/AAPL/10-Q?startDate=2024-01-01

Key Response Fields

[].company

Legal name of the company

[].cik

Central Index Key (CIK) - unique SEC identifier

[].form

SEC form type of the individual filing

[].filingDate

Date the filing was submitted to the SEC

[].reportDate

Period end date for the filing

[].accessionNumber

SEC accession number (unique identifier)

[].documentId

Base64-encoded SEC document URL for fetching the document text

[].url

Direct HTTPS link to the SEC EDGAR filing page

|

Form 4 Filings for Apple

Request

Sample code
1from axion import Axion
2client = Axion(api_key='axn_123')
3
4forms = client.filings.history(
5    'AAPL',
6    '4',
7    start_date='2024-01-01',
8    end_date='2024-03-31'
9)
10print(forms)

Response

[
  {
    "company": "Apple Inc.",
    "cik": 320193,
    "form": "4",
    "filingDate": "2026-01-15",
    "reportDate": "2026-01-14",
    "accessionNumber": "000032019326000015",
    "documentId": "aHR0cHM6Ly93d3cuc2VjLmdvdi9BcmNoaXZlcy9lZGdhci9kYXRhLzMyMDE5My8wMDAwMzIwMTkzMjYwMDAwMTUvaW5kZXguaHRtbA==",
    "url": "https://www.sec.gov/Archives/edgar/data/320193/000032019326000015-index.html"
  },
  {
    "company": "Apple Inc.",
    "cik": 320193,
    "form": "4",
    "filingDate": "2026-01-14",
    "reportDate": "2026-01-13",
    "accessionNumber": "000032019326000014",
    "documentId": "aHR0cHM6Ly93d3cuc2VjLmdvdi9BcmNoaXZlcy9lZGdhci9kYXRhLzMyMDE5My8wMDAwMzIwMTkzMjYwMDAwMTQvaW5kZXguaHRtbA==",
    "url": "https://www.sec.gov/Archives/edgar/data/320193/000032019326000014-index.html"
  }
]