{"uid":"cap_B5kwH1gzLCawPbH9AoKYa","slug":"edgar-fundamental-scores-history-736f2973","name":"EDGAR Fundamental Scores History","description":"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).","url":"https://fundamental-scores-x402.onrender.com/v1/history/:ticker?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":null,"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.008","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"registry","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.008/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.008","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.008","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_r2v0zA9mQvfdEUZhr_5FA","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.008","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"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.","exampleAgentPrompt":"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?","exampleUseCases":[{"title":"Pre-investment fundamental health check","prompt":"Before I buy shares in Intel (INTC), can you show me the last 7 years of Piotroski F-Score, Altman Z-Score, and Beneish M-Score from their SEC filings, plus the Piotroski trend — I want to know if the business is getting stronger or weaker?"},{"title":"Bankruptcy risk screening for a distressed stock","prompt":"I'm looking at Bed Bath & Beyond as a cautionary case — can you get me 10 years of Altman Z-Score and Piotroski F-Score history for BBBY from SEC EDGAR so I can see how far in advance the distress signals appeared?"},{"title":"Earnings manipulation detection over time","prompt":"Can you pull 5 years of Beneish M-Score history for Under Armour (UAA) from SEC EDGAR XBRL? I want to see if there were any years where the score flagged possible earnings manipulation."}],"resultDescription":"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.","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-30T12:31:06.048Z","isFirstParty":false,"canonicalSlug":"edgar-fundamental-scores-history-736f2973"}