Skip to main content
GET
Get KPI metrics

Overview

The Financial Datasets KPI metrics API returns the operating KPIs that companies report in their earnings releases but that are not in standard financial statements, such as airline load factor, bank CET1 ratio, and REIT FFO per share. It covers 600+ US tickers with 3+ years of history, updated within 30 seconds. You can call it as a REST endpoint with an API key, or from Claude, ChatGPT, Cursor, and other AI apps through the MCP server, or pay per request with x402. Pricing starts at $20. This is premium data, so each call counts as more than one request. Examples by sector:
  • Airlines: load factor, CASM-ex-fuel, passenger yield, revenue per ASM, fuel cost per gallon
  • Banks: CET1 ratio, net interest margin, efficiency ratio, ROTCE, trading revenue
  • REITs: FFO per share, same-store NOI growth, occupancy, lease spreads, cap rates
  • Retail: comparable store sales, e-commerce growth, membership revenue
  • Semiconductors: data center revenue, gaming revenue, automotive revenue
Data is sourced from earnings releases, earnings call transcripts, and press releases. Each metric includes the source text and a direct link to the source document.

Coverage

Available Tickers

You can fetch a list of available tickers with a GET request to: https://api.financialdatasets.ai/kpi/metrics/tickers/

Available Sectors

You can fetch a list of available sectors with a GET request to: https://api.financialdatasets.ai/kpi/metrics/sectors/

Getting Started

There are only 3 steps for making a successful API call:
  1. Add your API key to the header of the request as X-API-KEY.
  2. Add the required query param ticker.
  3. Execute the API request.

Filtering the Data

Example

KPI Metrics

Example Response

Notes

  • The source_url links directly to the source document. When a text-level citation is available, the URL includes a fragment that highlights the source text in the browser.

FAQ

Which KPIs are covered?

Sector-specific operating metrics. Examples: load factor and CASM-ex-fuel for airlines, CET1 ratio and net interest margin for banks, FFO per share and occupancy for REITs, comparable store sales for retail, and data center revenue for semiconductors. List the covered tickers with /kpi/metrics/tickers/ and the sectors with /kpi/metrics/sectors/.

Can I check each number against the source?

Yes. Each metric includes source_text, the text from the source document, and source_url, a link to that document. When a text-level citation is available, the link highlights the source text in the browser.

Can I get company guidance and non-GAAP metrics too?

Yes. Guidance returns forward guidance from earnings releases as ranges, point estimates, or directional signals. Non-GAAP Metrics returns adjusted metrics, such as adjusted EPS, with their GAAP equivalents and key adjustments.

Can an AI agent use this data?

Yes. Claude, ChatGPT, Cursor, and other MCP clients reach it through the Financial Datasets MCP server. An agent with a wallet can also pay per request with x402, with no account.

Authorizations

X-API-KEY
string
header
required

API key for authentication.

Query Parameters

ticker
string
required

The ticker symbol.

metric_name
string

Filter to a specific metric (e.g., load_factor, cet1_ratio).

period
enum<string>
default:quarterly

Filter by period type: quarterly or annual.

Available options:
quarterly,
annual
report_period_gte
string<date>

Only return metrics on or after this date (YYYY-MM-DD).

report_period_lte
string<date>

Only return metrics on or before this date (YYYY-MM-DD).

limit
integer
default:4

Number of periods to return. Returns all metrics for the N most recent periods. This is the total across all pages, not a page size: each page holds up to 10 records, linked by next_page_url.

Required range: x <= 50
cursor
string

Opaque pagination cursor from a previous response's next_page_url. When provided, all other query parameters are ignored: the cursor carries the original request's filters. Treat it as opaque; do not construct or modify it.

Response

KPI metrics response

kpi_metrics
object[]
next_page_url
string

Absolute URL of the next page of results. Present only when more results remain; request it as-is to continue. Each page holds up to 10 records.