# SEC XBRL Normalized Headline Financials

> SEC XBRL Normalized Headline Financials is a paid API for AI agents from bryan-hermes.lenok-gorgon.ts.net:8443, paid per call via x402, $0.01/call, status unknown (last checked 2026-10-13).

Returns normalized, period-labeled headline financial metrics (revenue, net income, assets, etc.) for a public company, with XBRL tags resolved across filers and period types clearly disambiguated.

## Facts

- Endpoint: GET https://bryan-hermes.lenok-gorgon.ts.net:8443/v1/financials?utm_source=zero.xyz
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/sec-xbrl-normalized-headline-financials-2723b61a
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_siXELoE7roxYT-qWDaiLu

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 sec-xbrl-normalized-headline-financials-2723b61a
```

Example prompt: Pull the last 8 quarters of normalized headline financials for Apple — revenue, net income, diluted EPS, and total assets — and make sure quarterly and annual figures are clearly labeled so I can spot the trends without mixing cumulative and standalone numbers.

## When to prefer this

Choose this endpoint when you need clean, period-disambiguated headline financials from SEC filings without building your own XBRL parser. It is especially valuable when you need to compare metrics across quarters without accidentally mixing YTD cumulative figures with standalone quarterly results. Prefer this over raw EDGAR XBRL APIs when normalized concept names and period-type labels are critical for downstream analysis or modeling.

## Known failure modes

- Unknown ticker or CIK returns a 404 or empty result set
- Concept not filed by a particular company returns no data points for that concept
- Requesting more periods than available returns fewer results than requested without error
- Malformed concept names in the comma-separated list may be silently ignored
- Rate limiting or payment failure (x402) returns a 402 Payment Required error
- Very small or foreign-private issuers may have sparse or missing XBRL data

## How this service works

Normalized headline financials. Equivalent XBRL tags are resolved across filers and every point is labelled quarter / ytd_half / ytd_nine_months / annual / instant, so cumulative and quarterly figures can never be silently compared against each other.

## Output

A structured list of financial data points per requested concept, each tagged with the company CIK/ticker, the concept name (e.g. revenue, eps_diluted), the reported value, the fiscal period end date, and a period-type label (quarter / ytd_half / ytd_nine_months / annual / instant). XBRL tag differences across filers are resolved to a consistent normalized concept name.

## 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",
      "HEAD",
      "DELETE"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [],
     "properties": {
      "cik": {
       "type": "string",
       "description": "CIK"
      },
      "ticker": {
       "type": "string",
       "description": "Issuer ticker"
      },
      "periods": {
       "type": "integer",
       "default": 8,
       "description": "Recent periods per concept"
      },
      "concepts": {
       "type": "string",
       "description": "Comma-separated: revenue, net_income, operating_income, assets, liabilities, stockholders_equity, cash_and_equivalents, eps_diluted, shares_outstanding"
      }
     }
    }
   },
   "additionalProperties": false
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/sec-xbrl-normalized-headline-financials-2723b61a/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from bryan-hermes.lenok-gorgon.ts.net:8443](https://www.zero.xyz/host/bryan-hermes.lenok-gorgon.ts.net%3A8443/llms.txt)