Report - Earnings API - AxionQuant Docs

GET/earnings/:ticker/report

Retrieves and parses the official earnings release (Form 8-K) for a specific fiscal quarter. Returns structured financial tables (balance sheet, cash flow statement, etc.) extracted directly from the filing. This is the most granular earnings data available.

Path Parameters

Parameter	Type	Required	Description
ticker	string	Required	Stock ticker symbol

Query Parameters

Parameter	Type	Required	Description
year	integer	Required	Calendar year of the filing (e.g., 2024, 2025)
quarter	integer (1-4)	Required	Fiscal quarter (1, 2, 3, 4)

Examples:

https://api.axionquant.com/earnings/AAPL/report?year=2024&quarter=3

https://api.axionquant.com/earnings/MSFT/report?year=2024&quarter=4

Key Response Fields

dataframe

Array of rows in the financial table. Each row contains a label and a values array (numeric and currency symbols).

scale

Numerical scale of the values (e.g., 1000000000 = billions). Multiply values by scale to get full number.

statementType

Type of financial statement: "balance_sheet", "income_statement", "cash_flow", etc.

periods

Column headers describing the reporting periods

Earnings Report (Apple Q4 2023)

Request

Sample code

1from axion import Axion
2client = Axion(api_key='axn_123')
3
4report = client.earnings.report('AAPL',
5    year='2023',
6    quarter='4'
7)
8print(report)

Response (abbreviated)

[
  {
    "dataframe": [
      {
        "label": "December 30, 2023",
        "values": [ "September 30, 2023" ]
      },
      {
        "label": "ASSETS:",
        "values": []
      },
      {
        "label": "Current assets:",
        "values": []
      },
      {
        "label": "Cash and cash equivalents",
        "values": [ "$", 40760, "$", 29965 ]
      },
      {
        "label": "Marketable securities",
        "values": [ 32340, 31590 ]
      },
      {
        "label": "Total current assets",
        "values": [ 143692, 143566 ]
      },
      {
        "label": "Total assets",
        "values": [ "$", 353514, "$", 352583 ]
      }
    ],
    "scale": 1000000000,
    "title": null,
    "statementType": "balance_sheet",
    "periods": [ "Period 1" ],
    "rawIndex": 5
  },
  {
    "dataframe": [
      {
        "label": "Three Months Ended",
        "values": []
      },
      {
        "label": "December 30, 2023",
        "values": [ "December 31, 2022" ]
      },
      {
        "label": "Cash generated by operating activities",
        "values": [ 39895, 34005 ]
      },
      {
        "label": "Cash generated by/(used in) investing activities",
        "values": [ 1927, -1445 ]
      },
      {
        "label": "Cash used in financing activities",
        "values": [ -30585, -35563 ]
      }
    ],
    "scale": 1000000000,
    "title": null,
    "statementType": "cash_flow",
    "periods": [],
    "rawIndex": 6
  }
]

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

Parameter	Type	Required	Description
ticker	string	Required	Stock 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

Parameter	Type	Required	Description
ticker	string	Required	Stock 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

Parameter	Type	Required	Description
ticker	string	Required	Stock 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
    }
  ]
}