# Tanod SEC Financial Statements API > Tanod SEC Financial Statements API is a paid API for AI agents from tanod.dev, paid per call via x402, $0.005/call, status unknown (last checked 2026-10-10). Retrieves standardized financial metrics (revenue, net income, EPS, total assets) from SEC EDGAR XBRL filings for a given public company by ticker or CIK, for annual or quarterly periods. ## Facts - Endpoint: POST https://tanod.dev/v1/finance/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/tanod-sec-financial-statements-api-8786ee5f - Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_F309trUm0c688QgjO6a7_ 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 tanod-sec-financial-statements-api-8786ee5f -d '' ``` Example prompt: Pull the last 4 annual periods of SEC financials for Apple — ticker AAPL — including revenue, net income, diluted EPS, and total assets. ## When to prefer this Choose this endpoint when you need standardized, auditable financial metrics (revenue, net income, EPS, total assets) pulled directly from official SEC EDGAR XBRL filings for US-listed public companies. It is ideal when regulatory-grade sourcing matters (e.g. the data is attributed to actual 10-K/10-Q filings with accession numbers). Prefer it over third-party financial data APIs when you need transparency about the underlying SEC filing and XBRL tag used. It is a pay-per-call endpoint with no signup, so it is well-suited for on-demand agent workflows. ## Known failure modes - Unknown ticker or CIK returns empty or error response - Company does not file XBRL with SEC (non-US or non-EDGAR filers) — metrics will be null or absent - Metric not reported for a given period returns null for that field - Limit out of range (must be 1–20) causes validation error - Stale cache may serve data up to 6 hours old (cache_seconds: 21600) - Payment failure (x402) if USDC balance is insufficient ## How this service works One MCP server and HTTP API with 193 pay-per-call tools for AI agents (security checks, chain data, finance, aviation, documents), plus free uptime and MikroTik monitoring and 130+ free browser tools. No signup; free daily tier. Operated by an AI. ## Output Returns a JSON object containing the company name, CIK, ticker, currency, and an array of fiscal periods each with standardized financial metrics (revenue, net income, diluted EPS, total assets) sourced directly from SEC EDGAR XBRL company facts, including the underlying XBRL tag, taxonomy, filing accession number, period start/end dates, and whether the data was served from cache. ## Request schema (JSON Schema) ```json { "type": "object", "properties": { "cik": { "anyOf": [ { "type": "integer" }, { "type": "string", "maxLength": 16, "minLength": 1 }, { "type": "null" } ], "default": null, "description": "SEC Central Index Key, 1-10 digits, as a number or a string (leading zeros and a CIK prefix allowed, such as 320193 or 0000320193). Send ticker or cik." }, "limit": { "type": "integer", "default": 4, "maximum": 20, "minimum": 1, "description": "Newest periods to return, 1-20 (default 4)." }, "period": { "enum": [ "annual", "quarterly" ], "type": "string", "default": "annual", "description": "annual: fiscal years from 10-K filings; quarterly: the discrete quarters in 10-Q filings." }, "ticker": { "anyOf": [ { "type": "string", "maxLength": 12, "minLength": 1 }, { "type": "null" } ], "default": null, "description": "Exchange ticker such as AAPL (class shares as BRK-B, BRK.B or BRK/B). Send ticker or cik." } } } ``` ## Response schema (JSON Schema) ```json { "type": "json", "example": { "cik": "0000320193", "name": "Apple Inc.", "note": "Values as reported in SEC XBRL company facts; a metric not reported for the period is null.", "count": 1, "stale": false, "cached": false, "period": "annual", "source": { "url": "https://www.sec.gov/search-filings/edgar-application-programming-interfaces", "name": "U.S. Securities and Exchange Commission, EDGAR APIs (submissions, XBRL company facts)", "terms": "https://www.sec.gov/about/developer-resources", "notice": "Data: SEC EDGAR. No endorsement by the SEC is implied.", "license": "US Government work, public domain" }, "ticker": "AAPL", "periods": [ { "form": "10-K", "metrics": { "revenue": { "tag": "RevenueFromContractWithCustomerExcludingAssessedTax", "form": "10-K", "unit": "USD", "filed": "2025-10-31", "value": 416161000000, "taxonomy": "us-gaap", "accession": "0000320193-25-000079", "periodEnd": "2025-09-27", "fiscalYear": 2025, "periodStart": "2024-09-29", "fiscalPeriod": "FY" }, "netIncome": { "tag": "NetIncomeLoss", "form": "10-K", "unit": "USD", "filed": "2025-10-31", "value": 112010000000, "taxonomy": "us-gaap", "accession": "0000320193-25-000079", "periodEnd": "2025-09-27", "fiscalYear": 2025, "periodStart": "2024-09-29", "fiscalPeriod": "FY" }, "epsDiluted": { "tag": "EarningsPerShareDiluted", "form": "10-K", "unit": "USD/shares", "filed": "2025-10-31", "value": 7.46, "taxonomy": "us-gaap", "accession": "0000320193-25-000079", "periodEnd": "2025-09-27", "fiscalYear": 2025, "periodStart": "2024-09-29", "fiscalPeriod": "FY" }, "totalAssets": { "tag": "Assets", "form": "10-K", "unit": "USD", "filed": "2025-10-31", "value": 359241000000, "taxonomy": "us-gaap", "accession": "0000320193-25-000079", "periodEnd": "2025-09-27", "fiscalYear": 2025, "periodStart": null, "fiscalPeriod": "FY" } }, "accession": "0000320193-25-000079", "periodEnd": "2025-09-27", "fiscalYear": 2025, "fiscalPeriod": "FY" } ], "currency": "USD", "disclaimer": "Informational only. Not investment advice.", "cache_seconds": 21600 } } ``` ## More - Live health (JSON, refreshed every minute): https://www.zero.xyz/c/tanod-sec-financial-statements-api-8786ee5f/health.json - [Zero catalog index](https://www.zero.xyz/llms.txt) - [Other services from tanod.dev](https://www.zero.xyz/host/tanod.dev/llms.txt)