# EDGAR Fundamental Scores History

> EDGAR Fundamental Scores History is a paid API for AI agents from fundamental-scores-x402.onrender.com, paid per call via x402, $0.008/call, status unknown (last checked 2026-10-30).

Returns up to 10 fiscal years of Piotroski F-Score, Altman Z-Score, and Beneish M-Score plus key financials and a trend signal for a US public company from SEC EDGAR XBRL data.

## Facts

- Endpoint: GET https://fundamental-scores-x402.onrender.com/v1/history/:ticker?utm_source=zero.xyz
- Price: $0.008/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-30
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/edgar-fundamental-scores-history-736f2973
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_B5kwH1gzLCawPbH9AoKYa

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability edgar-fundamental-scores-history-736f2973
```

Example prompt: Can you pull the last 8 years of Piotroski F-Score, Altman Z-Score, and Beneish M-Score for Tesla (TSLA) from SEC EDGAR, and tell me whether the Piotroski trend is improving or deteriorating?

## When to prefer this

Use this endpoint when you need a multi-year historical view of quantitative fundamental scores (Piotroski, Altman, Beneish) for a US-listed public company sourced directly from SEC EDGAR XBRL data. It is the right choice for trend analysis, pre-investment due diligence, bankruptcy risk screening, or earnings quality research where a time-series of scores matters more than a single-point verdict. Prefer it over the single-year snapshot endpoints when longitudinal comparison across fiscal years is required.

## Known failure modes

- Invalid or unrecognized ticker symbol — rejected before payment is charged
- Company not listed on a US exchange or lacks SEC EDGAR XBRL data — error returned, no charge
- years parameter out of range (must be 1–10) — validation error
- Fewer than requested years of XBRL data available for the company — partial results returned
- SEC EDGAR service unavailable — upstream timeout, call not settled
- Render cold-start latency on first call after idle period

## How this service works

Up to 10 fiscal years of Piotroski F, Altman Z and Beneish M for a US public company, plus revenue, net income, operating cash flow and total assets per year from SEC EDGAR XBRL, and a Piotroski trend (improving/flat/deteriorating). Query years=1-10 (default 5). Errors are never charged (bad tickers rejected before payment; failed calls not settled).

## Output

A time-series array of annual records for the requested ticker, each containing the fiscal year, Piotroski F-Score, Altman Z-Score, Beneish M-Score, revenue, net income, operating cash flow, and total assets, plus an overall Piotroski trend label (improving/flat/deteriorating) for the period covered.

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/edgar-fundamental-scores-history-736f2973/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from fundamental-scores-x402.onrender.com](https://www.zero.xyz/host/fundamental-scores-x402.onrender.com/llms.txt)