canonical: https://jentic.com/apis/earningsfeed.com/earningsfeed

# Earnings Feed API

The Earnings Feed API serves SEC filings, insider transactions, institutional holdings, and company data for public US companies. It lists filings and returns full detail by accession number, exposes insider transactions and institutional holdings, and resolves company profiles by CIK or through a company search. Webhook endpoints let you subscribe to new data and inspect their delivery history so a system can react as filings arrive rather than polling.

## For AI agents

Pull SEC filings, insider transactions, institutional holdings, and company profiles, and subscribe to new filings through webhooks.

## Scope

Does not place trades, stream real-time prices, or file documents with the SEC. Use for reading SEC filings, insider and institutional data, and company profiles only.

## Capabilities

- List SEC filings and get full filing detail by accession number
- List insider transactions and institutional holdings
- Resolve a company profile by CIK or search companies by name
- Create and list webhook endpoints that fire on new data
- Inspect a webhook's delivery history

## Use cases

### Agent-driven filings monitoring

An AI agent connected through Jentic lists new SEC filings, opens the ones that matter by accession number, and resolves the filer's company profile so an analyst gets a briefing on what was disclosed. The agent reads the filing and company data on demand and summarizes the material points.

Example prompt: List today's SEC filings, pull the detail for each 8-K, and summarize what was disclosed

### Insider and institutional tracking

Research workflows track who is buying and selling by reading insider transactions and institutional holdings for the companies they follow. The API returns both datasets so an agent can report notable changes without parsing the underlying forms itself.

Example prompt: Pull the insider transactions and institutional holdings for a company and flag the largest recent moves

### Webhook-driven ingestion

Instead of polling, teams create a webhook endpoint so Earnings Feed pushes new data as it arrives, then inspect the delivery history to confirm receipt. The API exposes create, list, delete, and delivery-history operations for webhooks, giving an agent a way to wire up and verify a feed.

Example prompt: Create a webhook endpoint for new filings and read its recent delivery history to confirm it is firing

## Key endpoints

| Method | Path | Description |
| --- | --- | --- |
| GET | `/api/v1/filings` | List SEC filings |
| GET | `/api/v1/filings/{accession}` | Get filing details by accession number |
| GET | `/api/v1/insider/transactions` | List insider transactions |
| GET | `/api/v1/institutional/holdings` | List institutional holdings |
| GET | `/api/v1/companies/{cik}` | Get a company profile by CIK |
| POST | `/api/v1/webhooks` | Create a webhook endpoint |

## Key resources

- **Filings** — List SEC filings and get full detail by accession number
- **Insider** — List insider transactions
- **Institutional** — List institutional holdings
- **Companies** — Get a company profile by CIK and search companies
- **Webhooks** — Create, list, and delete webhook endpoints and read their deliveries

## AI readiness

This API is usable in Jentic One now. Its AI-readiness score against Jentic's framework shows where it stands today and where improvements would make it even easier for agents to use.

- **Score:** 55 / 100
- **Maturity:** Foundational
- **Dimensions:**
  - Foundational Compliance: 99 / 100
  - Developer Experience & Jentic Compatibility: 80 / 100
  - AI-Readiness & Agent Experience: 27 / 100
  - Agent Usability: 94 / 100
  - Security: 60 / 100
  - AI Discoverability: 74 / 100
- **View full report:** https://jentic.com/apis/earningsfeed.com/earningsfeed/scorecard
- **How the score is calculated:** https://docs.jentic.com/reference/api-readiness-framework/overview/
- **More about the dimensions:** https://docs.jentic.com/reference/api-readiness-framework/specification/#dimensional-model-overview

### Score it yourself

Every API in the directory is allowlisted, so you can re-score it with no key required.

- **Score your own API:** https://jentic.com/scorecard.md
- **Scoring CLI agent skill:** https://github.com/jentic/jentic-api-scorecard/blob/main/skills/jentic-api-scorecard/SKILL.md

```sh
npx @jentic/api-scorecard-cli score <openapi-url>
```

## Why Jentic

- **Setup:** Wiring Earnings Feed by hand means handling its Bearer auth, resolving filings by accession number and companies by CIK, and standing up and verifying webhook endpoints yourself. Through Jentic you install once, import Earnings Feed from the API Directory, store the token once, and your agent calls it.
- **Permission scoping:** Earnings Feed carries webhook ids, filing accession numbers, and company CIKs in the URL path, so a rule can pin your agent to the reads you pick, such as listing filings and reading company profiles. You choose the operations it may call, so webhook creation and deletion are not included unless you add them.
- **Credential handling:** Your Earnings Feed token is stored once, encrypted, by your own Jentic One instance and injected at execution time. It never enters the agent's prompt, logs, or context.
- **Discovery method:** Agents search Jentic by intent such as 'list SEC filings' or 'get insider transactions', and Jentic returns the matching Earnings Feed operation with its input schema so the agent calls the right endpoint without browsing the reference docs.

## Related APIs

- **SEC EDGAR** — The primary source of US regulatory filings that Earnings Feed indexes and enriches.
- **Finnhub** — Market data and fundamentals that also expose filings and ownership, an alternative to Earnings Feed.
- **Polygon** — Market data with filings and reference endpoints, versus Earnings Feed's filings-first focus.

## FAQ

### What authentication does the Earnings Feed API use?

The Earnings Feed API authenticates with a Bearer token in the Authorization header per its OpenAPI spec; every endpoint requires it. Through Jentic the token is stored once and injected at call time so it never enters the agent's prompt.

### Can I get SEC filing details with the Earnings Feed API?

Yes. You can list filings and fetch the full detail for one by its accession number, alongside insider transactions, institutional holdings, and company profiles resolved by CIK or company search.

### What are the rate limits for the Earnings Feed API?

The spec documents tier-based per-minute and monthly limits that depend on your subscription. Check your Earnings Feed plan and documentation for the exact figures that apply to your key before running large backfills.

### Is there an Earnings Feed API MCP server?

You don't need an MCP server to give your agent the Earnings Feed API. Jentic connects it directly from the API Directory: import it, store your token once, and your agent reads filings and company data on demand without loading another server's tool definitions into its context.

### Can I limit what my agent is allowed to do with the Earnings Feed API?

Yes. Write a rule that allows only the filings-read and company-read operations, so the agent can pull filings and profiles but cannot create or delete webhook endpoints, and every call it makes is logged for review.

### How do I monitor SEC filings with the Earnings Feed API through Jentic?

Search Jentic for 'list SEC filings', add the Earnings Feed API from the directory, and store your token once; your agent can then list new filings and pull their details on demand. To run it on your own infrastructure, install Jentic One from its GitHub repo.