SEC company financialsSEC company financialsReturns JSON with a US-listed company's annual revenue, net and operating income, diluted EPS, operating cash flow and year-end balance sheet from SEC filings.
Use when you need sec filings company financials, earnings or fundamentals for a stock ticker for the last two fiscal years.
Do not use when you need quarterly numbers, real-time prices, non-US companies or filings older than two years.
Price: 0.02 USDC per call (x402, eip155:8453). Typical response time: 300 ms (p95).
POST https://x402-gateway.blackwoodstate8.workers.dev/v1/sec-facts. A request without payment gets 402 Payment Required with the
PAYMENT-REQUIRED header; any x402 client signs an EIP-3009 authorization and retries with
PAYMENT-SIGNATURE (or X-PAYMENT). Invalid input is answered with 400 and not charged.
curl -i -X POST https://x402-gateway.blackwoodstate8.workers.dev/v1/sec-facts -H 'content-type: application/json' -d '{"ticker":"AAPL"}'
| Pay to | 0xd5aaE5bc1E31dF704Fe7Dc65F252D620c02fB6D7 |
|---|---|
| Asset | 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913 (USDC) |
| Amount | 20000 atomic units (0.02 USDC) |
| Authorization window | 60 s |
Streamable HTTP at https://x402-gateway.blackwoodstate8.workers.dev/mcp, tool sec-facts_v1. Payment goes in
_meta["x402/payment"]; without it the tool returns the payment requirements.
| Field | Type | Meaning |
|---|---|---|
ticker | string | Stock ticker of a company that files with the SEC, e.g. AAPL |
Example:
{
"ticker": "AAPL"
}
Real 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"
}
{
"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"
]
}
},
"required": [
"ticker",
"cik",
"name",
"exchange",
"currency",
"fiscalYears",
"balanceSheets",
"source",
"dataUpdatedAt"
],
"additionalProperties": false
}Free schema and example: GET https://x402-gateway.blackwoodstate8.workers.dev/v1/sec-facts.
OpenAPI 3.1 · llms.txt · All services