# AgentFilings Earnings Summary

> AgentFilings Earnings Summary is a paid API for AI agents from api.agentfilings.com, paid per call via x402, $0.02/call, status unknown (last checked 2026-10-13).

Returns structured earnings summary data (revenue, net income, EPS) for a given US-listed stock ticker, sourced from SEC/EDGAR XBRL filings.

## Facts

- Endpoint: GET https://api.agentfilings.com/earnings/summary?utm_source=zero.xyz
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/agentfilings-earnings-summary-4b87c0ee
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_F57zkCDPPpaSVp4w_tdXC

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 agentfilings-earnings-summary-4b87c0ee
```

Example prompt: Pull the quarterly earnings summary for AAPL from AgentFilings — I need the revenue, net income, and EPS figures for Q2 fiscal year 2026.

## When to prefer this

Use this endpoint when you need clean, structured earnings data (revenue, net income, EPS) derived directly from SEC EDGAR XBRL filings for US-listed companies. Prefer it over scraping financial news sites or using raw EDGAR APIs, as it returns normalized JSON with no parsing overhead. Ideal for AI agents that need to answer earnings questions, build financial summaries, or feed structured financial data into downstream analysis — especially when XBRL accuracy and SEC provenance are important.

## Known failure modes

- Unknown or invalid ticker symbol returns empty results or an error
- Ticker exists but has no XBRL-tagged filings on EDGAR (e.g. foreign private issuers)
- Requested period filter returns no matching filings
- Rate limiting or payment failure (x402) if USDC payment is not properly handled
- Stale cache may return slightly delayed data vs. real-time EDGAR submissions

## How this service works

Structured US SEC/EDGAR filing data for AI agents — filings, XBRL-derived earnings, and Form 4 insider transactions as clean JSON.

## Output

A JSON object containing an array of earnings periods for the requested ticker, each with revenue, net income, basic and diluted EPS, fiscal year, fiscal period label, period start/end dates, the SEC form type (e.g. 10-Q or 10-K), filing date, and source accession number. Also includes metadata about cache status and retrieval time.

## 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": [
      "ticker"
     ],
     "properties": {
      "period": {
       "type": "string",
       "description": "Optional filter: \"annual\" | \"quarterly\" | \"interim\", a fiscal year (\"2025\" or \"FY2025\"), or an SEC frame (\"CY2026Q1\")"
      },
      "ticker": {
       "type": "string",
       "description": "Ticker symbol, e.g. AAPL"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "data": {
   "count": 1,
   "ticker": "AAPL",
   "periods": [
    {
     "form": "10-Q",
     "revenue": 111184000000,
     "duration": "quarterly",
     "filed_at": "2026-05-01",
     "eps_basic": 2.02,
     "net_income": 29578000000,
     "period_end": "2026-03-28",
     "eps_diluted": 2.01,
     "fiscal_year": 2026,
     "period_start": "2025-12-28",
     "fiscal_period": "Q2",
     "source_accession": "0000320193-26-000013"
    }
   ]
  },
  "meta": {
   "cache": "miss",
   "source_api": "sec-edgar-companyfacts",
   "retrieved_at": "2026-07-26T01:35:41Z"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agentfilings-earnings-summary-4b87c0ee/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.agentfilings.com](https://www.zero.xyz/host/api.agentfilings.com/llms.txt)