$ man sec-filing
/sec-filing(1)
PRICE / CALL
$0.01
USDC · base mainnet · scheme: exact
METHOD
POST
CLUSTER
edgefinanceCATEGORY
finance
STATUS
● live
NAME
sec-filing — sec edgar filing fetcher + parser + summarizer
SYNOPSIS
POST https://x402.org/v1/sec-filing
Content-Type: application/json
X-PAYMENT: <signed-transferWithAuthorization>
{ ... }↳ first call →
402 Payment Required. Sign USDCtransferWithAuthorization, retry with theX-PAYMENT header.DESCRIPTION
SEC EDGAR filing fetcher + parser + summarizer. 10-K, 10-Q, 8-K, S-1, S-4, DEF 14A, 4, 13F-HR. Returns structured filing metadata, clean text, and optional Venice executive summary tuned to the form type. 100% public-domain SEC data.
INPUT — request schema
| property | type | description | req? |
|---|---|---|---|
| ticker | string | US stock ticker (e.g. 'AAPL'). Either ticker or cik required. | optional |
| cik | string | SEC Central Index Key (10-digit, with or without leading zeros). | optional |
| form_type | string | Filing type to fetch. Default '10-K'. Supports '10-K', '10-Q', '8-K', 'S-1', 'DEF 14A', '4', '13F-HR'. | optional |
| limit | number | Max filings to return (1-20). Default 5. | optional |
| summarize | boolean | If true, run latest filing through Venice for an executive summary tuned to the form type. | optional |
| include_text | boolean | If true, return full clean-text body of the latest filing (capped at 200k chars). | optional |
OUTPUT — response shape
| field | type | description |
|---|---|---|
| ticker | string | Stock ticker symbol resolved for the company (e.g., AAPL, MSFT), uppercase. |
| cik | string | SEC Central Index Key, the 10-digit zero-padded identifier EDGAR uses for the filer. |
| company_name | string | Registrant's legal name as recorded on the filing. |
| form_type | string | EDGAR form code returned (10-K, 10-Q, 8-K, S-1, S-4, DEF 14A, 4, or 13F-HR). |
| filings | array | List of matching filings with accession number, filing date, period, and document URLs. |
| summary | object | Optional Venice-generated executive summary object with key sections tuned to the form type. |
| text | string | Cleaned plain-text body of the filing with HTML, XBRL tags, and boilerplate stripped. |
| text_chars | number | Character count of the cleaned text field, useful for token budgeting downstream. |
EXAMPLES — two ways to call
EXAMPLE 1 · curl
curl -X POST https://x402.org/v1/sec-filing \
-H 'Content-Type: application/json' \
-d '{ }'first response =
402 Payment Required with payment requirements; sign + retry with X-PAYMENT.EXAMPLE 2 · mcp
# install once claude mcp add x402 --command "npx x402-deployer-mcp" # then ask Claude Code: # "use the sec-filing tool to ..."
MCP server handles payment automatically — your coding agent just calls the tool by name.
METADATA
- tags
- secedgar10-k10-q8-ks-1filingsannual-reportearningsfinancestocksipodue-diligence
- env
- VENICE_API_KEY
- methods
- POST
- cluster
- edgefinance
- price
- $0.01 USDC per call
ADJACENT — other endpoints in edgefinance
| endpoint | description | price |
|---|---|---|
| insider-form-4 | SEC Form 4 (insider transactions) normalizer. | $0.01 |
| insider-trading | Insider trading feed. | $0.01 |
| kalshi-markets | Kalshi markets / event contracts / Kalshi API / CFTC-regulated prediction markets / Kalshi browse / KalshiEX markets list. | $0.005 |
| polymarket-leaderboard | Polymarket leaderboard / top traders / profit leaderboard / Polymarket whales / volume leaderboard / prediction market rankings. | $0.005 |
| polymarket-markets | Polymarket markets / prediction market data / Polymarket API / list active prediction markets / crypto-settled betting odds / event odds… | $0.005 |
| polymarket-trades | Polymarket trades / recent prediction market trades / on-chain bet history / Polymarket trade feed / Polymarket data API. | $0.005 |
| exchange-rates | FX rates / forex / currency converter / USD to EUR / ECB rates / historical exchange rates. | $0.002 |
| bls-occupational-stats | BLS Public Data API — wages, employment levels, growth by series ID. | $0.02 |
SEE ALSO