api.financialdatasets.ai

Endpoints (36 live)

• GET /prices — Historical end-of-day stock prices for a US-listed ticker: open, high, low, close and volume per day, week, month or year between start_date and end_date, oldest first. Paginated with next_page_url. Use when an agent needs a price series or a return over a date range. Non-Professional use; Professional use needs a plan at financialdatasets.ai. (0.02 USDC on Base)
• GET /activist-ownership — Activist stakes from SEC Schedule 13D (holders above 5% with intent to influence control), by subject ticker or filer CIK: holder, shares held, percent of class, voting power and filing date, with optional amendment history. Use when an agent asks which activists hold a company, or where an activist is active. Non-Professional use; Professional use needs a plan at financialdatasets.ai. (0.02 USDC on Base)
• GET /beneficial-ownership — Beneficial ownership stakes above 5% from SEC Schedules 13D and 13G, by subject ticker or filer CIK: holder, shares held, percent of class, stake type (activist or passive), voting power and filing date, with optional amendment history. Use when an agent asks who owns more than 5% of a company, or what a fund holds. Non-Professional use; Professional use needs a plan at financialdatasets.ai. (0.02 USDC on Base)
• GET /earnings — Earnings snapshots for a US-listed ticker from the earnings release: quarterly and year-to-date revenue, EPS, net income, estimates, surprises and year-over-year changes where available, with the filing date and source URL; newest first. Use when an agent asks how the latest quarter compared with estimates or a year ago. Non-Professional use; Professional use needs a plan at financialdatasets.ai. (0.02 USDC on Base)
• GET /financial-metrics/snapshot — Real-time financial metrics snapshot for a company by ticker or CIK at today's price: market cap, enterprise value, valuation ratios, margins, returns, liquidity, leverage, growth and per-share figures. Use when an agent needs current valuation ratios for one company, not history. Non-Professional use; Professional use needs a plan at financialdatasets.ai. (0.02 USDC on Base)
• GET /prices/snapshot — Real-time price snapshot for a US-listed ticker: current price, day change, day change percent and the quote time. Use when an agent needs the latest price for one ticker, not history. Non-Professional use; Professional use needs a plan at financialdatasets.ai. (0.02 USDC on Base)
• GET /index-funds — ETF and index fund holdings in two directions: the constituents and weights of one fund by its ticker (latest filing, or as of a date), or every fund whose latest filing holds a given security, sorted by weight. Use when an agent needs what is inside an ETF or which funds hold a stock. Non-Professional use; Professional use needs a plan at financialdatasets.ai. (0.02 USDC on Base)
• GET /filings — SEC filings for a company by ticker or CIK: filing type, filing date, report period, accession number and the document URL on sec.gov, newest first; filter by one or more filing types such as 10-K, 10-Q or 8-K. Paginated with next_page_url. Use when an agent needs the list of a company's filings or the link to a specific one. Non-Professional use; Professional use needs a plan at financialdatasets.ai. (0.02 USDC on Base)
• GET /macro/yield-curve — Daily US Treasury par yield curve history: one object per business day with one key per tenor from 1 month to 30 years, in percent, newest first. Paginated with next_page_url. Use when an agent needs the yield curve over time, one tenor as a series or a spread such as 10-year minus 2-year. Non-Professional use; Professional use needs a plan at financialdatasets.ai. (0.02 USDC on Base)
• GET /macro/inflation — Monthly US inflation history for one series by id (CPI all items, core, food, energy, shelter and services less energy, each seasonally adjusted or not; PCE all items and core): the index level with the month-over-month and year-over-year percent changes, newest first. Paginated with next_page_url. Use when an agent needs an inflation series over time. Non-Professional use; Professional use needs a plan at financialdatasets.ai. (0.02 USDC on Base)
• GET /kpi/guidance — Forward guidance from a US-listed company's earnings releases, structured: metric, period, the low and high of the range or the point estimate, the change direction versus prior guidance and a link to the source text. Period quarterly or annual; filter by metric_name or report_period. Use when an agent needs what management guided to, not what was reported. Non-Professional use; Professional use needs a plan at financialdatasets.ai. (0.16 USDC on Base)
• GET /kpi/metrics — Sector-specific operating KPIs for a US-listed ticker, extracted from 8-K earnings releases: for example load factor, CET1 ratio, same-store sales or FFO per share, each with value, unit, period, year-over-year change and a link to the source text. Period quarterly or annual; filter by metric_name or report_period. Use when an agent needs the operating metrics a company reports outside its GAAP statements. Non-Professional use; Professional use needs a plan at financialdatasets.ai. (0.16 USDC on Base)
• GET /macro/labor — US labor market history for one series by id (nonfarm payrolls, unemployment rate, participation, hourly earnings, job openings, hires, quits, weekly jobless claims): the value with the change from the prior period and from a year earlier, newest first. Paginated with next_page_url. Use when an agent needs a jobs report or claims series over time. Non-Professional use; Professional use needs a plan at financialdatasets.ai. (0.02 USDC on Base)
• GET /macro/inflation/snapshot — The most recent month of every US inflation series (twelve CPI, two PCE), or one series when series is given, each with the month-over-month and year-over-year percent changes. Use when an agent needs the latest inflation print without history. Non-Professional use; Professional use needs a plan at financialdatasets.ai. (0.02 USDC on Base)
• GET /news — Recent news articles for a US-listed ticker, or broad market news when no ticker is given: title, source, date and URL, newest first; up to 10 per request. Use when an agent needs the latest headlines on a company or the market. Non-Professional use; Professional use needs a plan at financialdatasets.ai. (0.02 USDC on Base)
• GET /institutional-holdings — 13F institutional holdings by filer CIK or by held ticker: each position's shares, value in dollars and reported price from the filer's most recent 13F, or every filer whose latest 13F holds the ticker; filter by report_period. Use when an agent needs who holds a stock or what a fund manager holds. Non-Professional use; Professional use needs a plan at financialdatasets.ai. (0.02 USDC on Base)
• GET /macro/interest-rates/snapshot — The newest policy rate of every central bank covered (FED, ECB, BOJ and others), one row per bank with the date it took effect, or one bank when bank is given. Use when an agent needs today's policy rates without history. Non-Professional use; Professional use needs a plan at financialdatasets.ai. (0.02 USDC on Base)
• GET /ipos — SEC IPO filings (S-1, S-1/A, F-1, F-1/A and final prospectuses 424B4, 424B1), newest first, each classified as ipo, shell_company, spac, resale or other, with cover-page details: proposed ticker, exchange and the expected price or price range; IPO-grade filings embed the extracted financial statements. Filter by ticker, CIK, classification or filing_date. Use when an agent tracks upcoming or recent listings. Non-Professional use; Professional use needs a plan at financialdatasets.ai. (0.16 USDC on Base)
• GET /macro/labor/snapshot — The most recent print of every US labor market series (monthly series on their latest month, weekly claims on their latest week), or one series when series is given, each with the change from the prior period and from a year earlier. Use when an agent needs the latest jobs numbers without history. Non-Professional use; Professional use needs a plan at financialdatasets.ai. (0.02 USDC on Base)
• GET /insider-ownership — Insider ownership statements for a US-listed ticker from SEC Forms 3 and 5, one row per reported holding as of each filing: insider name, title, security, shares owned and ownership type, newest filings first; filter by name, form_type or filing_date. Use when an agent needs what an insider owns, not what they traded (that is /insider-trades). Non-Professional use; Professional use needs a plan at financialdatasets.ai. (0.02 USDC on Base)

+16 more endpoints.