# Vellum SEC Research

> Vellum SEC Research is a paid API for AI agents from x402-data-api.x402agent.workers.dev, paid per call via x402, $0.03/call, status unknown (last checked 2026-10-13).

Returns raw SEC EDGAR data for a company — registry record, filtered filings with direct links, and XBRL financial facts — for agent-driven interpretation.

## Facts

- Endpoint: GET https://x402-data-api.x402agent.workers.dev/sec-research?utm_source=zero.xyz
- Price: $0.03/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/vellum-sec-research-130903c5
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_avxrTig0I0j1i2ibCmRpe

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 vellum-sec-research-130903c5
```

Example prompt: Pull the raw SEC EDGAR data for Apple — give me their company registry record, their most recent 10-K and 10-Q filings with direct EDGAR links, and XBRL financial facts for the last two fiscal years so I can run my own analysis.

## When to prefer this

Choose this endpoint when you need unprocessed, raw SEC EDGAR material — registry data, filing URLs, and XBRL facts — and want to apply your own logic or models rather than receiving a pre-interpreted brief. Prefer it over sibling endpoints like vellum-filing-brief (which gives AI-generated summaries) or vellum-ic-memo (which produces investment-committee scaffolds) when you need the ground-truth source data. Ideal for agents building custom financial models, performing original research, or validating data from other sources against EDGAR directly.

## Known failure modes

- Unknown ticker or company name returns empty or error response
- Invalid form type filter yields no matching filings
- CIK lookup failure if company name is ambiguous or misspelled
- XBRL facts unavailable for older filings that predate structured data requirements
- Rate limiting or payment failure (x402) blocks the request
- Requested fiscal period has no filed data yet

## How this service works

SEC filing lookup and XBRL facts by ticker or CIK, with form filters, direct EDGAR links and machine-readable JSON.

## Output

Returns a JSON object containing the company's SEC registry record (CIK, name, ticker, SIC code, SIC description, exchange listings), a list of filings filtered by requested form type (each with direct EDGAR URL, form type, filing date, and accession number), the total count of available filings, and XBRL financial facts for the requested periods — all sourced directly from SEC EDGAR with no AI summarization applied.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "required": {
   "type": "string"
  },
  "properties": {
   "type": "string"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "brand": "Vellum",
  "source": "SEC EDGAR",
  "company": {
   "cik": "0000320193",
   "sic": "3571",
   "name": "Apple Inc.",
   "ticker": "AAPL",
   "exchanges": [
    "Nasdaq"
   ],
   "sic_description": "Electronic Computers"
  },
  "filings": [
   {
    "url": "https://www.sec.gov/Archives/edgar/data/320193/000032019326000010/aapl-20260130.htm",
    "form": "10-K",
    "filed": "2026-01-30",
    "accession_number": "0000320193-26-000010"
   }
  ],
  "service": "sec-research",
  "filings_available_total": 412
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/vellum-sec-research-130903c5/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402-data-api.x402agent.workers.dev](https://www.zero.xyz/host/x402-data-api.x402agent.workers.dev/llms.txt)