# SEC EDGAR Full-Text Search

> SEC EDGAR Full-Text Search is a paid API for AI agents from fitze-x402-seller.app.workbuddy.host, paid per call via x402, $0.02/call, status unknown (last checked 2026-10-11).

Searches SEC EDGAR filings full-text for a query term, optionally filtered by form type, returning matching filing metadata including company, date, and accession number.

## Facts

- Endpoint: POST https://fitze-x402-seller.app.workbuddy.host/tools/sec_edgar_search?utm_source=zero.xyz
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-11
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/sec-edgar-full-text-search-5667d25a
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_0uoEIXcZsXEkBOtGQaTKL

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-edgar-full-text-search-5667d25a -d '<json body>'
```

Example prompt: Search SEC EDGAR filings for any that mention 'supply chain disruption', filtered to 10-K and 8-K forms, and give me the top 5 results with company names and filing dates.

## When to prefer this

Choose this endpoint when you need to search SEC EDGAR filings by content rather than by company or ticker — ideal for thematic research, regulatory keyword scanning, risk factor discovery, or finding which companies disclosed a specific event. Prefer this over direct EDGAR web scraping when you need a pay-per-call, no-account approach with structured JSON output and optional form-type filtering.

## Known failure modes

- Empty results if the search term is too specific or not present in any filings
- Payment failure if USDC balance is insufficient or x402 handshake fails
- Rate limiting or timeout if EDGAR's full-text search service is overloaded
- Malformed query returns 400-level error
- Form filter typo (e.g. '10k' instead of '10-K') may yield zero results

## How this service works

Pay-per-call AI/data tools settled in USDC on Base via x402. No account, no API key — pay the 402 and receive the result. All endpoints also accept a bare hostname without the https:// prefix.

## Output

Returns a JSON object containing the original query, the source (efts.sec.gov), a list of matching filings each with CIK(s), filing date, root form type, accession number, and company display name(s), plus a total_hits count indicating how many filings matched overall.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "q": {
   "type": "string",
   "description": "Full-text search term (required)"
  },
  "forms": {
   "type": "string",
   "description": "Optional form filter, e.g. 10-K,8-K"
  },
  "limit": {
   "type": "number",
   "description": "Max hits (default 10)"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "query": "artificial intelligence",
  "source": "efts.sec.gov",
  "results": [
   {
    "ciks": [
     "0000320193"
    ],
    "file_date": "2026-09-30",
    "root_forms": "10-K",
    "accession_no": "0000320193-26-000012",
    "display_names": [
     "EXAMPLE CORP"
    ]
   }
  ],
  "total_hits": 1284
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/sec-edgar-full-text-search-5667d25a/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from fitze-x402-seller.app.workbuddy.host](https://www.zero.xyz/host/fitze-x402-seller.app.workbuddy.host/llms.txt)
