# SEC EDGAR Full-Text Filing Search

> SEC EDGAR Full-Text Filing Search is a paid API for AI agents from x402stock.xyz, paid per call via x402, $0.02/call, status unknown (last checked 2026-09-16).

Searches the full text of every SEC EDGAR filing since 2001 by keyword or phrase, with optional filters for form type, ticker, and date range.

## Facts

- Endpoint: GET https://x402stock.xyz/api/v1/filing-search
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-16
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/x402stock-xyz-bc3cb4cd
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_hoxVJhN-6ry-TrEKz0EHa

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 x402stock-xyz-bc3cb4cd
```

Example prompt: Search SEC EDGAR filings since 2020-01-01 for the phrase 'supply chain disruption' — limit it to 10-K and 8-K forms and return up to 20 results.

## When to prefer this

Use this endpoint when you need to find SEC filings containing a specific keyword, phrase, or topic across the entire EDGAR corpus since 2001. It is the right choice for equity research, compliance research, or investigative queries where you need to identify which companies or filings mention a given term. Prefer this over stock price or fundamental data endpoints when the task is document discovery rather than quantitative data retrieval.

## Known failure modes

- Missing or empty 'q' parameter returns a validation error
- limit exceeding 100 triggers a schema validation failure
- Malformed date patterns for startdt/enddt (non YYYY-MM-DD) cause rejection
- Unknown or invalid ticker returns zero results with no error
- Very broad queries may hit rate or result caps, returning fewer results than total_matches suggests

## How this service works

Full-text search across every SEC EDGAR filing since 2001. Find filings mentioning a keyword or exact phrase via ?q=, narrow by ?forms=10-K,8-K, ?ticker=, and ?startdt=/?enddt= dates, and cap with ?limit=. Returns each match's form, filer, date, and a link to the document. Sourced from SEC EDGAR. From x402stock, a market & economic data API (x402, USDC).

## Output

Returns a JSON object with the search query echoed back, total match count, number of results returned, and an array of matching filings each containing accession number, form type, filer name, CIK, filing date, period ending, a brief description, and a direct URL to the document on EDGAR.

## Example request

```json
{
 "input": {
  "type": "http",
  "method": "GET",
  "queryParams": {
   "q": "artificial intelligence",
   "limit": 10
  }
 }
}
```

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET",
      "HEAD",
      "DELETE"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "$schema": "https://json-schema.org/draft/2020-12/schema",
     "required": [
      "q",
      "limit"
     ],
     "properties": {
      "q": {
       "type": "string",
       "minLength": 1
      },
      "enddt": {
       "type": "string",
       "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
      },
      "forms": {
       "type": "string"
      },
      "limit": {
       "type": "integer",
       "default": 10,
       "maximum": 100,
       "exclusiveMinimum": 0
      },
      "ticker": {
       "type": "string"
      },
      "startdt": {
       "type": "string",
       "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
      }
     },
     "additionalProperties": false
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "$schema": "https://json-schema.org/draft/2020-12/schema",
     "required": [
      "source",
      "as_of",
      "query",
      "forms",
      "ticker",
      "total_matches",
      "count",
      "results"
     ],
     "properties": {
      "as_of": {
       "type": "string"
      },
      "count": {
       "type": "number"
      },
      "forms": {
       "anyOf": [
        {
         "type": "string"
        },
        {
         "type": "null"
        }
       ]
      },
      "query": {
       "type": "string"
      },
      "source": {
       "type": "string",
       "const": "sec_edgar"
      },
      "ticker": {
       "anyOf": [
        {
         "type": "string"
        },
        {
         "type": "null"
        }
       ]
      },
      "results": {
       "type": "array",
       "items": {
        "type": "object",
        "required": [
         "accession",
         "form",
         "filing_date",
         "period_ending",
         "filer",
         "cik",
         "description",
         "url"
        ],
        "properties": {
         "cik": {
          "anyOf": [
           {
            "type": "string"
           },
    
… (truncated)
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "as_of": "2026-06-01T15:00:00.000Z",
  "count": 1,
  "forms": "10-K",
  "query": "artificial intelligence",
  "source": "sec_edgar",
  "ticker": null,
  "results": [
   {
    "cik": "0000320193",
    "url": "https://www.sec.gov/Archives/edgar/data/320193/000032019325000123/aapl-20250927.htm",
    "form": "10-K",
    "filer": "Apple Inc. (AAPL) (CIK 0000320193)",
    "accession": "0000320193-25-000123",
    "description": "10-K",
    "filing_date": "2025-11-01",
    "period_ending": "2025-09-27"
   }
  ],
  "total_matches": 4821
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/x402stock-xyz-bc3cb4cd/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402stock.xyz](https://www.zero.xyz/host/x402stock.xyz/llms.txt)