# AInvest API

## Docs

- [Changelog](https://docs.ainvest.com/docs/changelog.md): Product updates and release plan
- [MCP servers](https://docs.ainvest.com/docs/mcp-servers.md): Connecting AI chatbots to Ainvest financial data
- [Getting started](https://docs.ainvest.com/docs/quickstart.md): Financial data suite built by finance people for engineers. Simple steps to try now
- [Analyst ratings](https://docs.ainvest.com/reference/analysis-ratings.md)
- [Average rating](https://docs.ainvest.com/reference/analysis-ratings/consensus.md): Get current rating and target price averaged across all analysts opinions
- [All ratings](https://docs.ainvest.com/reference/analysis-ratings/history.md): Get all ratings along with target prices, firm names and dates of the research publication
- [Splits calendar](https://docs.ainvest.com/reference/calendar/corporateactions.md): Get corporate actions (stock splits and reverse splits) on the specified date.
- [Dividends calendar](https://docs.ainvest.com/reference/calendar/dividends.md): Get dividends on the specified ex-date. Both historical or upcoming dividends can be retrieved.
- [Earnings calendar](https://docs.ainvest.com/reference/calendar/earnings.md): Get earnings announcements on the specified date
- [Earnings backtesting](https://docs.ainvest.com/reference/calendar/earnings-backtesting.md): Get earnings backtesting results
- [Economic events calendar](https://docs.ainvest.com/reference/calendar/economics.md): Get economic events (e.g. GDP releases, employment reports) on the specified date.
- [IPO calendar](https://docs.ainvest.com/reference/calendar/ipo.md): Get Initial Public Offerings (IPO) scheduled on the specified date. Both historical or upcoming IPOs can be retrieved.
- [Codes](https://docs.ainvest.com/reference/codes.md)
- [Candles](https://docs.ainvest.com/reference/marketdata/candles.md): Use this endpoint to get prices as OHLCV (open-high-low-closed-volume) data for specified period, aggregation interval and trading session
- [Trades](https://docs.ainvest.com/reference/marketdata/trades.md): Use this endpoint to get `count` trades for a specific stock `ticker`, printed immediately before the `to` timestamp. The trades are ordered by time, ascending.
- [Articles](https://docs.ainvest.com/reference/news/articles.md): Returns latest articles ordered by time latest first, supports pagination and filtering options.
- [Articles content](https://docs.ainvest.com/reference/news/articles-content.md): Returns the article content body for a given article ID. For performance reasons, content body is not included in the articles list [page](/reference/news/articles) endpoint.
- [News wires](https://docs.ainvest.com/reference/news/wires.md): Returns latest news wires ordered by time latest first, supports pagination and filtering options.
- [Wire content](https://docs.ainvest.com/reference/news/wires-content.md): Returns the news content body for a given news ID. For performance reasons, content body is not included in the news headline [page](/reference/news/wires) endpoint.
- [US Congress trades](https://docs.ainvest.com/reference/ownership/congress.md): Get trades by US politicians, including date, type of trade, approximate dollar value
- [Insider trades](https://docs.ainvest.com/reference/ownership/insider.md): Get insider trades as filed with SEC, including date, type of trade, number of shares and price
- [ETF holdings](https://docs.ainvest.com/reference/securities/etf-holdings.md): Get a list of holdings in an ETF. Also provides history of changes for known dates.
- [ETF profile](https://docs.ainvest.com/reference/securities/etf-profile.md): Get general information about an ETF, including its name, industry, aum, fee rates, dividend rates and other details.
- [Securities search](https://docs.ainvest.com/reference/securities/search.md): Search for US stocks by ticker symbol or company name. Returns a list of matching securities ordered by relevance.
- [Stock dividends](https://docs.ainvest.com/reference/securities/stock-dividends.md): Get dividends for a specified stock
- [Stock earning reports](https://docs.ainvest.com/reference/securities/stock-earnings.md): Get earnings reports for a specified stock, including revenue, earnings per share, and links to relevant SEC documents and investor call recordings.
- [Company financials](https://docs.ainvest.com/reference/securities/stock-financials.md): Get financial metrics of a stock, including earnings per share, net profit, operating income, etc.
- [Stock financial statements](https://docs.ainvest.com/reference/securities/stock-statements.md): Get financial statements for a specified stock, including income statements, balance sheet, and cash flow statements.

## OpenAPI Specs

- [securities](https://docs.ainvest.com/reference/securities/securities.yaml)
- [news](https://docs.ainvest.com/reference/news/news.yaml)
- [marketdata](https://docs.ainvest.com/reference/marketdata/marketdata.yaml)
- [calendar](https://docs.ainvest.com/reference/calendar/calendar.yaml)
- [ownership](https://docs.ainvest.com/reference/ownership/ownership.yaml)
- [analysis-ratings](https://docs.ainvest.com/reference/analysis-ratings/analysis-ratings.yaml)
- [analysts-ratings](https://docs.ainvest.com/reference/analysts-ratings/analysts-ratings.yaml)
- [openapi](https://docs.ainvest.com/api-reference/openapi.json)