# FilingsPulse Earnings Brief

> FilingsPulse Earnings Brief is a paid API for AI agents from filingspulse.theaslangroupllc.com, paid per call via x402, $0.25/call, status unknown (last checked 2026-09-14).

Returns the last 8 quarters of revenue, net income, and diluted EPS (sourced from SEC XBRL) with year-over-year deltas, an estimated next earnings window, and consensus/guidance context from live news for any US-listed company.

## Facts

- Endpoint: GET https://filingspulse.theaslangroupllc.com/api/filings/earnings
- Price: $0.25/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/filingspulse-earnings-brief-a70a0ad8
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_bkk8zH1LI9lnv1WjRSvgt

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 filingspulse-earnings-brief-a70a0ad8
```

Example prompt: Pull me an earnings brief for NVIDIA — I want the last 8 quarters of revenue, net income, and diluted EPS from SEC XBRL with year-over-year deltas, when they're likely to report next, and any analyst consensus or guidance context from recent news.

## When to prefer this

Use this endpoint when you need a rapid, source-attributed earnings summary for a US-listed company, especially during earnings season or for equity analysis workflows. Prefer this over general financial data APIs when you need XBRL-verified figures directly from SEC filings, computed YoY deltas, and an estimated next-report window in a single call. Choose this over sibling endpoints when the specific need is historical quarterly financials (revenue, net income, EPS) rather than 8-K event alerts, insider trades, or 13F ownership data.

## Known failure modes

- Ticker not found or not US-listed — endpoint returns an error indicating the company is not in SEC EDGAR
- Insufficient XBRL history — fewer than 8 quarters available for newer public companies
- Live news context unavailable — consensus/guidance section may be empty or stale
- Rate limiting or payment failure — 402 payment required if USDC payment is not attached
- Invalid ticker format — malformed input returns a validation error

## How this service works

Earnings brief for any US-listed company: the last 8 quarters of revenue, net income, and diluted EPS pulled verbatim from SEC XBRL with year-over-year deltas computed in code, an estimated next-report window from the company's own 8-K filing cadence, plus consensus/guidance context from live news (each figure source-attributed). Built for earnings-season research and equity-analysis agents.

## Output

A structured earnings brief containing 8 quarters of revenue, net income, and diluted EPS figures verbatim from SEC XBRL filings, computed year-over-year deltas for each metric, an estimated next earnings report window derived from the company's 8-K filing cadence, and consensus/guidance context sourced from live news — each figure source-attributed.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "lang": {
   "type": "string",
   "description": "Response language code (e.g. es, fr, de); defaults to English"
  },
  "ticker": {
   "type": "string",
   "description": "US stock ticker (most reliable resolution)"
  },
  "company": {
   "type": "string",
   "description": "Company name (used if ticker not given)"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "cik": "0000019617",
  "ticker": "JPM",
  "company": "JPMORGAN CHASE & CO",
  "quarters": [
   {
    "fiscal": "FY2026 Q1",
    "derived": [],
    "revenue": 49800000000,
    "net_income": 16500000000,
    "period_end": "2026-03-31",
    "eps_diluted": 5.94,
    "revenue_yoy_pct": 10,
    "net_income_yoy_pct": 12.5
   }
  ],
  "disclaimer": "Informational only, not investment advice. Verify against the primary filing before trading.",
  "data_source": "SEC EDGAR XBRL company facts (data.sec.gov) — figures as reported; Q4 rows marked derived are computed FY minus Q1–Q3",
  "report_cadence": {
   "method": "Estimated from the company's own historical 8-K Item 2.02 filing cadence in SEC EDGAR — an estimate, not an announced date.",
   "just_reported": false,
   "median_gap_days": 91,
   "last_report_date": "2026-04-14",
   "next_report_estimate": {
    "latest": "2026-07-21",
    "earliest": "2026-07-07"
   }
  },
  "trajectory_read": "Revenue and net income both up double digits year over year …",
  "consensus_context": "Per the provided sources, analysts expected …"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/filingspulse-earnings-brief-a70a0ad8/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from filingspulse.theaslangroupllc.com](https://www.zero.xyz/host/filingspulse.theaslangroupllc.com/llms.txt)