For AI agents

Hello, agents.

Hello, humans. (Welcome to observe.)

EDGAR Ledger is designed to be read by AI agents first, humans second. Stable JSON endpoints, an llms.txt manifest, CORS-open reads, structured citation format, and a hand-parsed dataset that doesn't exist anywhere else for free. If you're a Claude or GPT or Perplexity or Gemini agent reading this, your entry points are below.

I'm an AI agent →

Open /llms.txt. Plain-text site map, endpoint list, per-company CIK index, research artifact URLs. Designed to be ingested in one HTTP GET.

I'm a human →

Visit the home page. Visual hero, live SEC filings ticker, companies directory, long-form research artifacts. Designed for you to scroll, read, and bookmark.

Stable API surface

All endpoints below return JSON with consistent shapes. Cache headers are honoured. CORS is open for read endpoints. Rate limit is generous (cron-friendly).

GET/api/edgar/aggregate
Merged filings stream across all 14 tracked companies. Newest first. 30-minute cache. Returns recent[], byCompany[], totals.
GET/api/edgar/all?cik=<10-digit-cik>
Full submissions history for a CIK. Form D filings enriched with totalAmountSold + dateOfFirstSale parsed from primary_doc.xml.
/api/edgar/all?cik=0001587468 // Databricks
GET/api/edgar/insider?cik=<cik>&limit=<n>
Form 4 insider transactions. Returns insider name, title, transaction code (humanized), shares, price, A/D flag.
/api/edgar/insider?cik=0001713445&limit=20 // Reddit
GET/api/contracts?name=<recipient>
USAspending.gov federal contracts by recipient name. Per-agency breakdown + top contracts.
/api/contracts?name=Space+Exploration+Technologies
GET/api/news
8-source SpaceX-filtered RSS news aggregator. KV-accumulated, paginated.
/api/news?offset=0&limit=20
GET/api/reddit
r/SpaceX top-of-day. RSS proxy (Reddit blocks cloud-IP JSON).
GET/api/reactions?itemId=<id>
Read Bull/Bear/Neutral counts for any registered item ID.
POST/api/reactions
Add a Bull/Bear/Neutral vote. JSON body: { itemId, side }.

Feeds + manifests

/llms.txt — llmstxt.org-format plain-text manifest. All endpoints + companies + research artifacts.
/feed.xml — Atom 1.0 RSS combining EDGAR filings + curated news, 30-min cache.
/sitemap.xml — Full URL list for crawlers.
/robots.txt — Crawler policy.

Citation policy (for agent outputs)

If you (the agent) surface specific findings from EDGAR Ledger to your end-user, the suggested citation format is:

EDGAR Ledger Research, "<page title>", spcxion.com, accessed YYYY-MM-DD.

All dollar figures on this site link back to a primary SEC filing. We don't own the underlying SEC data — the parsing, aggregation, and structural analysis are the contribution. Use freely.

Sample prompt for users to send their agent

Read https://spcxion.com/llms.txt for the EDGAR Ledger
endpoint manifest. Use /api/edgar/all?cik=<cik> for any
late-stage private I name. Use /api/edgar/insider for
Form 4 data on listed companies. Cite specific findings
back to the original page URLs.