Earnings Feed API
Access SEC filings, insider transactions, institutional holdings, and company data. Authentication All API endpoints require authentication via API key.…
Fork copies the collection into your workspace, without the publisher's secrets, so you can add your own key and send requests. Star saves it to your starred APIs (Account › Marketplace) and helps others find it.
Overview
Access SEC filings, insider transactions, institutional holdings, and company data.
Authentication
All API endpoints require authentication via API key. Include your key in the Authorization header:
Authorization: Bearer your_api_keyRate Limits
The tier-specific per-minute limits below apply to API-key and MCP requests. Interactive documentation tokens retain a
fixed limit of 10 requests per minute, regardless of subscription tier:
| Tier | Requests/minute | Requests/UTC month |
|---|---|---|
| Free | 15 | 5,000 |
| Pro | 60 | 250,000 |
| Business | 300 | 2,000,000 |
The monthly allowance is account-wide and shared across API keys, interactive documentation, and MCP tool calls.
Authenticated responses that pass the minute throttle include both minute and monthly usage headers:
X-RateLimit-Limit: Maximum requests per minuteX-RateLimit-Remaining: Remaining requests in current windowX-RateLimit-Reset: Unix timestamp when the window resetsX-RateLimit-Monthly-Limit: Requests included per UTC calendar monthX-RateLimit-Monthly-Remaining: Remaining requests in the current UTC monthX-RateLimit-Monthly-Reset: Unix timestamp for the next UTC monthX-RateLimit-Monthly-Policy: currentlyhardfor every tier
Every tier stops at its account-wide UTC monthly allowance: Free at 5,000 requests, Pro at 250,000, and Business at
2,000,000. Usage milestones are recorded at 70%, 90%, and 100% so integrations can upgrade before reaching the cap.
For a minute throttle, HTTP 429 uses code RATE_LIMITED, X-RateLimit-Scope: minute, and a Retry-After
header. Wait for that interval, add jitter, and cap retry attempts. A monthly cap uses codeMONTHLY_QUOTA_EXCEEDED, X-RateLimit-Scope: monthly, reset timing, upgrade guidance, and an HTTP-dateRetry-After value that points to the monthly reset; do not retry it in a loop.
async function fetchWithBackoff(url, options) {
for (let attempt = 0; attempt setTimeout(resolve, retryAfter * 1000 + jitterMs));
}
}Pagination
List endpoints use cursor-based pagination:
limit: Number of items per page (1-100, default 25)cursor: Opaque cursor from previous response
Response includes:
items: Array of resultsnextCursor: Cursor for next page (null if no more)hasMore: Whether more items exist
Endpoints 11
Filings
- GETList SEC filings
/api/v1/filingsRetrieve a paginated feed of SEC filings with optional filters. Data Source Returns filings from SEC EDGAR, including annual reports, quarterly reports,… - GETGet filing details
/api/v1/filings/:accessionRetrieve detailed information about a specific SEC filing by accession number. Accession Number Format The SEC accession number uniquely identifies each…
Insider
- GETList insider transactions
/api/v1/insider/transactionsRetrieve a paginated feed of SEC insider trading transactions from Forms 3, 4, and 5. Data Source This endpoint returns transactions reported by corporate…
Institutional
- GETList institutional holdings
/api/v1/institutional/holdingsRetrieve institutional investment holdings from SEC Form 13F filings. Data Source Form 13F is a quarterly report filed by institutional investment managers…
Companies
- GETGet company profile
/api/v1/companies/:cikRetrieve detailed information about a company by its SEC CIK (Central Index Key). What is a CIK? The CIK is the SEC's unique identifier for entities that file… - GETSearch companies
/api/v1/companies/searchSearch for companies by name, ticker, or apply filters. Search Behavior The q parameter searches across: Company names: Partial match, case-insensitive Ticker…
Webhooks
- GETList webhook endpoints
/api/v1/webhooksList all webhook endpoints for the authenticated user. The signing secret is not included in the response — it is only returned at creation time. - POSTCreate webhook endpoint
/api/v1/webhooksRegister a URL to receive webhook notifications when new SEC filings match your alert preferences. How It Works 1. Create a webhook endpoint with your URL 2.… - DELETEDelete webhook endpoint
/api/v1/webhooks/:idDelete a webhook endpoint. Only the owner can delete their own endpoints. All associated delivery history is also removed. - GETList webhook deliveries
/api/v1/webhooks/:id/deliveriesView delivery history for a specific webhook endpoint. Returns recent deliveries sorted by most recent first. Delivery Statuses Debugging Failures Check…
Account
- GETGet current user
/api/v1/meReturns information about the authenticated user. Useful for verifying API key ownership and for integration connection labels (e.g. Zapier).
API details
- Base URL
https://earningsfeed.com- Authentication
- A bearer token in the Authorization header
- Operations
- 11 operations on 10 pathsGET 9POST 1DELETE 1
- Main resources
- Webhooks 4Companies 2Filings 2Account 1Insider 1Institutional 1
- Response formats
application/json- Description format
- OpenAPI 3.1.0, API version
1.0.0 - Links
- OpenAPI document · Support
- Listed from
- Earningsfeed's published OpenAPI description
How to test the Earnings Feed API in Swastik Codes
- Open the APISelect “Fork & run in Swastik Codes” on this page. Sign in or create a free account if asked.
- Fork it into your workspaceChoose a workspace. You get your own copy of the Earnings Feed API collection, without the publisher's secrets.
- Add your credentialsThis API uses A bearer token in the Authorization header. Add yours in the collection's variables or an environment; the requests already reference it.
- Send a requestPick an endpoint, for example “List SEC filings” (GET /api/v1/filings), and press Send. Check the response, add tests and run the whole collection with the runner.
Frequently asked questions
What is the Earnings Feed API?
Access SEC filings, insider transactions, institutional holdings, and company data. Authentication All API endpoints require authentication via API key.… It is listed under Finance & banking and has 11 endpoints.
Who publishes the Earnings Feed API?
It is listed from Earnings Feed's public API description (an OpenAPI document), not published by Earnings Feed on Swastik Codes. Anyone who controls earningsfeed.com can claim the profile by adding a DNS TXT record.
What is the base URL of the Earnings Feed API?
Requests go to https://earningsfeed.com. Endpoint paths are added to this base URL.
How do I authenticate with the Earnings Feed API?
With A bearer token in the Authorization header.
How many endpoints does the Earnings Feed API have?
11 operations on 10 paths (9 GET, 1 POST, 1 DELETE). The largest groups are Webhooks, Companies, Filings, Account.
Is forking the Earnings Feed API free?
Yes. Forking copies the collection into your workspace for free. It has been starred 0 times and forked 0 times.