{"service":"sec-facts","version":"1.0.0","title":"SEC company financials","description":"Use when you need company financials from SEC filings, earnings or fundamentals of a US company by ticker for the last two years. Do not use for quarterly numbers, real-time prices, non-US companies or filings older than two years. Returns JSON with SEC company financials for a US stock ticker from 10-K filings on SEC EDGAR: annual revenue, net and operating income, diluted EPS, cash flow and the balance sheet for 0.02 USDC per call. Typical response time 300 ms (p95). Category: Data.","paid":{"method":"POST","url":"https://x402-gateway.blackwoodstate8.workers.dev/v1/sec-facts","scheme":"exact","network":"eip155:8453","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","amount":"20000","amountUsdc":"0.02","payTo":"0xd5aaE5bc1E31dF704Fe7Dc65F252D620c02fB6D7","maxTimeoutSeconds":60},"input":{"schema":{"type":"object","properties":{"ticker":{"type":"string","pattern":"^[A-Za-z][A-Za-z0-9.\\-]{0,9}$","description":"Stock ticker of a company that files with the SEC, e.g. AAPL"}},"required":["ticker"]},"example":{"ticker":"AAPL"}},"output":{"schema":{"type":"object","properties":{"ticker":{"type":"string"},"cik":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"name":{"type":"string"},"exchange":{"type":["string","null"]},"currency":{"type":"string","const":"USD"},"fiscalYears":{"type":"array","items":{"type":"object","properties":{"calendarYear":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"start":{"type":["string","null"]},"end":{"type":"string"},"revenue":{"type":["number","null"]},"netIncome":{"type":["number","null"]},"operatingIncome":{"type":["number","null"]},"epsDiluted":{"type":["number","null"]},"operatingCashFlow":{"type":["number","null"]},"accn":{"type":["string","null"]}},"required":["calendarYear","start","end","revenue","netIncome","operatingIncome","epsDiluted","operatingCashFlow","accn"],"additionalProperties":false}},"balanceSheets":{"type":"array","items":{"type":"object","properties":{"calendarYear":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"asOf":{"type":"string"},"assets":{"type":["number","null"]},"liabilities":{"type":["number","null"]},"equity":{"type":["number","null"]},"cash":{"type":["number","null"]}},"required":["calendarYear","asOf","assets","liabilities","equity","cash"],"additionalProperties":false}},"source":{"type":"string"},"dataUpdatedAt":{"type":["string","null"]},"next":{"type":"object","properties":{"service":{"type":"string","description":"Service id of the suggested next paid call"},"tool":{"type":"string","description":"MCP tool name of the same call"},"method":{"type":"string","enum":["GET","POST"]},"url":{"type":"string","description":"Paid route of the next call"},"useWhen":{"type":"string","description":"When the next call is the right one"},"sample":{"type":"string","description":"Free fixed sample of the whole family"}},"required":["service","tool","method","url","useWhen","sample"],"additionalProperties":false,"description":"Suggested next paid call in the same family (call it in a loop when the task continues)"}},"required":["ticker","cik","name","exchange","currency","fiscalYears","balanceSheets","source","dataUpdatedAt"],"additionalProperties":false},"example":{"ticker":"AAPL","cik":320193,"name":"Apple Inc.","exchange":"Nasdaq","currency":"USD","fiscalYears":[{"calendarYear":2025,"start":"2024-09-29","end":"2025-09-27","revenue":416161000000,"netIncome":112010000000,"operatingIncome":133050000000,"epsDiluted":7.46,"operatingCashFlow":111482000000,"accn":"0000320193-25-000079"},{"calendarYear":2024,"start":"2023-10-01","end":"2024-09-28","revenue":391035000000,"netIncome":93736000000,"operatingIncome":123216000000,"epsDiluted":6.08,"operatingCashFlow":118254000000,"accn":"0000320193-25-000079"}],"balanceSheets":[{"calendarYear":2025,"asOf":"2025-12-27","assets":379297000000,"liabilities":291107000000,"equity":88190000000,"cash":45317000000},{"calendarYear":2024,"asOf":"2024-12-28","assets":344085000000,"liabilities":277327000000,"equity":66758000000,"cash":30299000000}],"source":"SEC EDGAR XBRL frames (data.sec.gov)","dataUpdatedAt":"2026-10-16T15:00:00.000Z"}},"mcp":{"url":"https://x402-gateway.blackwoodstate8.workers.dev/mcp","tool":"blackwood_sec_facts"},"openapi":"https://x402-gateway.blackwoodstate8.workers.dev/openapi.json","status":"https://x402-gateway.blackwoodstate8.workers.dev/status.json"}