agentutility(7)$ man sec-filing
/sec-filing
PRICE / CALL
$0.01
USDC · base mainnet · scheme: exact
METHOD
POST
CLUSTER
edgefinanceCATEGORY
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-calculator | Calculates the cash conversion cycle for working capital optimization. | $0.01 |
| cash-runway-calculator | Calculates a startup's cash runway from its monthly burn. | $0.01 |
SEE ALSO