Name: sec-filing
Price: 0.01 USDC
Availability: InStock

$ man sec-filing

agentutility / edge-finance / sec-filing

PRICE / CALL

$0.01

USDC · base mainnet · scheme: exact

METHOD

POST

CLUSTER

edgefinance

CATEGORY

finance

STATUS

● live

NAME

sec-filing — fetches, parses, and summarizes sec edgar filings for any public company by ticker or cik

SYNOPSIS

POST https://x402.agentutility.ai/sec-filing
     Content-Type: application/json
     X-PAYMENT:    <signed-transferWithAuthorization>

     { ... }

↳ first call → 402 Payment Required. Sign USDCtransferWithAuthorization, retry with theX-PAYMENT header.

DESCRIPTION

Fetches, parses, and summarizes SEC EDGAR filings for any public company by ticker or CIK. Resolves ticker to CIK against EDGAR, returns structured filing metadata (form, filed_date, accession_number, period_of_report, primary_document_url) for the most recent N filings of a chosen form type, optionally pulls the latest filing's full clean text, and optionally runs it through a Venice executive summary tuned to the form type. Covers 10-K, 10-Q, 8-K, S-1, S-4, DEF 14A, Form 4, and 13F-HR: annual and quarterly reports, proxies, insider trading, and institutional holdings. 100% public-domain SEC data, no auth. Use it as a SEC filings API, SEC filing search by ticker or CIK, or public-company filing pull.

INPUT — request schema

property	type	description	req?
ticker	string	US-listed stock ticker (e.g. 'AAPL', 'TSLA'). Either ticker or cik is required.	optional
cik	string	SEC Central Index Key (zero-padded or numeric, e.g. '0000320193'). Use when ticker is ambiguous or unavailable.	optional
form_type	string	Filing type. Default '10-K'. Supports 10-K, 10-Q, 8-K, S-1, S-4, DEF 14A, 4, 13F-HR.	optional
limit	number	Max filings to return. 1-20. Default 5 (most-recent-first).	optional
summarize	boolean	If true, runs the latest filing through Venice for an executive-summary tailored to the form. Adds latency. Default false.	optional
include_text	boolean	If true, includes the full clean-text body of the latest filing in the response. Large payload. Default false.	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.agentutility.ai/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 the MCP package for this endpoint's cluster
npx -y @agentutility/mcp-<cluster>

# Required: EVM private key with USDC on Base
export X402_PRIVATE_KEY=0x...

# Then call the sec-filing tool from your MCP-aware agent.

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
accounts-receivable-aging-score	Scores the health of an accounts receivable book from its aging profile, returning a weighted score and grade.	$0.01
amortization-schedule	Computes a loan's amortization schedule and payment breakdown.	$0.01
asset-based-lending-score	Scores the risk of an asset based lending (ABL) facility, returning a weighted score and grade.	$0.01
blended-finance-score	Scores a blended finance structure on how efficiently concessional capital mobilizes private money, returning a 0-100 structure score.	$0.01
blended-finance-score-api	Scores blended finance structures on concessional capital leverage.	$0.01
break-even-calculator	Calculates break-even units and contribution margin for a product's unit economics.	$0.01
cash-conversion-cycle	Calculates cash conversion cycle days from receivables, inventory, payables, revenue, and cost of goods sold.	$0.01
cash-conversion-cycle-calculator	Calculates the cash conversion cycle for working capital optimization.	$0.01