For AI agents

The Filed API, paid per call.

SEC filing alerts as JSON for AI agents: by company, form and time, as soon as Filed has them. Paid calls spend credits, bought by burning $FILED. Before launch, and without a key, calls use the free tier.

Try it here Agent guide (llms.txt)
01.In one line
# 1 credit; free tier without a key
curl "https://filedalerts.xyz/api/filed/alerts?form=8-K" \
  -H "Authorization: Bearer ck_…"

Filed's agent is an ERC-8004 agent on Robinhood Chain: registration file, Identity Registry.

01.Endpoints

Five GETs

All under https://filedalerts.xyz/api/, CORS open. Bad input, unknown tickers and unknown filings answer 400 or 404 and are never charged.

GET filed/alerts1 credit

Alerts as soon as Filed has them, newest first, or oldest change first with since.

  • symbol one or more covered tickers, comma-separated (up to 25)
  • form 8-K, 10-Q, 10-K, S-1, 4, 13D, 13G (13DG for both); amendments are included
  • since ISO time: everything published or updated after it, for polling; follow next.since
  • before ISO time, to page back through the feed; limit 1 to 200, default 50
GET filed/alert?filing=1 credit

One alert by its EDGAR accession number, with or without dashes. Older alerts that have left the feed stay readable here.

GET filed/companies1 credit

Every covered company with its CIK, token address, last check, its own newest 8-K, 10-Q, 10-K and S-1, and alert counts by form. symbol narrows it.

GET filed/latestFree

The newest alerts, 30 minutes after the API gets them, at most 30 per call, with the same form and symbol filters. What the home page shows.

GET filed/coverageFree

The company list, the tokens left out with reasons, and the watcher's status.

02.An alert

What every alert holds

Alerts never wait for a summary. summary.status is ready, pending (with a plain note) or unavailable (with the reason); the EDGAR link is always there.

{
  "filing": "0001045810-26-000082",
  "symbol": "NVDA", "company": "NVIDIA", "cik": "1045810", "token": "0x…", "chainId": 4663,
  "form": "8-K", "group": "8-K", "formName": "Current report",
  "title": "Item 5.02, Departure or appointment of directors or officers; compensation",
  "filedAt": "2026-11-12T13:52:41.000Z", "period": "2026-11-11",
  "items": [{ "code": "5.02", "name": "…" }],
  "links": { "filing": "https://www.sec.gov/Archives/edgar/data/…-index.htm", "document": "https://www.sec.gov/…" },
  "summary": { "status": "ready", "by": "ai", "headline": "…", "text": "…", "points": ["…"], "checks": { "advice": 0, "numbers": 0 } },
  "publishedAt": "…", "updatedAt": "…",
  "notice": "Not financial or legal advice. AI summaries can be wrong; read the filing."
}

Form 4 alerts add insider: the owners and their roles, up to 12 transactions with code, shares, price and holdings after, and the Rule 10b5-1 flag. XML Schedule 13D/G alerts add holder: the reporting persons, shares and percent of class.

03.Try it

Run a call from this page

Uses the key saved on this device if you have one (it spends credits), and the free tier if not. The answer is the real JSON.

04.Credits

Keys and credits

Free tier: 20 calls a day per person without a key, 2,000 a day for everyone together. Credits are $FILED burned to the dead address; they buy API calls and nothing else.

Buy credits

Your API key

Your credits

When a call can't go through

  • 400 bad input, 404 unknown ticker or filing: never charged.
  • 402 you need credits; the body has buy instructions. 401 the key is wrong or revoked. 429 the free calls are used up.
  • 502 after a charge: refunded at once, with refunded in the body and a line in the public refund log.

Refunds