# SEC XBRL Financial Data Lookup

> SEC XBRL Financial Data Lookup is a paid API for AI agents from x402-agent-api.onrender.com, paid per call via x402, $0.005/call, status unknown (last checked 2026-10-10).

Retrieves key financial metrics from SEC XBRL filings for US public companies, including income statement, balance sheet, and cash flow data for annual or quarterly periods.

## Facts

- Endpoint: POST https://x402-agent-api.onrender.com/api/v1/sec-financials?utm_source=zero.xyz
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-10
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/sec-xbrl-financial-data-lookup-64dd7e44
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_3Qg8bCI84oA6W_um7GaD0

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-financial-data-lookup-64dd7e44 -d '<json body>'
```

Example prompt: What were Apple's revenue, net income, and free cash flow over the last 5 fiscal years? Pull the annual figures from SEC filings.

## When to prefer this

Use this endpoint when you need structured, machine-readable financial data from official SEC XBRL filings for US public companies — ideal for quantitative analysis, financial modeling, or answering specific metric questions. Prefer this over web-scraped financials for accuracy and over SEC filing text endpoints when you need numbers rather than narrative. Best when you already know the ticker or company name and need income statement, balance sheet, or cash flow data for up to 20 annual or quarterly periods.

## Known failure modes

- Company not found by ticker/CIK/name — returns matching tickers for free if name is ambiguous
- No XBRL data available for the requested periods — not charged
- Invalid ticker format rejected by schema validation
- Requested fiscal_year beyond available filing history
- Rate limiting or service unavailability on the hosted endpoint

## How this service works

Answers 'What were Apple's revenue and net income over the last five years?' or 'Is Tesla free-cash-flow positive?'. Key financials from SEC XBRL filings for a company's last fiscal years or quarters: revenue, gross and operating profit, net income, EPS, cash, debt, equity, operating cash flow, capex, free cash flow, margins and growth. Derived Q4 and quarterly cash flows are flagged. By ticker, CIK or name. Not charged if no data. $0.005 USDC per call.

## Output

A JSON object containing company identifiers (ticker, CIK, name), currency, and an array of fiscal periods (annual or quarterly) each with: income statement data (revenue, gross profit, operating income, net income, EPS, R&D, SG&A), balance sheet data (cash, assets, liabilities, debt, equity), cash flow data (operating cash flow, capex, free cash flow, dividends, buybacks), computed ratios (gross margin, operating margin, net margin, revenue growth), XBRL concept mappings, and suggested follow-up calls. Derived metrics like free cash flow and Q4 figures are flagged. No charge if no data is found.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "cik": {
   "anyOf": [
    {
     "type": "string",
     "pattern": "^\\d{1,10}$"
    },
    {
     "type": "integer",
     "maximum": 9007199254740991,
     "exclusiveMinimum": 0
    }
   ],
   "description": "SEC Central Index Key, e.g. 320193. Use this, `ticker` or `company`."
  },
  "limit": {
   "type": "integer",
   "default": 5,
   "maximum": 20,
   "minimum": 1,
   "description": "How many periods to return, newest first (1-20, default 5)."
  },
  "period": {
   "enum": [
    "annual",
    "quarterly"
   ],
   "type": "string",
   "default": "annual",
   "description": "Fiscal years from 10-Ks (annual, the default) or single quarters (quarterly)."
  },
  "ticker": {
   "type": "string",
   "pattern": "^[A-Z][A-Z0-9.\\-]{0,9}$",
   "description": "US stock ticker, e.g. AAPL, MSFT, BRK-B. Use this, `cik` or `company`."
  },
  "company": {
   "type": "string",
   "maxLength": 120,
   "minLength": 2,
   "description": "Company name, e.g. \"Apple\" or \"Coca-Cola\". Use this, `ticker` or `cik`; a name matching several companies returns their tickers, free."
  },
  "fiscal_year": {
   "type": "integer",
   "maximum": 2100,
   "minimum": 2001,
   "description": "Return periods up to this fiscal year (the calendar year the fiscal year ends in) instead of the latest, e.g. 2019."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "cik": "320193",
  "count": 1,
  "period": "annual",
  "source": "sec-edgar-xbrl",
  "ticker": "AAPL",
  "company": "Apple Inc.",
  "periods": [
   {
    "end": "2024-09-28",
    "form": "10-K",
    "filed": "2025-10-31",
    "start": "2023-10-01",
    "ratios": {
     "net_margin_percent": 24,
     "gross_margin_percent": 46.2,
     "revenue_growth_percent": 2,
     "operating_margin_percent": 31.5
    },
    "derived": [
     "free_cash_flow"
    ],
    "cash_flow": {
     "dividends_paid": 15234000000,
     "free_cash_flow": 108807000000,
     "share_repurchases": 94949000000,
     "capital_expenditure": 9447000000,
     "operating_cash_flow": 118254000000
    },
    "fiscal_year": 2024,
    "balance_sheet": {
     "cash": 29943000000,
     "total_assets": 364980000000,
     "current_assets": 152987000000,
     "long_term_debt": 85750000000,
     "total_liabilities": 308030000000,
     "current_liabilities": 176392000000,
     "stockholders_equity": 56950000000
    },
    "fiscal_period": "FY",
    "accession_number": "0000320193-25-000079",
    "filing_index_url": "https://www.sec.gov/Archives/edgar/data/320193/000032019325000079/0000320193-25-000079-index.htm",
    "income_statement": {
     "revenue": 391035000000,
     "eps_basic": 6.11,
     "income_tax": 29749000000,
     "net_income": 93736000000,
     "eps_diluted": 6.08,
     "gross_profit": 180683000000,
     "pretax_income": 123485000000,
     "diluted_shares": 15408095000,
     "cost_of_revenue": 210352000000,
     "operating_income": 123216000000,
     "research_and_development": 31370000000,
     "selling_general_administrative": 26097000000
    }
   }
  ],
  "concepts": {
   "revenue": "us-gaap:RevenueFromContractWithCustomerExcludingAssessedTax",
   "net_income": "us-gaap:NetIncomeLoss"
  },
  "currency": "USD",
  "next_calls": [
   {
    "why": "What does management say drove these numbers (MD&A of the latest 10-K)?",
    "tool": "sec_filing_section",
    "price": "$0.01",
    "arguments": {
     "ticker": "AAPL",
     "section": "mda"
    }
   }
  ]
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/sec-xbrl-financial-data-lookup-64dd7e44/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402-agent-api.onrender.com](https://www.zero.xyz/host/x402-agent-api.onrender.com/llms.txt)