API குறிப்பு
APIஒவ்வொரு பாதையிலும், OpenAPI ஆவணத்திலிருந்து படிக்கவும். ஒவ்வொன்றுக்கும் ஒரு உண்மையான நிறுவனத்துடன் ஒரு உதாரண கோரிக்கை உள்ளது. ஊடாடும் குறிப்பு உலாவியில் அதே அழைப்புகளை இயக்குகிறது.
GET /v1/companies
Search or page the company directory. Use it to turn a name into a company id, or to list every company with a dataset. Each item has fmd_id, cik, primary_ticker, registry, lei and available_datasets. Issuers on EU and UK regulated markets are listed with registry=esef and no CIK: filter them with registry=esef or country=FR, and pass company=lei:<LEI> to the company routes.
Example: GET https://api.financial.md/v1/companies?q=Apple&limit=5
| Parameter | In | Description |
|---|---|---|
q | query | Name or ticker search (names as substring, tickers as prefix; case-insensitive) |
country | query | ISO 3166-1 alpha-2 |
registry | query | The regulator the statements are read from: sec, or esef for issuers on EU and UK regulated markets |
exchange | query | MIC of a listing, e.g. XNAS |
template | query | Reporting template |
status | query | Company status |
updated_since | query | Companies updated since this date or timestamp |
limit | query | Maximum companies per page |
cursor | query | Opaque cursor from meta.next_cursor |
curl "https://api.financial.md/v1/companies?q=Apple&limit=5"GET /v1/company/profile
One company's identity: CIK, listings with exchange codes, sector, industry, reporting template, fiscal year end and which datasets are served. Call it first when you are unsure a ticker is covered. registry names the regulator the statements come from, reporting_currency the currency every value is served in (never converted), and registrations every regulator the company is known at.
Example: GET https://api.financial.md/v1/company/profile?company=ticker:AAPL
| Parameter | In | Description |
|---|---|---|
company (required) | query | Company as fmd_<id>, cik:<number>, ticker:<symbol>[.<mic>] or lei:<LEI>; a bare symbol means ticker, bare digits mean cik. A filer outside the SEC (an EU or UK issuer) has no CIK: use its LEI or fmd_id from /v1/companies |
curl "https://api.financial.md/v1/company/profile?company=ticker:AAPL"GET /v1/company/financials/{statement}/standardized
A financial statement on the FinancialMD template, so line items compare across companies. Use it for questions such as "What was Apple's revenue in fiscal 2024?" or "What is AAPL's free cash flow?". data.periods is most recent first and row.cells[i] is the value object for periods[i], each with the 10-K or 10-Q it came from. Add as_of for what was known on a date, original=true for first-reported values, history=true for every restatement.
Example: GET https://api.financial.md/v1/company/financials/income_statement/standardized?company=ticker:AAPL&period_type=annual&limit=5
| Parameter | In | Description |
|---|---|---|
statement (required) | path | Statement; supplemental carries share counts and per-share figures |
company (required) | query | Company as fmd_<id>, cik:<number>, ticker:<symbol>[.<mic>] or lei:<LEI>; a bare symbol means ticker, bare digits mean cik. A filer outside the SEC (an EU or UK issuer) has no CIK: use its LEI or fmd_id from /v1/companies |
period_type | query | Period type |
limit | query | Maximum periods (most recent first) |
as_of | query | Point in time: a date (YYYY-MM-DD, end of day UTC) or ISO timestamp. Answers what was known then. |
original | query | First-reported version of each period |
history | query | Every knowledge version of each period, oldest first |
curl "https://api.financial.md/v1/company/financials/income_statement/standardized?company=ticker:AAPL&period_type=annual&limit=5"GET /v1/company/financials/{statement}/as_reported
The same grid with the filer's own line items: one row per XBRL tag and dimension as filed. Use it when you need the company's exact label or a line the template folds into a total.
Example: GET https://api.financial.md/v1/company/financials/balance_sheet/as_reported?company=cik:320193&period_type=annual&limit=2
| Parameter | In | Description |
|---|---|---|
statement (required) | path | Statement |
company (required) | query | Company as fmd_<id>, cik:<number>, ticker:<symbol>[.<mic>] or lei:<LEI>; a bare symbol means ticker, bare digits mean cik. A filer outside the SEC (an EU or UK issuer) has no CIK: use its LEI or fmd_id from /v1/companies |
period_type | query | Period type (as-reported serves annual, quarterly and half-year facts; balance sheets are instants at the period end) |
limit | query | Maximum periods |
as_of | query | Point in time: a date (YYYY-MM-DD, end of day UTC) or ISO timestamp. Answers what was known then. |
history | query | Every filing's version of each line and period, oldest first |
accession | query | Only facts from this filing |
curl "https://api.financial.md/v1/company/financials/balance_sheet/as_reported?company=cik:320193&period_type=annual&limit=2"GET /v1/company/ratios
Margins, returns, leverage, liquidity, growth and per-share ratios for each period, computed from the standardized facts. Each ratio carries the proof ids of its inputs, so it can be traced to the filing.
Example: GET https://api.financial.md/v1/company/ratios?company=ticker:AAPL&period_type=annual&limit=5
| Parameter | In | Description |
|---|---|---|
company (required) | query | Company as fmd_<id>, cik:<number>, ticker:<symbol>[.<mic>] or lei:<LEI>; a bare symbol means ticker, bare digits mean cik. A filer outside the SEC (an EU or UK issuer) has no CIK: use its LEI or fmd_id from /v1/companies |
period_type | query | Period type |
limit | query | Maximum periods (most recent first) |
as_of | query | Point in time: a date (YYYY-MM-DD, end of day UTC) or ISO timestamp. Answers what was known then. |
curl "https://api.financial.md/v1/company/ratios?company=ticker:AAPL&period_type=annual&limit=5"GET /v1/company/ratios/daily/{ratio_id}
One ratio as a series. Fundamental ratios have one point per fiscal period; valuation ratios (market cap, P/E, EV/EBITDA and others) have one point per trading session, pairing the IEX close with the facts known that evening.
Example: GET https://api.financial.md/v1/company/ratios/daily/gross_margin?company=ticker:AAPL&period_type=annual&limit=10
| Parameter | In | Description |
|---|---|---|
ratio_id (required) | path | Ratio id from GET /v1/company/metrics?statement=ratios |
company (required) | query | Company as fmd_<id>, cik:<number>, ticker:<symbol>[.<mic>] or lei:<LEI>; a bare symbol means ticker, bare digits mean cik. A filer outside the SEC (an EU or UK issuer) has no CIK: use its LEI or fmd_id from /v1/companies |
period_type | query | Period type |
limit | query | Maximum periods (most recent first); sessions for a valuation ratio |
as_of | query | Point in time: a date (YYYY-MM-DD, end of day UTC) or ISO timestamp. Answers what was known then. |
ticker | query | Valuation ratios: the listing whose close is used |
from | query | Valuation ratios: first session, inclusive |
to | query | Valuation ratios: last session, inclusive |
cursor | query | Opaque cursor from meta.next_cursor |
curl "https://api.financial.md/v1/company/ratios/daily/gross_margin?company=ticker:AAPL&period_type=annual&limit=10"GET /v1/company/metrics
The concept ids, labels, display order and subtotal formulas of the company's template. Use the ids in /v1/screen, /v1/verify and to read statement rows. statement=ratios lists the ratio ids and formulas.
Example: GET https://api.financial.md/v1/company/metrics?company=ticker:AAPL&statement=income_statement
| Parameter | In | Description |
|---|---|---|
company (required) | query | Company as fmd_<id>, cik:<number>, ticker:<symbol>[.<mic>] or lei:<LEI>; a bare symbol means ticker, bare digits mean cik. A filer outside the SEC (an EU or UK issuer) has no CIK: use its LEI or fmd_id from /v1/companies |
statement | query | Only this statement; ratios lists the serve-time ratios with their formulas |
curl "https://api.financial.md/v1/company/metrics?company=ticker:AAPL&statement=income_statement"GET /v1/company/filings
A company's SEC filings, newest first, with accession number, form, period and filing date and an EDGAR link.
Example: GET https://api.financial.md/v1/company/filings?company=ticker:AAPL&form=10-K&limit=5
| Parameter | In | Description |
|---|---|---|
company (required) | query | Company as fmd_<id>, cik:<number>, ticker:<symbol>[.<mic>] or lei:<LEI>; a bare symbol means ticker, bare digits mean cik. A filer outside the SEC (an EU or UK issuer) has no CIK: use its LEI or fmd_id from /v1/companies |
form | query | Form type, e.g. 10-K |
as_of | query | Point in time: a date (YYYY-MM-DD, end of day UTC) or ISO timestamp. Answers what was known then. |
limit | query | Maximum filings |
cursor | query | Opaque cursor from meta.next_cursor |
curl "https://api.financial.md/v1/company/filings?company=ticker:AAPL&form=10-K&limit=5"GET /v1/filing/{accession}
One filing by accession number: form, fiscal period, filing and acceptance times, primary document and EDGAR link.
Example: GET https://api.financial.md/v1/filing/0000320193-24-000123
| Parameter | In | Description |
|---|---|---|
accession (required) | path | Accession number, e.g. 0000320193-24-000123 |
curl "https://api.financial.md/v1/filing/0000320193-24-000123"GET /v1/filing/{accession}/document
Links to every document of a filing on EDGAR; index_url and document_url are always sent, also when no PDF is rendered. format=html returns the primary document itself, format=pdf the same document printed to pages with selectable text, format=pages its page count, and format=png&page=N one page as an image to cite.
Example: GET https://api.financial.md/v1/filing/0000320193-24-000123/document
| Parameter | In | Description |
|---|---|---|
accession (required) | path | Accession number |
format | query | json: the links. html: the primary document as EDGAR serves it (relative links resolve to EDGAR). pdf: the primary document printed to US Letter pages, with selectable text. pages: the PDF's page count and its links, as JSON. png: one page of the PDF as an image (needs page) |
page | query | With format=png: the page to return, from 1 to the page count that format=pages and the X-FMD-Page-Count header give |
curl "https://api.financial.md/v1/filing/0000320193-24-000123/document"GET /v1/filing/{accession}/facts
Every fact one filing tagged that maps to a statement concept, grouped by statement, in one call. Use it to read what a single 10-K or 10-Q said.
Example: GET https://api.financial.md/v1/filing/0000320193-24-000123/facts?statement=income_statement
| Parameter | In | Description |
|---|---|---|
accession (required) | path | Accession number |
statement | query | Only this statement |
limit | query | Maximum facts |
curl "https://api.financial.md/v1/filing/0000320193-24-000123/facts?statement=income_statement"GET /v1/company/ownership/insiders
Insider transactions from Forms 3, 4 and 5, newest first: who, role, transaction code, shares, price and the filing.
Example: GET https://api.financial.md/v1/company/ownership/insiders?company=ticker:AAPL&limit=20
| Parameter | In | Description |
|---|---|---|
company (required) | query | Company as fmd_<id>, cik:<number>, ticker:<symbol>[.<mic>] or lei:<LEI>; a bare symbol means ticker, bare digits mean cik. A filer outside the SEC (an EU or UK issuer) has no CIK: use its LEI or fmd_id from /v1/companies |
as_of | query | Point in time: a date (YYYY-MM-DD, end of day UTC) or ISO timestamp. Answers what was known then. |
limit | query | Maximum transactions |
cursor | query | Opaque cursor from meta.next_cursor |
curl "https://api.financial.md/v1/company/ownership/insiders?company=ticker:AAPL&limit=20"GET /v1/company/ownership/institutional
Form 13F managers that reported a position in the company for a quarter, with shares, value and the change against the prior quarter.
Example: GET https://api.financial.md/v1/company/ownership/institutional?company=ticker:AAPL&limit=20
| Parameter | In | Description |
|---|---|---|
company (required) | query | Company as fmd_<id>, cik:<number>, ticker:<symbol>[.<mic>] or lei:<LEI>; a bare symbol means ticker, bare digits mean cik. A filer outside the SEC (an EU or UK issuer) has no CIK: use its LEI or fmd_id from /v1/companies |
period | query | Calendar quarter end the holdings are reported for |
as_of | query | Point in time: a date (YYYY-MM-DD, end of day UTC) or ISO timestamp. Answers what was known then. |
limit | query | Maximum positions |
cursor | query | Opaque cursor from meta.next_cursor |
curl "https://api.financial.md/v1/company/ownership/institutional?company=ticker:AAPL&limit=20"GET /v1/ownership/institutional/holders
Search Form 13F managers by name. Each has a CIK to pass to /v1/ownership/institutional/holdings.
Example: GET https://api.financial.md/v1/ownership/institutional/holders?q=Berkshire
| Parameter | In | Description |
|---|---|---|
q | query | Manager name search (case-insensitive substring) |
as_of | query | Point in time: a date (YYYY-MM-DD, end of day UTC) or ISO timestamp. Answers what was known then. |
limit | query | Maximum managers |
cursor | query | Opaque cursor from meta.next_cursor |
curl "https://api.financial.md/v1/ownership/institutional/holders?q=Berkshire"GET /v1/ownership/institutional/holdings
One Form 13F manager's portfolio for a quarter, largest positions first.
Example: GET https://api.financial.md/v1/ownership/institutional/holdings?holder=cik:1067983&period=2026-06-30&limit=20
| Parameter | In | Description |
|---|---|---|
holder (required) | query | The manager's SEC CIK |
period | query | Calendar quarter end the holdings are reported for |
as_of | query | Point in time: a date (YYYY-MM-DD, end of day UTC) or ISO timestamp. Answers what was known then. |
limit | query | Maximum positions |
cursor | query | Opaque cursor from meta.next_cursor |
curl "https://api.financial.md/v1/ownership/institutional/holdings?holder=cik:1067983&period=2026-06-30&limit=20"GET /v1/company/stock_prices
Daily bars built from trades at IEX only. This is not the consolidated tape and the close is not the official close. adjust=splits adds split-adjusted values; adjust=total_return adds dividend-reinvested values.
Example: GET https://api.financial.md/v1/company/stock_prices?company=ticker:AAPL&from=2026-10-01&to=2026-10-31
| Parameter | In | Description |
|---|---|---|
company (required) | query | Company as fmd_<id>, cik:<number>, ticker:<symbol>[.<mic>] or lei:<LEI>; a bare symbol means ticker, bare digits mean cik. A filer outside the SEC (an EU or UK issuer) has no CIK: use its LEI or fmd_id from /v1/companies |
ticker | query | One of the company's listings; default is the ticker named in company, else the primary listing with bars |
from | query | First session, inclusive |
to | query | Last session, inclusive |
as_of | query | Point in time: a date (YYYY-MM-DD, end of day UTC) or ISO timestamp. Answers what was known then. |
limit | query | Maximum sessions |
cursor | query | Opaque cursor from meta.next_cursor |
adjust | query | splits: each bar also carries split_adjusted values (confirmed splits after the session only); total_return: also total_return values (split-adjusted times the dividend factors of every ex-date after the session) |
curl "https://api.financial.md/v1/company/stock_prices?company=ticker:AAPL&from=2026-10-01&to=2026-10-31"GET /v1/company/splits
Stock splits as filed in XBRL, each with whether IEX prices confirm it.
Example: GET https://api.financial.md/v1/company/splits?company=ticker:AAPL
| Parameter | In | Description |
|---|---|---|
company (required) | query | Company as fmd_<id>, cik:<number>, ticker:<symbol>[.<mic>] or lei:<LEI>; a bare symbol means ticker, bare digits mean cik. A filer outside the SEC (an EU or UK issuer) has no CIK: use its LEI or fmd_id from /v1/companies |
as_of | query | Point in time: a date (YYYY-MM-DD, end of day UTC) or ISO timestamp. Answers what was known then. |
curl "https://api.financial.md/v1/company/splits?company=ticker:AAPL"GET /v1/company/dividends
Dividends per share declared or paid in each fiscal period, as filed, with proof.
Example: GET https://api.financial.md/v1/company/dividends?company=ticker:AAPL&limit=8
| Parameter | In | Description |
|---|---|---|
company (required) | query | Company as fmd_<id>, cik:<number>, ticker:<symbol>[.<mic>] or lei:<LEI>; a bare symbol means ticker, bare digits mean cik. A filer outside the SEC (an EU or UK issuer) has no CIK: use its LEI or fmd_id from /v1/companies |
kind | query | Only declared or only paid |
as_of | query | Point in time: a date (YYYY-MM-DD, end of day UTC) or ISO timestamp. Answers what was known then. |
limit | query | Maximum periods |
curl "https://api.financial.md/v1/company/dividends?company=ticker:AAPL&limit=8"GET /v1/events_calendar
Earnings releases (8-K Item 2.02 filed) and model-expected report dates, for one company or for every company in a date range.
Example: GET https://api.financial.md/v1/events_calendar?company=ticker:AAPL
| Parameter | In | Description |
|---|---|---|
company | query | Optional: one company |
from | query | First date, inclusive |
to | query | Last date, inclusive |
confidence | query | confirmed: 8-K Item 2.02 filed; predicted: cadence model |
as_of | query | Point in time: a date (YYYY-MM-DD, end of day UTC) or ISO timestamp. Answers what was known then. |
limit | query | Maximum events |
cursor | query | Opaque cursor from meta.next_cursor |
curl "https://api.financial.md/v1/events_calendar?company=ticker:AAPL"GET /v1/company/events
A company's 8-K filings with the items they report (earnings, leadership changes, agreements and others), newest first.
Example: GET https://api.financial.md/v1/company/events?company=ticker:AAPL&limit=10
| Parameter | In | Description |
|---|---|---|
company (required) | query | Company as fmd_<id>, cik:<number>, ticker:<symbol>[.<mic>] or lei:<LEI>; a bare symbol means ticker, bare digits mean cik. A filer outside the SEC (an EU or UK issuer) has no CIK: use its LEI or fmd_id from /v1/companies |
event_type | query | Only items of this type |
importance_min | query | Only filings whose highest item is at least this important |
as_of | query | Point in time: a date (YYYY-MM-DD, end of day UTC) or ISO timestamp. Answers what was known then. |
limit | query | Maximum items |
cursor | query | Opaque cursor from meta.next_cursor |
curl "https://api.financial.md/v1/company/events?company=ticker:AAPL&limit=10"GET /v1/news
8-K filings across every company, newest first, each with its items, event types, a headline and an importance from 1 to 5 (FinancialMD's rule by item number). importance_min=4 gives the top stories: earnings, M&A, impairments, auditor changes, restatements, bankruptcies. Built from EDGAR, not wire news.
Example: GET https://api.financial.md/v1/news?importance_min=4&limit=20
| Parameter | In | Description |
|---|---|---|
company | query | Optional: one company |
event_type | query | Only filings with an item of this type |
importance_min | query | Only filings whose highest item is at least this important (FinancialMD's rule by 8-K item; see note) |
from | query | Accepted on or after this date (UTC) |
to | query | Accepted on or before this date (UTC) |
as_of | query | Point in time: a date (YYYY-MM-DD, end of day UTC) or ISO timestamp. Answers what was known then. |
limit | query | Maximum filings |
cursor | query | Opaque cursor from meta.next_cursor |
curl "https://api.financial.md/v1/news?importance_min=4&limit=20"GET /v1/news/feed
FinancialMD's own event feed, built only from SEC filings as EDGAR accepts them: 8-K and 6-K, Schedule 13D and 13G, Rule 425, NT 10-K and NT 10-Q, S-1, and clusters of insider purchases. Each event has a type, an importance from 1 to 5 with the rule that set it, a headline made by rule from the filing's own facts (labelled, never a wire headline), key numbers with the passage they come from, and the filing link. Amendments fold under the original unless amendments=all. form takes one form or several separated by commas. Only companies of the company universe are in the feed; a registrant that has not listed yet is on /v1/pre_ipo.
Example: GET https://api.financial.md/v1/news/feed?importance_min=4&limit=20
| Parameter | In | Description |
|---|---|---|
company | query | Optional: one company |
event_type | query | Only events of this type |
importance_min | query | Only events at least this important (FinancialMD's rule; see note) |
form | query | Only events from this form, or from any of up to 12 forms separated by commas. Amendments are always included, so S-1 and S-1/A ask for the same events. The feed holds events of companies in the company universe only; a registrant that has not listed yet is on GET /v1/pre_ipo |
amendments | query | collapse folds an amendment under its original (amended_by); all shows every filing |
from | query | Accepted on or after this date (UTC) |
to | query | Accepted on or before this date (UTC) |
as_of | query | Point in time: a date (YYYY-MM-DD, end of day UTC) or ISO timestamp. Answers what was known then. |
limit | query | Maximum events |
cursor | query | Opaque cursor from meta.next_cursor |
curl "https://api.financial.md/v1/news/feed?importance_min=4&limit=20"GET /v1/news/issuer_releases
Releases issuers publish about themselves, newest first: press and earnings releases filed as SEC exhibits (text readable as passages), and the headline, link and time from issuers' own feeds (no article body stored). No wire or publisher content.
Example: GET https://api.financial.md/v1/news/issuer_releases?company=ticker:AAPL&limit=10
| Parameter | In | Description |
|---|---|---|
company | query | Optional: one company |
source | query | edgar: exhibits filed with the SEC. issuer_site: headline and link from the issuer's own feed |
from | query | Published on or after this date (UTC) |
to | query | Published on or before this date (UTC) |
as_of | query | Point in time: a date (YYYY-MM-DD, end of day UTC) or ISO timestamp. Answers what was known then. |
limit | query | Maximum releases |
cursor | query | Opaque cursor from meta.next_cursor |
curl "https://api.financial.md/v1/news/issuer_releases?company=ticker:AAPL&limit=10"GET /v1/company/call_materials
What a company itself filed with the SEC around its earnings calls: earnings releases, prepared remarks, shareholder letters, presentations and any transcript the issuer chose to file. Each document has its kind, period, whether it has a Q&A section, and a link. Not a complete transcript archive: most issuers do not file call transcripts.
Example: GET https://api.financial.md/v1/company/call_materials?company=ticker:AAPL&limit=10
| Parameter | In | Description |
|---|---|---|
company (required) | query | Company as fmd_<id>, cik:<number>, ticker:<symbol>[.<mic>] or lei:<LEI>; a bare symbol means ticker, bare digits mean cik. A filer outside the SEC (an EU or UK issuer) has no CIK: use its LEI or fmd_id from /v1/companies |
kind | query | Only documents of this kind |
from | query | Accepted on or after this date (UTC) |
to | query | Accepted on or before this date (UTC) |
as_of | query | Point in time: a date (YYYY-MM-DD, end of day UTC) or ISO timestamp. Answers what was known then. |
limit | query | Maximum documents |
cursor | query | Opaque cursor from meta.next_cursor |
curl "https://api.financial.md/v1/company/call_materials?company=ticker:AAPL&limit=10"GET /v1/call_material/{id}
One issuer-filed document as ordered passages: section (prepared remarks, Q&A, safe harbor), speaker, role, topic tags and character offsets. Filter by section, speaker or topic (topic=guidance finds the passages that talk about outlook). Text is null when the filed document carries another party's copyright notice; the link still works.
Example: GET https://api.financial.md/v1/call_material/doc_1?topic=guidance
| Parameter | In | Description |
|---|---|---|
id (required) | path | Document id from /v1/company/call_materials or /v1/news/issuer_releases |
section | query | Only passages of this section |
speaker | query | Only passages whose speaker name contains this text |
topic | query | Only passages tagged with this topic |
as_of | query | Point in time: a date (YYYY-MM-DD, end of day UTC) or ISO timestamp. Answers what was known then. |
limit | query | Maximum passages |
cursor | query | Opaque cursor from meta.next_cursor |
curl "https://api.financial.md/v1/call_material/doc_1?topic=guidance"GET /v1/calls_calendar
Conference calls as issuers announce them in their own SEC filings: date, time as stated, fiscal period, and the issuer's own webcast page. Link and metadata only; no audio and no transcript.
Example: GET https://api.financial.md/v1/calls_calendar?company=ticker:AAPL
| Parameter | In | Description |
|---|---|---|
company | query | Optional: one company |
from | query | Calls on or after this date (default: a week before as_of) |
to | query | Calls on or before this date (default: 97 days after from) |
as_of | query | Point in time: a date (YYYY-MM-DD, end of day UTC) or ISO timestamp. Answers what was known then. |
limit | query | Maximum calls |
cursor | query | Opaque cursor from meta.next_cursor |
curl "https://api.financial.md/v1/calls_calendar?company=ticker:AAPL"GET /v1/politician_trades
Stock and other securities trades that members of the U.S. House reported in periodic transaction reports (PTRs), newest filing first. Each row carries the filer's own words under as_filed (owner, asset, type, dates, amount range), the official report at source_url with its retrieval time, and FinancialMD's own additions under financialmd (the matched company and a confidence). Handwritten reports are listed with parse_status unparsed and the link only, never guessed. The company filter matches high and medium confidence only. Every answer carries data.notice: 5 U.S.C. 13107(c)(1) limits your use of this data (no commercial use other than news media informing the public, no credit rating, no solicitation). This route is never priced. Senate reports are not loaded.
Example: GET https://api.financial.md/v1/politician_trades?company=ticker:NVDA&type=purchase&from=2026-01-01&limit=20
| Parameter | In | Description |
|---|---|---|
company | query | Optional: only trades FinancialMD matched to this company with high or medium confidence |
member | query | A member key from an earlier answer, or part of the filer's name |
chamber | query | Only this chamber (Senate reports are not loaded) |
type | query | Only this transaction type (sale also matches sale_partial) |
from | query | Transaction date on or after this date; with date_field=filing, the filing date |
to | query | Transaction date on or before this date; with date_field=filing, the filing date |
date_field | query | Which date from and to apply to |
include_unparsed | query | Also list reports that could not be read (handwritten scans) as link-only entries in data.unparsed_filings |
as_of | query | Point in time: a date (YYYY-MM-DD, end of day UTC) or ISO timestamp. Answers what was known then. |
limit | query | Maximum transactions |
cursor | query | Opaque cursor from meta.next_cursor |
curl "https://api.financial.md/v1/politician_trades?company=ticker:NVDA&type=purchase&from=2026-01-01&limit=20"GET /v1/search/filings
Find the EDGAR documents (filings and exhibits since 2001) that contain words or a quoted phrase, through SEC EDGAR full-text search. Each hit names its filing, form, date and companies with FinancialMD ids, and links the document.
Example: GET https://api.financial.md/v1/search/filings?q=%22going%20concern%22&forms=10-K&limit=10
| Parameter | In | Description |
|---|---|---|
q (required) | query | Words to find; a phrase in double quotes matches exactly |
forms | query | Comma-separated form types |
company | query | Optional: only this company's documents |
from | query | Filed on or after |
to | query | Filed on or before |
page | query | Page number, 1-based |
limit | query | Maximum documents per page |
curl "https://api.financial.md/v1/search/filings?q=%22going%20concern%22&forms=10-K&limit=10"GET /v1/coverage
Which datasets FinancialMD serves and which it does not (licensed, not built, or waiting on a decision), with the routes, MCP tools, reason and alternatives for each. Read it before looking for consensus estimates, transcripts or real-time prices.
Example: GET https://api.financial.md/v1/coverage?status=conceded
| Parameter | In | Description |
|---|---|---|
status | query | Only datasets with this status |
curl "https://api.financial.md/v1/coverage?status=conceded"GET /v1/company/segments
As-reported segment facts: revenue and other lines by business segment, geography or product.
Example: GET https://api.financial.md/v1/company/segments?company=ticker:AAPL&kind=geography
| Parameter | In | Description |
|---|---|---|
company (required) | query | Company as fmd_<id>, cik:<number>, ticker:<symbol>[.<mic>] or lei:<LEI>; a bare symbol means ticker, bare digits mean cik. A filer outside the SEC (an EU or UK issuer) has no CIK: use its LEI or fmd_id from /v1/companies |
period_type | query | Annual (four quarters) or quarterly facts |
kind | query | Segment axis kind |
tag | query | Only this XBRL tag |
limit | query | Maximum period ends |
as_of | query | Point in time: a date (YYYY-MM-DD, end of day UTC) or ISO timestamp. Answers what was known then. |
curl "https://api.financial.md/v1/company/segments?company=ticker:AAPL&kind=geography"GET /v1/company/line_items
Find one line of a company's own reporting by its label and period, without knowing the XBRL tag: detail lines below the standardized statements (interest expense, capital expenditures, deferred revenue), segment and geographic figures, company-defined metrics and guidance. Give q (the label) and period_end, or fiscal_year with fiscal_period. Each item carries its dataset, a match score and a value with a proof.
Example: GET https://api.financial.md/v1/company/line_items?company=ticker:AAPL&q=interest%20expense&period_end=2024-09-28&period_type=annual
| Parameter | In | Description |
|---|---|---|
company (required) | query | Company as fmd_<id>, cik:<number>, ticker:<symbol>[.<mic>] or lei:<LEI>; a bare symbol means ticker, bare digits mean cik. A filer outside the SEC (an EU or UK issuer) has no CIK: use its LEI or fmd_id from /v1/companies |
q (required) | query | The line's label as a report prints it. Every word must be in the line's name |
period_end | query | Period end; a line within six days of it matches (52/53-week years). Omit for each line's latest period |
fiscal_year | query | Fiscal year, resolved to a period end through the company's own reports. Not with period_end |
fiscal_period | query | Fiscal period of fiscal_year |
period_type | query | Length of duration figures. Default: annual for FY, quarterly for a fiscal quarter, any otherwise |
dataset | query | Comma-separated: as_reported, segment, kpi, guidance. Default: all four |
original | query | as_reported only: the first filing's figure instead of the newest filing's |
as_of | query | Point in time: a date (YYYY-MM-DD, end of day UTC) or ISO timestamp. Answers what was known then. |
limit | query | Maximum lines, best match first |
curl "https://api.financial.md/v1/company/line_items?company=ticker:AAPL&q=interest%20expense&period_end=2024-09-28&period_type=annual"GET /v1/screen/nl
Screen every covered company from a plain-language question. The question is parsed into GET /v1/screen parameters by an AI model, or by fixed rules when no model is configured; generated_by and label say which. Only the filters come from the parser: results are computed from filings by the same code as GET /v1/screen, and every value carries its proof. parsed and equivalent_request show the filters used, and unparsed lists what was not understood.
Example: GET https://api.financial.md/v1/screen/nl?q=technology%20companies%20with%20gross%20margin%20above%2040%25%20and%20revenue%20over%201%20billion&limit=20
| Parameter | In | Description |
|---|---|---|
q (required) | query | The screen in plain English: a sector or an industry, and metrics with bounds. No links |
limit | query | Maximum companies |
curl "https://api.financial.md/v1/screen/nl?q=technology%20companies%20with%20gross%20margin%20above%2040%25%20and%20revenue%20over%201%20billion&limit=20"GET /v1/ask
An AI-written answer to one question about one company, from its own filed values: statements, ratios, guidance, company metrics, segments and recent 8-K events. The model sees only a numbered list of those facts. The server checks that every number in the answer matches a fact it cites and withholds the answer otherwise (answer null, withheld_reason, related_facts). citations carries each cited value with its proof. It restates filed values; it does not compute, forecast or advise, and an answer with words of advice is withheld. Needs an API key or a signed-in connector token (an account without a plan has a daily allowance); keyless callers get 401.
Example: GET https://api.financial.md/v1/ask?company=ticker:AAPL&q=What%20was%20revenue%20and%20gross%20margin%20in%20the%20latest%20year%3F
| Parameter | In | Description |
|---|---|---|
company (required) | query | Company as fmd_<id>, cik:<number>, ticker:<symbol>[.<mic>] or lei:<LEI>; a bare symbol means ticker, bare digits mean cik. A filer outside the SEC (an EU or UK issuer) has no CIK: use its LEI or fmd_id from /v1/companies |
q (required) | query | One question about the company, in plain English. No links |
as_of | query | Point in time: a date (YYYY-MM-DD, end of day UTC) or ISO timestamp. Answers what was known then. |
curl "https://api.financial.md/v1/ask?company=ticker:AAPL&q=What%20was%20revenue%20and%20gross%20margin%20in%20the%20latest%20year%3F"GET /v1/news/summary
An AI-written summary of filing-based news: market-wide for one UTC day (the most important filings of the day), or one company's events of the last 30 days. The model sees only numbered items of FinancialMD's own event feed (SEC filings, rule-made headlines and key numbers quoted from the filing). Each bullet cites its items, and the server drops a bullet with a number no cited item carries or with advice words; the summary is withheld when too many are dropped. Labelled ai_generated with the model. It does not forecast or advise.
Example: GET https://api.financial.md/v1/news/summary?date=2026-11-12
| Parameter | In | Description |
|---|---|---|
company | query | One company: its events of the 30 days to date. Without it, the summary is market-wide: the most important filings of date |
date | query | The UTC day (YYYY-MM-DD), within the last 7 days. Default: the latest day with filings (market-wide) or today (one company). Older days: GET /v1/news/feed |
as_of | query | Point in time: a date (YYYY-MM-DD, end of day UTC) or ISO timestamp. Answers what was known then. |
curl "https://api.financial.md/v1/news/summary?date=2026-11-12"GET /v1/company/ownership/insider_holders
What each insider owned after their latest Form 4 or 5 transaction.
Example: GET https://api.financial.md/v1/company/ownership/insider_holders?company=ticker:AAPL
| Parameter | In | Description |
|---|---|---|
company (required) | query | Company as fmd_<id>, cik:<number>, ticker:<symbol>[.<mic>] or lei:<LEI>; a bare symbol means ticker, bare digits mean cik. A filer outside the SEC (an EU or UK issuer) has no CIK: use its LEI or fmd_id from /v1/companies |
as_of | query | Point in time: a date (YYYY-MM-DD, end of day UTC) or ISO timestamp. Answers what was known then. |
limit | query | Maximum holders |
curl "https://api.financial.md/v1/company/ownership/insider_holders?company=ticker:AAPL"GET /v1/company/ownership/funds
Funds holding the company in their latest Form N-PORT, with shares and value.
Example: GET https://api.financial.md/v1/company/ownership/funds?company=ticker:AAPL&limit=20
| Parameter | In | Description |
|---|---|---|
company (required) | query | Company as fmd_<id>, cik:<number>, ticker:<symbol>[.<mic>] or lei:<LEI>; a bare symbol means ticker, bare digits mean cik. A filer outside the SEC (an EU or UK issuer) has no CIK: use its LEI or fmd_id from /v1/companies |
period | query | Report period window ending on or before this date (default: the newest) |
as_of | query | Point in time: a date (YYYY-MM-DD, end of day UTC) or ISO timestamp. Answers what was known then. |
limit | query | Maximum funds |
cursor | query | Opaque cursor from meta.next_cursor |
curl "https://api.financial.md/v1/company/ownership/funds?company=ticker:AAPL&limit=20"GET /v1/funds
List or search Form N-PORT funds by name or series id. kind keeps one kind (etf, mutual_fund, closed_end, money_market), sort orders by net_assets or name. Each item has its kind, its net assets with the report date, and a series id to pass to /v1/fund/holdings and /v1/fund/profile.
Example: GET https://api.financial.md/v1/funds?kind=etf&sort=net_assets&limit=20
| Parameter | In | Description |
|---|---|---|
q | query | Fund or registrant name, or a series id |
kind | query | Only funds of this kind, from the registrant's latest Form N-CEN: etf, mutual_fund (open-end, not exchange-traded), closed_end (interval funds included) or money_market. A fund whose kind is not known matches no kind |
sort | query | Order by net assets of the latest report (funds without a report last) or by name |
order | query | Direction; default desc for net_assets and asc for name |
as_of | query | Point in time: a date (YYYY-MM-DD, end of day UTC) or ISO timestamp. Answers what was known then. |
limit | query | Maximum funds |
cursor | query | Opaque cursor from meta.next_cursor |
curl "https://api.financial.md/v1/funds?kind=etf&sort=net_assets&limit=20"GET /v1/fund/holdings
One fund's Form N-PORT holdings for a report period, largest first.
Example: GET https://api.financial.md/v1/fund/holdings?fund=S000002839&limit=20
| Parameter | In | Description |
|---|---|---|
fund (required) | query | SEC series id |
period | query | Report period (month end); default the newest |
as_of | query | Point in time: a date (YYYY-MM-DD, end of day UTC) or ISO timestamp. Answers what was known then. |
limit | query | Maximum holdings |
cursor | query | Opaque cursor from meta.next_cursor |
curl "https://api.financial.md/v1/fund/holdings?fund=S000002839&limit=20"GET /v1/company/kpis
Company-reported metrics read from earnings releases and reports: adjusted (non-GAAP) measures and operating statistics such as product-line sales. Each value carries its exact citation and a confidence.
Example: GET https://api.financial.md/v1/company/kpis?company=ticker:AAPL&kind=operating&limit=20
| Parameter | In | Description |
|---|---|---|
company (required) | query | Company as fmd_<id>, cik:<number>, ticker:<symbol>[.<mic>] or lei:<LEI>; a bare symbol means ticker, bare digits mean cik. A filer outside the SEC (an EU or UK issuer) has no CIK: use its LEI or fmd_id from /v1/companies |
metric | query | Only this metric slug (data.metrics lists the company's) |
kind | query | adjusted: non-GAAP measures under the company's own definition; operating: operating statistics |
period_type | query | Only this period type |
from | query | First period end, inclusive |
to | query | Last period end, inclusive |
as_of | query | Point in time: a date (YYYY-MM-DD, end of day UTC) or ISO timestamp. Answers what was known then. |
limit | query | Maximum values |
cursor | query | Opaque cursor from meta.next_cursor |
curl "https://api.financial.md/v1/company/kpis?company=ticker:AAPL&kind=operating&limit=20"GET /v1/company/dividend_events
Cash dividends with declaration, record, ex and pay dates as the company's filings state them. When a filing states a record date but no ex-date, the ex-date is derived by the settlement rule and labelled ex_date_method: settlement_rule. With no record date there is no ex-date.
Example: GET https://api.financial.md/v1/company/dividend_events?company=ticker:AAPL&limit=8
| Parameter | In | Description |
|---|---|---|
company (required) | query | Company as fmd_<id>, cik:<number>, ticker:<symbol>[.<mic>] or lei:<LEI>; a bare symbol means ticker, bare digits mean cik. A filer outside the SEC (an EU or UK issuer) has no CIK: use its LEI or fmd_id from /v1/companies |
from | query | First date, inclusive |
to | query | Last date, inclusive |
as_of | query | Point in time: a date (YYYY-MM-DD, end of day UTC) or ISO timestamp. Answers what was known then. |
limit | query | Maximum dividends |
curl "https://api.financial.md/v1/company/dividend_events?company=ticker:AAPL&limit=8"GET /v1/company/ownership/insider_holdings
Holding lines of Forms 3, 4 and 5 as filed.
Example: GET https://api.financial.md/v1/company/ownership/insider_holdings?company=ticker:AAPL&limit=20
| Parameter | In | Description |
|---|---|---|
company (required) | query | Company as fmd_<id>, cik:<number>, ticker:<symbol>[.<mic>] or lei:<LEI>; a bare symbol means ticker, bare digits mean cik. A filer outside the SEC (an EU or UK issuer) has no CIK: use its LEI or fmd_id from /v1/companies |
form | query | Only lines of this form |
as_of | query | Point in time: a date (YYYY-MM-DD, end of day UTC) or ISO timestamp. Answers what was known then. |
limit | query | Maximum lines |
curl "https://api.financial.md/v1/company/ownership/insider_holdings?company=ticker:AAPL&limit=20"GET /v1/fund/profile
A fund's type (ETF, index fund and others) from Form N-CEN and each share class's prospectus fees and expense ratio. Accepts a series id or a share-class ticker.
Example: GET https://api.financial.md/v1/fund/profile?fund=VOO
| Parameter | In | Description |
|---|---|---|
fund (required) | query | Series id or share-class ticker |
as_of | query | Point in time: a date (YYYY-MM-DD, end of day UTC) or ISO timestamp. Answers what was known then. |
curl "https://api.financial.md/v1/fund/profile?fund=VOO"GET /v1/company/identifiers
CIK, LEI and FIGI of a company with the evidence for each.
Example: GET https://api.financial.md/v1/company/identifiers?company=ticker:AAPL
| Parameter | In | Description |
|---|---|---|
company (required) | query | Company as fmd_<id>, cik:<number>, ticker:<symbol>[.<mic>] or lei:<LEI>; a bare symbol means ticker, bare digits mean cik. A filer outside the SEC (an EU or UK issuer) has no CIK: use its LEI or fmd_id from /v1/companies |
as_of | query | Point in time: a date (YYYY-MM-DD, end of day UTC) or ISO timestamp. Answers what was known then. |
curl "https://api.financial.md/v1/company/identifiers?company=ticker:AAPL"GET /v1/identifiers/xref
Cross-reference one identifier to the others we lawfully hold: FMD id, CIK, tickers, LEI, FIGI, and for funds the series and class ids. Each identifier names its source and licence. A CUSIP or ISIN you already hold can be looked up; the answer names the SEC filing that reported it. We hold no licensed identifier master and never generate identifiers.
Example: GET https://api.financial.md/v1/identifiers/xref?id=BBG000B9XRY4
| Parameter | In | Description |
|---|---|---|
id (required) | query | The identifier you hold |
kind | query | What the identifier is; left out, it is detected from its shape |
as_of | query | Point in time: a date (YYYY-MM-DD, end of day UTC) or ISO timestamp. Answers what was known then. |
curl "https://api.financial.md/v1/identifiers/xref?id=BBG000B9XRY4"GET /v1/identifiers/master
Every covered company with its open identifiers (FMD id, CIK, tickers and exchanges, LEI, FIGI), paged. Contains no licensed identifiers.
Example: GET https://api.financial.md/v1/identifiers/master?limit=100
| Parameter | In | Description |
|---|---|---|
limit | query | Maximum companies |
cursor | query | Opaque cursor from meta.next_cursor |
as_of | query | Point in time: a date (YYYY-MM-DD, end of day UTC) or ISO timestamp. Answers what was known then. |
curl "https://api.financial.md/v1/identifiers/master?limit=100"GET /v1/fund/nav
What SEC filings say about a fund's value: series net assets at reported month ends and each class's monthly total return (Form N-PORT), a total return index we compute from those returns, and for closed-end funds the NAV and market price per share at fiscal year end (Form N-CEN). Not a daily NAV feed: filings carry none. A market price, where shown, is one venue's close and is labelled as not NAV.
Example: GET https://api.financial.md/v1/fund/nav?fund=VOO
| Parameter | In | Description |
|---|---|---|
fund (required) | query | Series id or share-class ticker |
class | query | Only this share class (class id or ticker) |
from | query | First month end |
to | query | Last month end |
as_of | query | Point in time: a date (YYYY-MM-DD, end of day UTC) or ISO timestamp. Answers what was known then. |
limit | query | Maximum months per class |
curl "https://api.financial.md/v1/fund/nav?fund=VOO"GET /v1/company/ratios/forward
Forward valuation ratios built on FinancialMD's own model-based estimates: forward_pe, forward_ps, forward_ev_ebit, forward_earnings_yield and forward_fcf_yield for the next one or two fiscal years. The numerator is the market capitalisation or enterprise value of the newest session held (one venue's close times filed shares). Every item says generated_by model, names the method, and carries the estimate, its interval and its track record. Not consensus and not an analyst figure. 404 not_found when no estimate or no price basis is held.
Example: GET https://api.financial.md/v1/company/ratios/forward?company=ticker:AAPL
| Parameter | In | Description |
|---|---|---|
company (required) | query | Company as fmd_<id>, cik:<number>, ticker:<symbol>[.<mic>] or lei:<LEI>; a bare symbol means ticker, bare digits mean cik. A filer outside the SEC (an EU or UK issuer) has no CIK: use its LEI or fmd_id from /v1/companies |
ticker | query | One of the company's listings |
as_of | query | Point in time: a date (YYYY-MM-DD, end of day UTC) or ISO timestamp. Answers what was known then. |
curl "https://api.financial.md/v1/company/ratios/forward?company=ticker:AAPL"GET /v1/company/technicals
Technical indicators of a listing, computed by us from split-adjusted daily closes of one venue: simple and exponential moving averages, RSI, MACD, Bollinger bands, average true range and the close range. indicators= takes ids such as sma_50, ema_20, rsi_14, macd, bollinger_20, atr_14, range_252 (period 2 to 400). data.latest holds the newest session as value objects with proofs; data.items is the series, newest first. End of day, one venue, not the consolidated tape; descriptive statistics, not signals or advice.
Example: GET https://api.financial.md/v1/company/technicals?company=ticker:AAPL&indicators=sma_50,sma_200,rsi_14,macd
| Parameter | In | Description |
|---|---|---|
company (required) | query | Company as fmd_<id>, cik:<number>, ticker:<symbol>[.<mic>] or lei:<LEI>; a bare symbol means ticker, bare digits mean cik. A filer outside the SEC (an EU or UK issuer) has no CIK: use its LEI or fmd_id from /v1/companies |
ticker | query | One of the company's listings |
indicators | query | Comma-separated indicator ids, at most 12: sma_<n>, ema_<n>, rsi_<n>, macd (12, 26, 9), bollinger_<n>, atr_<n>, range_<n>; n is 2 to 400. Default: sma_20, sma_50, sma_200, ema_12, ema_26, rsi_14, macd, bollinger_20 |
from | query | Oldest session to return |
to | query | Compute up to the last session on or before this day |
as_of | query | Point in time: a date (YYYY-MM-DD, end of day UTC) or ISO timestamp. Answers what was known then. |
limit | query | Maximum sessions per page (newest first) |
cursor | query | Opaque cursor from meta.next_cursor |
curl "https://api.financial.md/v1/company/technicals?company=ticker:AAPL&indicators=sma_50,sma_200,rsi_14,macd"GET /v1/company/stock_prices/returns
Price return, total return, annualised return and maximum drawdown over trailing windows, computed by us from single-venue daily closes and the splits and dividends in SEC filings. End of day, one venue, not the consolidated tape.
Example: GET https://api.financial.md/v1/company/stock_prices/returns?company=ticker:AAPL&windows=1m,1y,5y
| Parameter | In | Description |
|---|---|---|
company (required) | query | Company as fmd_<id>, cik:<number>, ticker:<symbol>[.<mic>] or lei:<LEI>; a bare symbol means ticker, bare digits mean cik. A filer outside the SEC (an EU or UK issuer) has no CIK: use its LEI or fmd_id from /v1/companies |
ticker | query | One of the company's listings |
windows | query | Comma-separated windows: 1m, 3m, 6m, ytd, 1y, 3y, 5y, max. Default: all |
to | query | End the windows at the last session on or before this day |
as_of | query | Point in time: a date (YYYY-MM-DD, end of day UTC) or ISO timestamp. Answers what was known then. |
curl "https://api.financial.md/v1/company/stock_prices/returns?company=ticker:AAPL&windows=1m,1y,5y"GET /v1/screen
Screen every covered company on its latest period. filter takes metric:min:max ranges with raw values (0.2 is 20 percent), sort takes metric:desc. Multi-year growth is screened with revenue_cagr_3y, revenue_cagr_5y, revenue_cagr_10y, net_income_cagr_3y and net_income_cagr_5y. Each result carries one value object with proof per metric. Amounts are in each company's reporting currency and are not converted: add country= (for example country=SE) to compare within one market.
Example: GET https://api.financial.md/v1/screen?filter=net_margin:0.2:,income_statement_total_revenues:10000000000:&sort=net_margin:desc&limit=20
| Parameter | In | Description |
|---|---|---|
status | query | Listing status of the companies screened: active (default), delisted, inactive or all |
metrics | query | Comma-separated columns: concept ids (GET /v1/company/metrics) or ratio ids. Up to 12. Multi-year growth ids are revenue_cagr_3y, revenue_cagr_5y, revenue_cagr_10y, net_income_cagr_3y and net_income_cagr_5y: compound annual growth between the latest annual figure and the annual figure that many years earlier, matched by year; null when that year is missing or the start is not positive, and for net income when either end is not positive. Defaults to revenue, net income, the three margins, revenue growth and return on equity. |
filter | query | Comma-separated range filters metric:min:max; either bound may be empty. Values are raw: 0.1 is 10 percent, amounts are in the reporting currency. A company without a value for a filtered metric does not match. |
sort | query | <metric|name|ticker>[:asc|:desc]; companies without a value sort last. Default name:asc. |
period_type | query | The period type whose latest period is screened |
q | query | Name or ticker search (names as substring, tickers as prefix) |
sector | query | Exact sector (case-insensitive) |
industry | query | Exact industry (case-insensitive) |
template | query | Reporting template |
country | query | ISO 3166-1 alpha-2 |
currency | query | Reporting currency (ISO 4217): only companies that report in it. Amounts in different currencies are never compared, so a sort or filter on a money column without this parameter screens the currency most companies of the screen report in (USD across the whole universe), and data.currency says so. |
include_stale | query | Keep companies whose latest period ended more than data.stale_after_days before as_of. They are left out by default; each item carries stale. |
as_of | query | Point in time: a date (YYYY-MM-DD, end of day UTC) or ISO timestamp. Answers what was known then. |
limit | query | Maximum companies per page |
cursor | query | Opaque cursor from meta.next_cursor |
curl "https://api.financial.md/v1/screen?filter=net_margin:0.2:,income_statement_total_revenues:10000000000:&sort=net_margin:desc&limit=20"GET /v1/company/estimates
FinancialMD's own model-based baseline estimates for the next four quarters and two fiscal years (revenue, operating income, net income, diluted EPS, free cash flow), each with an 80 percent prediction interval, every component of the method, the facts it read and the method's measured errors. Also the company's own guidance as stated in its filings with the exact sentence, and descriptive signals. Computed only from SEC filings by the published method in docs/estimates.md. Not consensus, not analyst or Street estimates, not investment advice. When the company has no estimate in force and no guidance at as_of the answer is 404 not_found (error.details.reason no_estimates_or_guidance) and is not charged.
Example: GET https://api.financial.md/v1/company/estimates?company=ticker:AAPL&metric=revenue
| Parameter | In | Description |
|---|---|---|
company (required) | query | Company as fmd_<id>, cik:<number>, ticker:<symbol>[.<mic>] or lei:<LEI>; a bare symbol means ticker, bare digits mean cik. A filer outside the SEC (an EU or UK issuer) has no CIK: use its LEI or fmd_id from /v1/companies |
metric | query | Only this estimated line (default all five) |
period_type | query | Only quarters or only fiscal years |
as_of | query | Point in time: a date (YYYY-MM-DD, end of day UTC) or ISO timestamp. Answers what was known then. |
curl "https://api.financial.md/v1/company/estimates?company=ticker:AAPL&metric=revenue"GET /v1/company/estimates/consensus
Always 404 not_covered: consensus estimates are licensed data FinancialMD does not carry. error.details names the reason and what to use instead (our own model-based estimates are at /v1/company/estimates); do not retry.
Example: GET https://api.financial.md/v1/company/estimates/consensus?company=ticker:AAPL
curl "https://api.financial.md/v1/company/estimates/consensus?company=ticker:AAPL"GET /v1/company/analyst_ratings
Always 404 not_covered: analyst ratings and price targets are licensed. error.details names the reason and what to use instead; do not retry.
Example: GET https://api.financial.md/v1/company/analyst_ratings?company=ticker:AAPL
curl "https://api.financial.md/v1/company/analyst_ratings?company=ticker:AAPL"GET /v1/company/transcripts
Always 404 not_covered: call transcripts and audio are licensed. error.details names the reason and what to use instead; do not retry.
Example: GET https://api.financial.md/v1/company/transcripts?company=ticker:AAPL
curl "https://api.financial.md/v1/company/transcripts?company=ticker:AAPL"GET /v1/company/stock_prices/intraday
Always 404 not_covered: real-time and intraday prices are licensed; daily IEX bars are at /v1/company/stock_prices. error.details names the reason and what to use instead; do not retry.
Example: GET https://api.financial.md/v1/company/stock_prices/intraday?company=ticker:AAPL
curl "https://api.financial.md/v1/company/stock_prices/intraday?company=ticker:AAPL"GET /v1/company/logo
An image that identifies a company. kind is wikimedia_commons (a logo file from Wikimedia Commons, taken only when the company matched a Wikidata item with confidence and the file is public domain or under a verified open licence; source carries the file page, author, licence and retrieval time, and attribution must be shown where the licence asks) or generated (a monogram tile drawn from the ticker, never an imitation of the real mark). format=svg or format=png with size returns the image itself. Logos are trademarks of their owners and are served for identification only; no endorsement is implied.
Example: GET https://api.financial.md/v1/company/logo?company=ticker:AAPL
| Parameter | In | Description |
|---|---|---|
company (required) | query | Company as fmd_<id>, cik:<number>, ticker:<symbol>[.<mic>] or lei:<LEI>; a bare symbol means ticker, bare digits mean cik. A filer outside the SEC (an EU or UK issuer) has no CIK: use its LEI or fmd_id from /v1/companies |
format | query | json: the description with links, licence and attribution; svg or png: the image itself |
size | query | Longest side of the PNG in pixels (format=png only) |
curl "https://api.financial.md/v1/company/logo?company=ticker:AAPL"GET /v1/pre_ipo
Companies that have filed to go public, from the SEC's public record: registrants whose first S-1 or F-1 came before any periodic report. Each item has a status set by a fixed rule (filed, effective, priced, listed, withdrawn, stale) with the sentence of the rule, the dates, the proposed ticker and exchange as the prospectus states them, and whether it is a blank check company. Filter by status, form, blank_check, name or proposed ticker (q) and the date of the newest filing. Confidential drafts and Form D raises are not covered. Use it to answer which companies have filed for an IPO.
Example: GET https://api.financial.md/v1/pre_ipo?status=filed,effective&blank_check=false&limit=10
| Parameter | In | Description |
|---|---|---|
q | query | Part of the registrant's name, or its proposed ticker |
status | query | Comma-separated: filed, effective, priced, listed, withdrawn, stale |
form | query | Form of the newest registration statement |
blank_check | query | true = only blank check companies, false = none of them |
from | query | Newest filing on or after this date |
to | query | Newest filing on or before this date |
as_of | query | Point in time: a date (YYYY-MM-DD, end of day UTC) or ISO timestamp. Answers what was known then. |
limit | query | Maximum registrants |
cursor | query | Opaque cursor from meta.next_cursor |
curl "https://api.financial.md/v1/pre_ipo?status=filed,effective&blank_check=false&limit=10"GET /v1/pre_ipo/{cik}
One pre-IPO registrant by SEC CIK: its status and the rule that set it, every filing of the registration (S-1 or F-1, amendments, effectiveness, prospectus, withdrawal), the financial figures the registrant tagged in XBRL (revenue, net income, assets, cash and others, by period) and the offering terms read from the prospectus by fixed rules (shares offered, price range or price, proposed symbol and exchange, underwriters, use of proceeds), each with the sentence read, its position and a confidence. No model is used. A price range is a proposal, not a price.
Example: GET https://api.financial.md/v1/pre_ipo/2137779
| Parameter | In | Description |
|---|---|---|
cik (required) | path | The registrant's SEC CIK, from GET /v1/pre_ipo |
as_of | query | Point in time: a date (YYYY-MM-DD, end of day UTC) or ISO timestamp. Answers what was known then. |
curl "https://api.financial.md/v1/pre_ipo/2137779"GET /v1/fx_rates
Daily reference exchange rates. The only source is the European Central Bank's euro foreign exchange reference rates, a public file set, loaded every working day. base is an ISO 4217 code (default USD); quotes is a comma-separated list of codes (default every currency published that day); date is optional and answers with the latest reference day on or before it, so a weekend or holiday answers with the working day before. rates[X] is units of X for one unit of base. The ECB quotes each currency against the euro, so a rate between two other currencies is computed through the euro from the same day (method cross_rate_through_eur). A currency with no rate on that day is left out of rates and named in not_served. source carries the name, link and attribution line; as_of_note states that these are reference rates set once a day, for information, and not tradable quotes. 400 invalid_request for a code the ECB has never published; 404 not_found (details.reason no_reference_rate, with first_day) when no rate for base exists on or before the date.
Example: GET https://api.financial.md/v1/fx_rates?base=USD"es=EUR,GBP,JPY&date=2026-11-12
| Parameter | In | Description |
|---|---|---|
base | query | ISO 4217 code of the base currency: the euro or a currency the ECB publishes a reference rate for |
quotes | query | Comma-separated ISO 4217 codes to quote; default every currency published on the reference day |
date | query | Answer with the latest reference day on or before this date; default today |
curl "https://api.financial.md/v1/fx_rates?base=USD"es=EUR,GBP,JPY&date=2026-11-12"GET /v1/research
Search DeepValues Research reports, newest first: Deep Value Intelligence company reports, company research notes, investor studies, insights, market memos, the value-investing principles and personal finance notes. Each item gives the id, title, collection, kind, language, date, tickers and companies, the stance a company report states, the report's page on research.deepvalues.ai, the licence and a summary: an extract of the report's own words chosen by rule, never written by a model. Filter by company (a ticker FinancialMD does not cover still matches reports filed under it), collection, kind, language, q (words in the title or summary), from and to. The reports are licensed CC BY 4.0 and readable at no cost on research.deepvalues.ai; GET /v1/research/{id} returns one report's whole text, structured. An empty result is a 200 with a request_data remedy.
Example: GET https://api.financial.md/v1/research?company=AAPL&limit=5
| Parameter | In | Description |
|---|---|---|
company | query | Optional: only reports filed under or tagged with this company. A ticker FinancialMD does not cover still matches the reports filed under it |
collection | query | Only this collection |
kind | query | Only this kind of report (deep_value_intelligence: the multi-analyst company reports) |
language | query | Only reports written in this language |
q | query | Words in the title or the summary (all must appear) |
from | query | Published on or after this date |
to | query | Published on or before this date |
as_of | query | Point in time: a date (YYYY-MM-DD, end of day UTC) or ISO timestamp. Answers what was known then. |
limit | query | Maximum reports |
cursor | query | Opaque cursor from meta.next_cursor |
curl "https://api.financial.md/v1/research?company=AAPL&limit=5"GET /v1/research/{id}
One DeepValues Research report in full: the text as clean Markdown (images and front matter removed), its sections with character offsets into the text, tickers and companies, date and how it was read, the links the report cites, the summary, version (content SHA-256 and the repository commit it was read from), and the licence block with the attribution CC BY 4.0 asks for: credit "DeepValues Research (research.deepvalues.ai)" and link source_url and the licence. The same report is readable at no cost at source_url; this route sells the structured, citable delivery and claims no exclusivity. A withdrawn report (removed from the site) answers 404 with details.reason withdrawn, and an error is never charged.
Example: GET https://api.financial.md/v1/research/dvr_181b78646e4f0de6
| Parameter | In | Description |
|---|---|---|
id (required) | path | Report id from GET /v1/research |
as_of | query | Point in time: a date (YYYY-MM-DD, end of day UTC) or ISO timestamp. Answers what was known then. |
curl "https://api.financial.md/v1/research/dvr_181b78646e4f0de6"GET /proof/{id}
The proof behind any value: the filing, the XBRL tag and dimensions, the source URL and the raw as-reported facts it derives from.
Example: GET https://api.financial.md/proof/p_edt68ehn6cw3ed0
| Parameter | In | Description |
|---|---|---|
id (required) | path | Proof id from any value object |
curl "https://api.financial.md/proof/p_edt68ehn6cw3ed0"POST /v1/verify
Check a number you got elsewhere against what the company filed. Returns verdict (matches, differs or unknown), the filed value with proof, the difference, the tolerance from the filer's precision, and a scale_hint when your number is off by a power of ten.
Example: POST https://api.financial.md/v1/verify with body {"company":"ticker:AAPL","concept":"income_statement_total_revenues","period":"FY2024","value":391035000000}
curl -X POST "https://api.financial.md/v1/verify" -H "content-type: application/json" -d '{"company":"ticker:AAPL","concept":"income_statement_total_revenues","period":"FY2024","value":391035000000}'GET /v1/changes
Standardized facts whose knowledge interval opened since a time: new filings and restatements. Poll it to keep a local copy current.
Example: GET https://api.financial.md/v1/changes?since=2026-11-01T00:00:00Z&company=ticker:AAPL&limit=50
| Parameter | In | Description |
|---|---|---|
since (required) | query | Facts whose knowledge interval opened at or after this instant |
company | query | Company as fmd_<id>, cik:<number>, ticker:<symbol>[.<mic>] or lei:<LEI>; a bare symbol means ticker, bare digits mean cik. A filer outside the SEC (an EU or UK issuer) has no CIK: use its LEI or fmd_id from /v1/companies |
limit | query | Maximum changes |
cursor | query | Opaque cursor from meta.next_cursor |
curl "https://api.financial.md/v1/changes?since=2026-11-01T00:00:00Z&company=ticker:AAPL&limit=50"GET /v1/request-data
How to tell us about data or analysis you needed and did not find: the body POST /v1/request-data takes, the kinds, the limits and how to follow a request.
Example: GET https://api.financial.md/v1/request-data
curl "https://api.financial.md/v1/request-data"POST /v1/request-data
Tell us what you needed and did not find. Keyless, never charged. Similar requests merge into one demand item and count as votes; the answer has request_id, item_id, status and the vote counts. Do not include personal data.
Example: POST https://api.financial.md/v1/request-data with body {"kind":"dataset","want":"Quarterly order backlog by segment","why":"Modeling revenue visibility","company":"ticker:BA","endpoint_or_tool":"/v1/company/kpis"}
curl -X POST "https://api.financial.md/v1/request-data" -H "content-type: application/json" -d '{"kind":"dataset","want":"Quarterly order backlog by segment","why":"Modeling revenue visibility","company":"ticker:BA","endpoint_or_tool":"/v1/company/kpis"}'GET /v1/request-data/{id}
Follow a request by the request_id POST /v1/request-data returned: new, triaged, planned, done (with served_by, the endpoint or tool) or wontfix (with a public note), and the vote counts.
Example: GET https://api.financial.md/v1/request-data/0b8f6a52-6f0e-4a8e-9a43-3c0f6b2d1e11
| Parameter | In | Description |
|---|---|---|
id (required) | path | The request_id POST /v1/request-data returned, or a demand item id |
curl "https://api.financial.md/v1/request-data/0b8f6a52-6f0e-4a8e-9a43-3c0f6b2d1e11"GET /v1/requested
Requested and shipped: the reviewed demand items with status, public note, served_by and vote counts, and counts per status. Aggregate only, no submitter details.
Example: GET https://api.financial.md/v1/requested
curl "https://api.financial.md/v1/requested"GET /v1/feedback
How to tell us what worked and what did not (POST /v1/feedback) and how to report a number you believe is wrong (POST /v1/data-errors): the bodies, the limits and what happens next.
Example: GET https://api.financial.md/v1/feedback
curl "https://api.financial.md/v1/feedback"POST /v1/feedback
Tell us what worked, what did not, or why an answer was wrong. Keyless, never charged. Send text, a rating (-1 or 1, or 1 to 5) or reasons. Notes are read and grouped every day; a wrong number is better sent to POST /v1/data-errors. Do not include personal data.
Example: POST https://api.financial.md/v1/feedback with body {"text":"Quarterly ratios for MSFT stop at 2023","rating":-1,"reasons":["missing_data"],"route_or_tool":"/v1/company/ratios"}
curl -X POST "https://api.financial.md/v1/feedback" -H "content-type: application/json" -d '{"text":"Quarterly ratios for MSFT stop at 2023","rating":-1,"reasons":["missing_data"],"route_or_tool":"/v1/company/ratios"}'POST /v1/data-errors
Report a number you believe is wrong. Keyless, never charged. The answer compares your expected value with what we serve now; open tickets are checked against the SEC's companyfacts daily and marked confirmed or rejected. Follow it with GET /v1/data-errors/{id}.
Example: POST https://api.financial.md/v1/data-errors with body {"company":"AAPL","statement":"income_statement","field":"income_statement_total_revenues","period":"FY2024","expected_value":391035000000,"source_url":"https://www.sec.gov/Archives/edgar/data/320193/000032019324000123/aapl-20240928.htm"}
curl -X POST "https://api.financial.md/v1/data-errors" -H "content-type: application/json" -d '{"company":"AAPL","statement":"income_statement","field":"income_statement_total_revenues","period":"FY2024","expected_value":391035000000,"source_url":"https://www.sec.gov/Archives/edgar/data/320193/000032019324000123/aapl-20240928.htm"}'GET /v1/data-errors/{id}
Follow a reported number by the ticket_id POST /v1/data-errors returned: new, already_served, confirmed, rejected, needs_review or unverifiable, with what we serve now.
Example: GET https://api.financial.md/v1/data-errors/0b8f6a52-6f0e-4a8e-9a43-3c0f6b2d1e11
| Parameter | In | Description |
|---|---|---|
id (required) | path | The ticket_id POST /v1/data-errors returned |
curl "https://api.financial.md/v1/data-errors/0b8f6a52-6f0e-4a8e-9a43-3c0f6b2d1e11"GET /v1/me
For a keyed caller: principal, plan and remaining limits. Needs an API key; keys come with the Terminal + Agent plans.
Example: GET https://api.financial.md/v1/me
curl "https://api.financial.md/v1/me"