# Edgrapi

> Clean company financials from SEC EDGAR for developers and AI agents — normalized income statement, balance sheet, cash flow, computed ratios, company profiles, recent filings, and 10-K/10-Q section text for any US-listed ticker, as one consistent JSON schema. Free tier: 100 credits / month, no card. EDGAR's data is free but its XBRL is painful to parse (the same metric is tagged differently across companies and years); Edgrapi does the normalization so you don't.

Auth: `X-API-Key: edgr_...` (or `Authorization: Bearer edgr_...`). Base URL: `https://api.edgrapi.com`. Responses are JSON; failures return an `error` field.

## Get a key in 30 seconds
- [Sign up free](https://edgrapi.com/app): 100 free credits every month, no credit card. The same key works for REST, the MCP server, and the agent skills.
- [Pricing](https://edgrapi.com/pricing): Free → Starter $10/mo (10,000 credits) → Pro $29/mo (30,000 credits) or $290/yr (360,000 credits). Pay-as-you-go credit packs from $7 (no subscription, buy on any plan including free). Calls debit credits by weight: company/filings/events 1, fundamentals/ratios 3, sections/insider 5. Webhook delivery is free. Credits never expire.

## Endpoints (REST)
- GET /v1/insider/{ticker} — parsed Form 4 insider trades: owner, role, code (P/S/A/M/F), shares, price, value, 10b5-1 flag
- GET /v1/events/{ticker}?notable=true — 8-K material events as typed items (2.02 earnings, 5.02 exec change, 1.05 cyber)
- POST /v1/webhooks — register a URL + watchlist; get a signed POST the moment a watched company files a Form 4 or 8-K
- GET /v1/company/{ticker} — profile: CIK, legal name, SIC industry, exchange, fiscal-year end
- GET /v1/fundamentals/{ticker}?period=annual|quarterly&limit=N — income statement, balance sheet, cash flow
- GET /v1/ratios/{ticker} — margins, ROE/ROA, leverage, liquidity, growth (pre-computed)
- GET /v1/filings/{ticker}?form=10-K — recent 10-K/10-Q/8-K filings with document links
- GET /v1/sections/{ticker}?form=10-K&item=1A — 10-K/10-Q narrative sections (Risk Factors, MD&A, Business) as clean text

## Use Edgrapi from any AI agent
- [Hosted MCP server](https://api.edgrapi.com/mcp): JSON-RPC 2.0 over streamable-http. Drop into Claude Desktop, Claude Code, Cursor, or any MCP client with one config line. Tools: get_insider, get_events, get_fundamentals, get_ratios, get_company, get_filings, get_sections.
- [Agent skills (MIT-0)](https://github.com/paperandbeyond23-gif/edgrapi-skills): `npx skills add paperandbeyond23-gif/edgrapi-skills --skill edgrapi-full` — drop-in Python skills, no dependencies.
- [Agents & MCP guide](https://edgrapi.com/agents): setup for Claude, Cursor, and function-calling agents.

## Learn more
- [Docs](https://edgrapi.com/docs) · [API reference](https://edgrapi.com/docs/api/company) · [Blog](https://edgrapi.com/blog) · [Compare](https://edgrapi.com/compare)
- [The SEC EDGAR API: complete guide](https://edgrapi.com/blog/sec-edgar-api): what the SEC API is, every endpoint, real rate limits, and why normalization matters.

## Notes
- Data source: public SEC EDGAR XBRL (companyfacts/submissions). USD. Not investment advice.
- Coverage: 10,400+ US-listed tickers.
- OpenAPI: https://api.edgrapi.com/openapi.json
- Independent service, not affiliated with or endorsed by the U.S. SEC.