# EDGAR Fundamental Scores – Multi-Ticker Portfolio Screener

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

Screens 1–50 US public companies in a single call, returning Piotroski F-Score, Altman Z-Score, Beneish M-Score verdicts (healthy/watch/distress + fraud-risk flag) ranked by risk, paid via x402 USDC micropayment.

## Facts

- Endpoint: GET https://fundamental-scores-x402.onrender.com/v1/screen?utm_source=zero.xyz
- Price: $1/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-multi-ticker-portfolio-screener-1a777b51
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_QlH497494EwRk-l2-ygn6

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-multi-ticker-portfolio-screener-1a777b51
```

Example prompt: Can you screen AAPL, TSLA, SMCI, and NVDA for financial health right now — I want to see their Piotroski, Altman, and Beneish scores and which ones are in distress or have elevated fraud risk?

## When to prefer this

Choose this endpoint when you need to screen multiple US public companies at once (up to 50) against all three classical scoring models (Piotroski, Altman, Beneish) in a single paid call. It is more cost-effective than calling the single-ticker endpoint repeatedly when evaluating a portfolio or watchlist. Prefer this over the single-ticker variant when you need ranked, comparative output across several companies. Use it when no API key setup is acceptable and USDC micropayment per call is preferred.

## Known failure modes

- Invalid or unknown ticker returns it in the 'failed' array with no score
- Tickers without sufficient EDGAR XBRL data may fail to score
- More than 50 tickers in a single call will be rejected
- x402 payment failure or insufficient USDC balance blocks the call
- Render cold-start latency may cause timeout on first request after idle period

## How this service works

Pay-per-call verdicts for US public companies from SEC EDGAR: financial health (healthy/watch/distress + fraud-risk flag from Piotroski F, Altman Z, Beneish M), insider-trading verdict from Form 4s, red-flag events from 8-Ks and late filings, and a daily most-distressed list. x402 USDC micropayments, no account or key. Not investment advice.

## Output

Returns a ranked list of companies by risk score, each with: one-line verdict string, health verdict (healthy/watch/distress), fraud risk level (low/elevated), Piotroski F-Score (0–9), Altman Z-Score and zone (safe/grey/distress), Beneish M-Score, fiscal year end date, and aggregate counts by verdict category. Failed tickers are listed separately.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "tickers"
     ],
     "properties": {
      "tickers": {
       "type": "string",
       "description": "comma-separated tickers or CIKs, 1-50"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "counts": {
   "watch": 2,
   "healthy": 2,
   "distress": 0,
   "fraudRiskElevated": 1
  },
  "failed": [],
  "ranked": [
   {
    "line": "SMCI: watch | fraud-risk elevated | Piotroski 3/8 middling; Altman Z' 2.635 grey; negative operating cash flow; Beneish M 0.048 above -1.78 (medium reliability) (FY 2026-06-30)",
    "reason": "Piotroski 3/8 middling; Altman Z' 2.635 grey; negative operating cash flow; Beneish M 0.048 above -1.78 (medium reliability)",
    "ticker": "SMCI",
    "altmanZ": 2.635,
    "verdict": "watch",
    "beneishM": 0.048,
    "fraudRisk": "elevated",
    "altmanZone": "grey",
    "piotroskiF": 3,
    "riskPoints": 3,
    "fiscalYearEnd": "2026-06-30"
   }
  ],
  "scored": 4,
  "requested": 4
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/edgar-fundamental-scores-multi-ticker-portfolio-screener-1a777b51/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)