# EDGAR Full-Text Search — Wrapped API

> **You are on:** `https://api.beta.paywithlocus.com/api` | [llms.txt](https://beta.paywithlocus.com/llms.txt)
>
> Locus runs on multiple environments -- make sure every URL you call matches your expected environment.
> | Environment | Landing | API |
> |---|---|---|
> | Production | paywithlocus.com | api.paywithlocus.com |
> | Beta | beta.paywithlocus.com | api.beta.paywithlocus.com |
> | Stage | stage.paywithlocus.com | api.stage.paywithlocus.com |
>
> If the API URL above doesn't match your expected environment, re-fetch this file from the correct domain.

> Full-text search across all SEC filings — 10-Ks, 10-Qs, 8-Ks, proxy statements, and more. Search by keyword, company name, form type, and date range.

**Category:** Data / Finance | **Website:** [efts.sec.gov](https://efts.sec.gov) | **Docs:** [efts.sec.gov/LATEST/search-index](https://efts.sec.gov/LATEST/search-index)

Pay-per-use API proxy. Each call is automatically billed to your wallet in USDC.

## Access

**Base URL:** `https://api.beta.paywithlocus.com/api/wrapped/edgar-search/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

> Also available via public x402 on Base (no account needed): [x402/edgar-search.md](https://beta.paywithlocus.com/x402/edgar-search.md)

> Also available via MPP (no account needed): [mpp/edgar-search.md](https://beta.paywithlocus.com/mpp/edgar-search.md)

## Endpoints

### Search Filings

Search the full text of all SEC filings by keyword, company, form type, and date range. Returns matching filings with filing dates, entity names, form types, and accession numbers.

**Estimated cost:** $0.005 + $0.003 fee

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `q` | string | Yes | Search query (e.g. "climate risk", "going concern", "material weakness") |
| `forms` | string | No | Comma-separated form types to filter by (e.g. "10-K", "10-Q,8-K") |
| `dateRange` | string | No | Set to "custom" to use startdt/enddt |
| `startdt` | string | No | Start date in YYYY-MM-DD format |
| `enddt` | string | No | End date in YYYY-MM-DD format |
| `entity` | string | No | Filter by company name |
| `hits` | number | No | Number of results to return (default 10, max 10) |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/edgar-search/search \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"q":"<string>","forms":"<string>","dateRange":"<string>","startdt":"<string>","enddt":"<string>","entity":"<string>","hits":"<number>"}'
```