canonical: https://jentic.com/apis/arkleon.com/arkleon # Arkleon Arklēon Data API The Arkleon Data API serves as-filed financial data sourced from SEC submissions, returning point-in-time numeric facts and trailing-twelve-month values for a company. It exposes filings metadata, company identifier resolution, and ticker-to-CIK mappings as of a given date, so an agent can pin a figure to exactly how it was reported. A revisions endpoint traces the point-in-time timeline of a reported value as later amendments change it. ## For AI agents Fetch as-filed SEC financial facts and trailing-twelve-month values, list filings, resolve company identifiers, and trace how reported figures were revised. ## Scope Does not execute trades, stream real-time quotes, or give investment advice. Use for retrieving as-filed SEC financial facts and company identifiers only. ## Capabilities - Retrieve point-in-time numeric financial facts for a company - Get as-filed trailing-twelve-month values for a metric - List a company's SEC submission filings metadata - Resolve a company identifier such as a ticker or CIK - Trace the point-in-time revision timeline of a reported value - Map tickers and CIKs as of a given date ## Use cases ### AI agent answering fundamentals questions A finance agent needs grounded, as-filed figures when a user asks about a company's results. Through Jentic the agent searches for getting a company's financial facts, loads the facts operation with the bearer key already injected, and returns the reported value for the requested metric and period. The answer reflects exactly what was filed rather than a restated estimate. Example prompt: Call GET `/v1/facts` for a company and metric and return the reported value with its filing date ### Point-in-time financial analysis A backtesting workflow needs values as they were known on a past date, not later restatements, to avoid lookahead bias. The Arkleon Data API returns point-in-time facts and a revisions timeline showing how a figure changed as amendments were filed. This lets an agent reconstruct what the market could actually see on a given day. Example prompt: Call GET `/v1/revisions` for a reported figure and return the value as it stood on a specified historical date ### Company identifier resolution Before pulling data, an agent needs to turn a user's ticker into the canonical identifier the data is keyed on. The Arkleon Data API resolves company identifiers and maps tickers and CIKs as of a date, so an agent handles ticker changes and reassignments correctly. This keeps a lookup from silently returning the wrong company. Example prompt: Call GET `/v1/identifiers` to map a ticker to its CIK as of a date, then GET `/v1/companies` to confirm the match ## Key endpoints | Method | Path | Description | | --- | --- | --- | | GET | `/v1/facts` | Get point-in-time numeric financial facts | | GET | `/v1/ttm` | Get as-filed trailing-twelve-month values | | GET | `/v1/filings` | List a company's SEC submission filings metadata | | GET | `/v1/companies` | Resolve a company identifier | | GET | `/v1/revisions` | Trace the point-in-time revision timeline of a value | | GET | `/v1/identifiers` | Map tickers and CIKs as of a date | ## Key resources - **Facts** — Point-in-time numeric facts and as-filed trailing-twelve-month values - **Filings** — SEC submission filings metadata for a company - **Identifiers** — Company resolution, ticker and CIK mappings as of a date, and revision timelines ## 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:** 62 / 100 - **Maturity:** AI-Aware - **Dimensions:** - Foundational Compliance: 89 / 100 - Developer Experience & Jentic Compatibility: 69 / 100 - AI-Readiness & Agent Experience: 48 / 100 - Agent Usability: 94 / 100 - Security: 60 / 100 - AI Discoverability: 38 / 100 - **View full report:** https://jentic.com/apis/arkleon.com/arkleon/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 the Arkleon Data API by hand means issuing an API key, sending it as Authorization: Bearer, and shaping each facts, filings, or identifier query with its date and company parameters. Through Jentic you install once, import Arkleon from the API Directory, store the key once, and your agent calls it. - **Permission scoping:** The Arkleon Data API is read-only: facts, trailing-twelve-month values, filings, company resolution, revisions, and identifier mappings. You choose the operations your agent may call, so you can allow the facts and filings reads and leave the others out, and the agent can never reach an operation you have not allowed. - **Credential handling:** Your Arkleon key 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 'get a company's financial facts' or 'resolve a ticker to a CIK', and Jentic returns the matching Arkleon operation with its input schema so the agent calls the right endpoint without reading the reference docs. ## Related APIs - **Polygon.io API** — Provides market data and company financials with a broader real-time market focus - **SEC EDGAR API** — The primary SEC source for raw filings that Arkleon normalizes into point-in-time facts - **marketstack API** — Supplies end-of-day and intraday stock prices to pair with fundamental facts ## FAQ ### What authentication does the Arkleon Data API use? The Arkleon Data API uses a bearer key sent as Authorization: Bearer in the ak_ format, per its OpenAPI spec, and the spec notes that session cookies and Supabase JWTs are not accepted. An issued key is required for every operation. Through Jentic the key is stored once and injected at call time, so the agent never handles the raw key. ### Can I get a company's as-filed financial facts? Yes. Call GET `/v1/facts` for point-in-time numeric facts and GET `/v1/ttm` for as-filed trailing-twelve-month values. Because the figures are as-filed, an agent can report exactly what a company stated for a period rather than a later restated number. ### What are the rate limits for the Arkleon Data API? The OpenAPI spec does not define request-rate ceilings. Access is tied to the issued key and its plan. Check the Arkleon documentation for the limits on your key before running large historical or revision backfills. ### Is there an Arkleon Data API MCP server? You don't need an MCP server to give your agent the Arkleon Data API. Jentic connects it directly from the API Directory: import the API, store your key once, and your agent calls operations such as GET `/v1/facts` on demand without loading another server's tool definitions into its context. ### Can I limit what my agent is allowed to do with the Arkleon Data API? Yes. Write a rule that allows only the facts and filings reads, so the agent can pull reported figures and submission metadata but cannot call the revisions or identifier endpoints, and every call it makes is logged. The API is read-only, so you are choosing which reads are in scope. ### How do I get a company's financial facts through Jentic? Search Jentic for 'get a company's financial facts', load the GET `/v1/facts` operation, and run it after your key is stored. To run it on your own infrastructure, install Jentic One from its GitHub repo.