Earnings Feed
- Free allowance
- Free plan USD 0 forever: API access to every endpoint at 15 requests per minute and 5,000 requests per UTC calendar month, a hard cap; plus the SEC filings feed, a 5-company watchlist, 2 alert subscriptions and 10 full-text searches a day.
- Verdict
- caveatusable, with a named limit or an unprobed read path
- Cost
- free tier
- Identity
- emailno card, no phone
- Binding limit
- request-rate15 requests per minute on the Free plan; 5,000 requests per UTC calendar month on the Free plan, a hard cap
- Evidence
- documented43 sources; a first-party page was read and the sentence quoted
- Freshness
- stale on 2026-12-03checked 2026-11-02 (live); stale on 2026-12-03
| Free tier | Free plan USD 0 forever: API access to every endpoint at 15 requests per minute and 5,000 requests per UTC calendar month, a hard cap; plus the SEC filings feed, a 5-company watchlist, 2 alert subscriptions and 10 full-text searches a day. unit requests; metered on request-count; The monthly allowance is account-wide across API keys, the interactive docs and the MCP server, and resets at the start of each UTC calendar month. The six documented endpoints are the filings feed, filing detail by accession number, insider transactions (Forms 3, 4 and 5), institutional holdings (13F), company profile by CIK and company search. Forms kept: 8-K, 10-K, 10-Q, 6-K, S-1, 10-D, Forms 3, 4 and 5, Schedules 13D and 13G, 13F and Form 144; EDGAR is checked every minute. The next plan up is Pro at USD 10 a month billed annually (USD 15 monthly) with 60 requests a minute and 250,000 a month. |
|---|---|
| Price | none stated |
| Limits |
Interactive docs tokens keep a fixed limit of 10 requests per minute on every plan. Bulk path: none; list endpoints page 100 items per call with a cursor. |
| Binding | request-rate The 5,000 requests a month hard cap is met long before the 15 per minute rate could be. |
| Identity | email The sign-up page is labelled free forever, no credit card, and takes a first name, a last name, an email and a password of at least 8 characters under its or-use-email option; an optional field asks where the user heard about the service. |
| Egress | not metered in bytes; the 5,000 requests a month bound what a free key can pull |
| Per-object cap | 100 items per page at most (limit 1-100, default 25), paged with an opaque cursor |
| Interface | rest GET https://earningsfeed.com/api/v1/{endpoint} with Authorization: Bearer <key>; JSON, cursor-paginated, with an OpenAPI 3.1 spec at /api/v1/openapi.json. An MCP server at https://earningsfeed.com/api/mcp signs in with OAuth on Free, Pro and Trader accounts and shares the same allowance. endpoint: https://earningsfeed.com/api/v1/filings |
| Tooling | any HTTP client; official Python (earningsfeed) and Node.js (earningsfeed) SDKs; an MCP server |
| Composes with | SEC filings, insider trades and 13F holdings under a hard 5,000-requests-a-month cap, so a free stack uses it for filing lookups and takes prices from a quote feed such as Finnhub or Alpha Vantage. |
| Reliability | A minute throttle answers HTTP 429 with code RATE_LIMITED and Retry-After; a spent month answers 429 with code MONTHLY_QUOTA_EXCEEDED, which should not be retried before the UTC reset; a keyless call answered HTTP 401 UNAUTHORIZED. |
| Notes | The Free plan reaches every endpoint; the binding limit is the 5,000-request monthly hard cap. |
| Evidence note | documented Limits, plan features and endpoints are read from the first-party pricing, API, FAQ and OpenAPI pages, and a keyless call answered HTTP 401. A free key was not exercised, so the live answer on a spent month is unverified: behind a sign-up. |
| Parsed numbers |
|
Evidence 43
| date | source | what it proved |
|---|---|---|
| 2026-11-02 | earningsfeed.com/pricing | the Free plan is USD 0 a month, forever |
| 2026-11-02 | earningsfeed.com/pricing | the Free plan includes API access at 15 requests per minute and 5,000 a month |
| 2026-11-02 | earningsfeed.com/pricing | the plan table gives Free 15 a minute and 5K a month against 60 and 250K on Pro |
| 2026-11-02 | earningsfeed.com/pricing | the Free plan watchlist holds 5 companies |
| 2026-11-02 | earningsfeed.com/pricing | the Free plan has 2 alert subscriptions |
| 2026-11-02 | earningsfeed.com/pricing | the Free plan allows 10 full-text searches a day |
| 2026-11-02 | earningsfeed.com/pricing | the Free sign-up needs no credit card |
| 2026-11-02 | earningsfeed.com/api | the Free plan is 15 per minute and 5,000 per month at USD 0 |
| 2026-11-02 | earningsfeed.com/api | every plan includes every endpoint and monthly limits are hard caps resetting each UTC month |
| 2026-11-02 | earningsfeed.com/api | the API documents six endpoints |
| 2026-11-02 | earningsfeed.com/api | the filings endpoint is open to all plans |
| 2026-11-02 | earningsfeed.com/api | the institutional holdings endpoint is open to all plans |
| 2026-11-02 | earningsfeed.com/api | results are paged with a cursor |
| 2026-11-02 | earningsfeed.com/api | the API authenticates with a bearer token in the Authorization header |
| 2026-11-02 | earningsfeed.com/api | the forms kept in the API |
| 2026-11-02 | earningsfeed.com/api | EDGAR is checked every minute |
| 2026-11-02 | earningsfeed.com/api/docs | Free accounts include 15 requests per minute and 5,000 requests per UTC calendar month |
| 2026-11-02 | earningsfeed.com/api/docs | monthly allowances are hard caps on Free |
| 2026-11-02 | earningsfeed.com/api/docs | interactive docs tokens keep a fixed 10 per minute limit |
| 2026-11-02 | earningsfeed.com/api/docs | the monthly quota is account-wide across API keys, interactive docs and MCP |
| 2026-11-02 | earningsfeed.com/faq | monthly limits are hard caps that reset at the start of each UTC calendar month |
| 2026-11-02 | earningsfeed.com/faq | Pro is USD 10 a month billed annually and USD 15 monthly |
| 2026-11-02 | earningsfeed.com/faq | the MCP server signs in with OAuth on Free, Pro and Trader accounts |
| 2026-11-02 | earningsfeed.com/mcp/docs | the MCP server URL |
| 2026-11-02 | earningsfeed.com/sign-up | the sign-up page is free forever with no credit card |
| 2026-11-02 | earningsfeed.com/sign-up | the sign-up form takes a first name, a last name, an email and a password of at least 8 characters |
| 2026-11-02 | earningsfeed.com/sign-up | the sign-up page offers an or-use-email form |
| 2026-11-02 | earningsfeed.com/api/v1/openapi.json | list endpoints take a limit of 1-100 items per page, default 25 |
| 2026-11-02 | earningsfeed.com/api/v1/openapi.json | every tier stops at its account-wide UTC monthly allowance, Free at 5,000 requests |
| 2026-11-02 | earningsfeed.com/api/v1/openapi.json | part of the text of Reliability, above |
| 2026-11-02 | earningsfeed.com/api/v1/openapi.json | a spent month answers 429 with code MONTHLY_QUOTA_EXCEEDED and monthly scope |
| 2026-11-02 | earningsfeed.com/api/v1/openapi.json | the spec states that the key goes in the Authorization header as a bearer token |
| 2026-11-02 | earningsfeed.com/api/v1/openapi.json | the API publishes an OpenAPI 3.1 document titled Earnings Feed API |
| 2026-11-02 | github.com/earningsfeed/earningsfeed-python | an official Python SDK exists |
| 2026-11-02 | github.com/earningsfeed/earningsfeed-node | an official Node.js SDK exists |
| 2026-11-02 | earningsfeed.com/api | the filing detail endpoint is open to all plans |
| 2026-11-02 | earningsfeed.com/api | the insider transactions endpoint is open to all plans |
| 2026-11-02 | earningsfeed.com/api | the company profile endpoint is open to all plans |
| 2026-11-02 | earningsfeed.com/api | the company search endpoint is open to all plans |
| 2026-11-02 | earningsfeed.com/api/v1/openapi.json | interactive documentation tokens keep a fixed limit of 10 requests per minute whatever the subscription tier |
| 2026-11-02 | probe: https://earningsfeed.com/api/v1/filings?ticker=AAPL&limit=1 | a keyless call to the API answers HTTP 401 |
| 2026-11-02 | probe: https://earningsfeed.com/api/v1/filings?ticker=AAPL&limit=1 | the keyless 401 body asks for a bearer key and carries code UNAUTHORIZED |
| 2026-11-02 | probe: https://earningsfeed.com/api/v1/openapi.json | the OpenAPI document answers HTTP 200 with no key |
Unknown values 1
- retention stated: the field does not apply to this kind of offer