# DeepSearch US SEC Filings API

> DeepSearch US SEC Filings API is a paid API for AI agents from x402.deepsearch.com, paid per call via x402, $0.05/call, status unknown (last checked 2026-10-17).

Retrieves recent SEC filings for a US-listed company by ticker, including form type, title, category, and index URL, filterable by date range and form type.

## Facts

- Endpoint: GET https://x402.deepsearch.com/v1/context/us/filings/%7Bticker%7D?utm_source=zero.xyz
- Price: $0.05/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-17
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/deepsearch-us-sec-filings-api-2df26b0f
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_RHpbJhAwd3CYrfDBohaX9

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 deepsearch-us-sec-filings-api-2df26b0f
```

Example prompt: Pull the most recent SEC filings for NVDA over the last 90 days — I want to see 8-Ks and 10-Qs, up to 20 filings.

## When to prefer this

Use this endpoint when you need structured, filterable access to US SEC filings for a specific ticker without maintaining an API key or subscription. It is ideal for AI agents performing on-demand regulatory research, earnings monitoring, or insider activity tracking, especially when combined with other DeepSearch endpoints for full fundamental analysis. Prefer this over direct EDGAR scraping when you need clean structured JSON with Korean category labels and easy form-type filtering.

## Known failure modes

- Invalid or unknown ticker returns empty filings array or error
- Days parameter out of range (1-365) may return validation error
- Limit parameter out of range (1-50) may return validation error
- Payment failure (insufficient USDC balance on Base Mainnet) returns 402 error
- SEC data unavailable for very recent filings due to EDGAR indexing lag

## How this service works

Korean (KRX) stock data for AI agents: analyst consensus, investor flows, market pulse, knowledge-graph signals (why a stock moved, hot themes, theme revenue evidence), 10-year financials and 3-year prices, plus US fundamentals and SEC filings. Pay per call in USDC on Base Mainnet — no subscription, no API key.

## Output

Returns a JSON object with the company's CIK, ticker, name, a list of filings (each with form type, title, Korean title translation, category, SEC index URL, accepted timestamp, and accession number), the pack type, the look-back window in days, and a count breakdown by form type.

## 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"
     ],
     "type": "string"
    },
    "pathParams": {
     "type": "object",
     "required": [
      "ticker"
     ],
     "properties": {
      "ticker": {
       "type": "string",
       "description": "US ticker symbol (e.g. NVDA, AAPL, TSLA)"
      }
     }
    },
    "queryParams": {
     "type": "object",
     "properties": {
      "days": {
       "type": "string",
       "description": "Look-back window in days, 1-365 (default 90)"
      },
      "form": {
       "type": "string",
       "description": "Comma-separated form types to include (default: all)"
      },
      "limit": {
       "type": "string",
       "description": "Max filings, 1-50 (default 20)"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "cik": "0001045810",
  "ticker": "NVDA",
  "company": "NVIDIA CORP",
  "filings": [
   {
    "form": "8-K",
    "title": "8-K - NVIDIA CORP (0001045810) (Filer)",
    "titleKo": "수시 보고서 (Form-8-K)",
    "category": "실적 공시",
    "indexUrl": "https://www.sec.gov/Archives/edgar/data/1045810/000104581026000078/0001045810-26-000078-index.htm",
    "acceptedAt": "2026-09-03T12:03:56Z",
    "accessionNumber": "0001045810-26-000078"
   }
  ],
  "packType": "us-filings",
  "windowDays": 90,
  "countsByForm": {
   "4": 9,
   "8-K": 4,
   "10-Q": 1
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/deepsearch-us-sec-filings-api-2df26b0f/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402.deepsearch.com](https://www.zero.xyz/host/x402.deepsearch.com/llms.txt)