# Ysaere SEC Full-Text Search

> Ysaere SEC Full-Text Search is a paid API for AI agents from api.ysaere.com, paid per call via x402, $0.02/call, status unknown (last checked 2026-11-20).

Searches the full text of SEC EDGAR filings by keyword or phrase and returns matching filing metadata, filtered by form type and date range.

## Facts

- Endpoint: POST https://api.ysaere.com/v1/intel/sec-fulltext-search?utm_source=zero.xyz
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-11-20
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/ysaere-sec-full-text-search-5e06a816
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_tOvOvwnRk1pxyr1pMvOHp

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 ysaere-sec-full-text-search-5e06a816 -d '<json body>'
```

Example prompt: Search SEC EDGAR filings for the phrase 'material weakness' in 10-K and 8-K forms filed between January 1 2024 and December 31 2024, and give me up to 15 results with the company name, form type, and filing URL.

## When to prefer this

Use this endpoint when you need to search the actual text content of SEC EDGAR filings rather than just metadata fields. It is ideal for compliance screening, due diligence, competitive intelligence, or financial research requiring keyword or phrase discovery across public company disclosures. Prefer it over structured financial data APIs when the signal you need is embedded in narrative disclosure language rather than numeric fields.

## Known failure modes

- No filings match the query and date range — returns empty results list
- Query string too short (under 2 characters) or too long (over 200 characters) — returns validation error
- Requested more than 20 results — capped or returns error
- Payment not received or insufficient USDC balance — request blocked before processing
- Invalid date format (not YYYY-MM-DD) — returns parsing error
- Invalid or unrecognized SEC form type in forms array — may return empty results or error

## How this service works

Ysaere Agent SEC Full-Text Search — $0.02 USDC, no account needed. Input: {"query":"material weakness","forms"?:["10-K","8-K"],"date_from"?:"2026-01-01","date_to"?:"2026-10-31","limit"?:10}. Searches the text of SEC EDGAR filings and returns matching filings (company, form, filed date, CIK, filing URL) plus a v2:sha512: feed_digest, in this response. No matches are refused before payment. Wallet only. No account price.

## Output

Returns a list of matching SEC filings (up to 20), each with company name, SEC form type, filed date, CIK identifier, and a direct URL to the filing on EDGAR, plus a v2:sha512 feed digest for verification.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "forms": {
   "type": "array",
   "items": {
    "type": "string"
   },
   "maxItems": 10,
   "description": "Optional SEC form types, e.g. [\"10-K\",\"8-K\"]"
  },
  "limit": {
   "type": "number",
   "maximum": 20,
   "minimum": 1,
   "description": "Max filings (default 10, max 20)"
  },
  "query": {
   "type": "string",
   "maxLength": 200,
   "minLength": 2,
   "description": "Words or exact phrase to find in filings"
  },
  "stamp": {
   "type": "boolean",
   "description": "Optional. true adds a signed Notary receipt over output_sha512 (+$0.02 USDC). Integrity, not factual truth."
  },
  "date_to": {
   "type": "string",
   "description": "Optional end date YYYY-MM-DD"
  },
  "date_from": {
   "type": "string",
   "description": "Optional start date YYYY-MM-DD"
  }
 }
}
```

## More

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