canonical: https://jentic.com/apis/agentfilings.com/agentfilings # AgentFilings The AgentFilings API serves structured US SEC and EDGAR filing data to autonomous agents as clean JSON. It returns the latest filings for a ticker with an optional form-type filter, a structured earnings summary derived from XBRL company facts without any PDF parsing, and Form 4 insider transactions for a ticker since a given date. The underlying data is public-domain SEC information, pre-parsed and normalized, and a free probe endpoint reports coverage, freshness timestamps, and per-endpoint pricing so an agent can decide before paying. Paid endpoints settle with x402 using USDC on Base, while the health and probe endpoints are free. ## For AI agents Fetch structured US SEC filings, XBRL-derived earnings summaries, and Form 4 insider transactions for a ticker as clean JSON. Free health and probe endpoints; paid endpoints settle with x402. ## Scope Does not handle real-time stock quotes, order execution, or non-US filings. Use for structured US SEC filing, earnings, and insider data only. ## Capabilities - Retrieve the latest SEC filings for a ticker, optionally filtered by form type - Read a structured earnings summary built from XBRL company facts without parsing PDFs - List Form 4 insider transactions for a ticker since a given date - Probe coverage, freshness timestamps, and per-endpoint pricing before paying ## Use cases ### Agent Filing Lookup via Jentic An AI agent researching a company can pull structured filings instead of scraping EDGAR. Through Jentic the agent calls the free probe to confirm coverage and pricing, then retrieves the latest filings for a ticker as clean JSON, filtering by form type when it only wants a specific disclosure. Example prompt: Call the probe endpoint to confirm coverage, then retrieve the latest filings for a given ticker filtered to a specific form type ### Earnings Analysis from XBRL Analysts need earnings figures without hand-parsing financial statements. AgentFilings returns an earnings summary derived directly from XBRL company facts, so an agent reads normalized numbers as JSON rather than extracting them from a PDF, and the data is public-domain SEC information kept pre-parsed and current. Example prompt: Read the structured earnings summary for a ticker and extract the latest reported revenue and net income figures ### Insider Transaction Monitoring Investors watch insider buying and selling for signal. AgentFilings lists Form 4 insider transactions for a ticker since a chosen date as clean JSON, so an agent polls for new filings on a watchlist and flags notable buys or sales without reading raw filings. Example prompt: List Form 4 insider transactions for a ticker since last week and flag any purchases above a chosen size ## Key endpoints | Method | Path | Description | | --- | --- | --- | | GET | `/filings/latest` | Latest filings for a ticker, optionally filtered by form type | | GET | `/earnings/summary` | Structured earnings summary from XBRL company facts | | GET | `/insiders` | Form 4 insider transactions for a ticker since a date | | GET | `/probe` | Coverage, freshness timestamps, and per-endpoint pricing | ## Key resources - **Filings** — Retrieve the latest filings for a ticker, optionally filtered by form type. - **Earnings** — Read a structured earnings summary derived from XBRL company facts. - **Insiders** — List Form 4 insider transactions for a ticker since a given date. - **Probe** — Read coverage, freshness timestamps, and per-endpoint pricing before paying. ## 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:** 61 / 100 - **Maturity:** AI-Aware - **Dimensions:** - Foundational Compliance: 100 / 100 - Developer Experience & Jentic Compatibility: 60 / 100 - AI-Readiness & Agent Experience: 35 / 100 - Agent Usability: 94 / 100 - Security: 100 / 100 - AI Discoverability: 60 / 100 - **View full report:** https://jentic.com/apis/agentfilings.com/agentfilings/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 ``` ## Why Jentic - **Setup:** Wiring AgentFilings by hand means calling the probe endpoint first to read coverage and per-endpoint pricing, then settling paid calls with x402 USDC on Base while leaving the free health and probe endpoints open. Through Jentic you install once, import AgentFilings from the API Directory, and your agent reads filings, earnings, and insider data. - **Permission scoping:** AgentFilings carries no resource id in its paths, so rules bound which operations your agent may call rather than which ticker. You can allow only the filings and earnings reads, so the agent retrieves company data and nothing else, and the insider-transactions endpoint stays out unless you add it. - **Credential handling:** AgentFilings needs no API key: its free endpoints are open and paid endpoints settle with x402 on Base, so there is no secret for Jentic to hold. When you add APIs that do use keys, your own Jentic One instance keeps them encrypted and injects them at execution time, never in the agent's prompt, logs, or context. - **Discovery method:** Agents search Jentic by intent such as 'get the latest filings for a ticker' or 'read a company's earnings summary', and Jentic returns the matching AgentFilings operation with its input schema so the agent calls the right endpoint directly. ## Related APIs - **SEC EDGAR** — SEC.gov serves raw EDGAR data directly; AgentFilings returns the same filings pre-parsed and normalized as clean JSON. - **Polygon.io** — Polygon.io offers market data and fundamentals across asset classes; AgentFilings focuses on SEC filings, earnings, and insider data. - **Finnhub** — Finnhub adds quotes, news, and estimates; AgentFilings supplies the structured filing and insider record. ## FAQ ### What authentication does the AgentFilings API use? The AgentFilings API requires no credential per its OpenAPI spec: the health and probe endpoints are free and open, and the filings, earnings, and insider endpoints are paid, settling with x402 using USDC on Base. There is no key to manage, so an agent calls the free probe first to read coverage and pricing before paying. Through Jentic the operations are imported from the API Directory and called directly. ### Is there an AgentFilings MCP server? You don't need an MCP server to give your agent AgentFilings. Jentic connects it directly from the API Directory: import AgentFilings and your agent reads filings, earnings, and insider data straight away. Operations are discovered on demand, so no extra server's tool definitions sit in your agent's context. ### Can I limit what my agent is allowed to do with the AgentFilings API? Yes. AgentFilings carries no resource id in its paths, so rules bound which operations the agent may call rather than which ticker. You can allow only the filings and earnings reads, so the agent retrieves company data and nothing else, and the paid insider-transactions endpoint stays out of the rule unless you add it. ### Can I get a company's earnings with the AgentFilings API? Yes. The earnings summary endpoint returns a structured summary built from XBRL company facts, so you read normalized figures as JSON without parsing a PDF. The data is public-domain SEC information kept pre-parsed, and the probe endpoint reports how fresh it is before you request it. ### What are the rate limits for the AgentFilings API? The AgentFilings OpenAPI spec does not publish request rate limits. Pricing is per endpoint and is returned by the free probe endpoint along with coverage and freshness timestamps, so an agent checks cost and availability before paying with x402. Check the AgentFilings documentation at https://agentfilings.com for current details. ### How do I get SEC filings with the AgentFilings API through Jentic? Search the Jentic API Directory for an intent like 'get the latest filings for a ticker', import AgentFilings, and your agent calls the probe and filings operations through Jentic. To run it on your own infrastructure, install Jentic One from its GitHub repo.