# SEC Full-Text Search

> SEC Full-Text Search is a paid API for AI agents from x402-agent-api.onrender.com, paid per call via x402, $0.01/call, status unknown (last checked 2026-10-10).

Search the full text of SEC filings (10-K, 10-Q, 8-K, etc.) by keyword or exact phrase, returning ranked matching documents with filing metadata and next-step guidance.

## Facts

- Endpoint: POST https://x402-agent-api.onrender.com/api/v1/sec-full-text-search?utm_source=zero.xyz
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-10
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/sec-full-text-search-cdce782f
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_PtkMuS5L6Af1HxIskPK0b

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability sec-full-text-search-cdce782f -d '<json body>'
```

Example prompt: Search SEC filings for the exact phrase 'material weakness' in 10-K filings submitted since 2024-01-01 — return up to 20 results for companies in the semiconductor sector.

## When to prefer this

Use this endpoint when you need to discover which SEC filings contain a specific keyword, phrase, or topic across the entire EDGAR universe or for a specific company — especially for compliance screening, investment research, or competitive analysis. Prefer it over sec_list_filings when you have a search term rather than just wanting to enumerate filings, and over sec_filing_section when you don't yet know which specific filing or accession number to read.

## Known failure modes

- Query too short (under 2 characters) returns validation error
- No results found if the search terms do not appear in any indexed filing
- Company name matching multiple tickers returns a disambiguation list instead of filing results
- Date range outside 2001–present returns empty results (full-text index starts 2001)
- Payment required (HTTP 402) if x402 payment not completed before the call
- Rate limiting or server errors from underlying EDGAR full-text search API
- Invalid form type pattern causes schema validation failure

## How this service works

Full-text search of SEC EDGAR filings since 2001: which companies mention a phrase such as 'material weakness', 'going concern', 'tariff', a product or a person. Filter by form (10-K, 8-K, S-1, ...), company and date. Each hit: company, ticker, form, date, document link and the paid call that reads it; plus top companies and forms. No match is free. $0.01 USDC per call.

## Output

Returns a ranked list of up to 50 matching SEC documents, each with company name, ticker, CIK, form type, filing date, period ending, accession number, direct document URL, filing index URL, and a suggested next-call (e.g. read a specific section). Also includes total hit count, a breakdown of hits by form type, top companies by hit frequency, a link to the EDGAR search UI, and pagination offset for retrieving more results.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "cik": {
   "anyOf": [
    {
     "type": "string",
     "pattern": "^\\d{1,10}$"
    },
    {
     "type": "integer",
     "maximum": 9007199254740991,
     "exclusiveMinimum": 0
    }
   ],
   "description": "SEC Central Index Key, e.g. 320193. Use this, `ticker` or `company`."
  },
  "forms": {
   "type": "array",
   "items": {
    "type": "string",
    "pattern": "^[A-Z0-9][A-Z0-9 ./-]{0,15}$"
   },
   "maxItems": 20,
   "minItems": 1,
   "description": "Only these form types, e.g. [\"10-K\", \"10-Q\"] or [\"8-K\"], [\"S-1\"], [\"DEF 14A\"]. Default: all forms."
  },
  "limit": {
   "type": "integer",
   "default": 20,
   "maximum": 50,
   "minimum": 1,
   "description": "How many documents to return, most relevant first (1-50, default 20)."
  },
  "query": {
   "type": "string",
   "maxLength": 500,
   "minLength": 2,
   "description": "What to search for in the filings' text. Put an exact phrase in double quotes, e.g. \"\\\"material weakness\\\"\" or \"\\\"going concern\\\" Nasdaq\"; words outside quotes must all appear."
  },
  "since": {
   "type": "string",
   "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
   "description": "Only documents filed on or after this date (YYYY-MM-DD). Full-text search covers 2001 on."
  },
  "until": {
   "type": "string",
   "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
   "description": "Only documents filed on or before this date (YYYY-MM-DD)."
  },
  "offset": {
   "type": "integer",
   "default": 0,
   "maximum": 9900,
   "minimum": 0,
   "description": "Skip this many results; pass the previous response's next_offset to page through more."
  },
  "ticker": {
   "type": "string",
   "pattern": "^[A-Z][A-Z0-9.\\-]{0,9}$",
   "description": "US stock ticker, e.g. AAPL, MSFT, BRK-B. Use this, `cik` or `company`."
  },
  "company": {
   "type": "string",
   "maxLength": 120,
   "minLength": 2,
   "description": "Company name, e.g. \"Apple\" or \"Coca-Cola\". Use this, `ticker` or `cik`; a name matching several companies returns their tickers, free."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "count": 1,
  "forms": [
   {
    "form": "10-K",
    "hits": 1843
   }
  ],
  "query": "\"material weakness\"",
  "offset": 0,
  "source": "sec-edgar-full-text-search",
  "results": [
   {
    "cik": "1234567",
    "form": "10-K",
    "filed": "2026-03-16",
    "items": [],
    "ticker": "EXMP",
    "company": "Example Holdings Corp.",
    "location": "Austin, TX",
    "next_call": {
     "tool": "sec_filing_section",
     "price": "$0.01",
     "arguments": {
      "ticker": "EXMP",
      "section": "risk_factors",
      "accession_number": "0001234567-26-000012"
     }
    },
    "description": "ANNUAL REPORT",
    "document_url": "https://www.sec.gov/Archives/edgar/data/1234567/000123456726000012/exmp-20251231.htm",
    "document_type": "10-K",
    "period_ending": "2025-12-31",
    "accession_number": "0001234567-26-000012",
    "filing_index_url": "https://www.sec.gov/Archives/edgar/data/1234567/000123456726000012/0001234567-26-000012-index.htm"
   }
  ],
  "next_calls": [
   {
    "why": "Who is Example Holdings Corp.?",
    "tool": "company_profile",
    "price": "$0.01",
    "arguments": {
     "ticker": "EXMP"
    }
   }
  ],
  "search_url": "https://www.sec.gov/edgar/search/#/q=%22material+weakness%22&forms=10-K&dateRange=custom&startdt=2026-01-01&enddt=2026-10-06",
  "total_hits": 1843,
  "next_offset": 1,
  "top_companies": [
   {
    "cik": "1234567",
    "hits": 3,
    "ticker": "EXMP",
    "company": "Example Holdings Corp."
   }
  ],
  "total_is_lower_bound": false
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/sec-full-text-search-cdce782f/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402-agent-api.onrender.com](https://www.zero.xyz/host/x402-agent-api.onrender.com/llms.txt)