# AInvest API

## Docs

- [AInvest Terminal](https://docs.ainvest.com/terminal/overview.md): Learn the core workflows in AInvest's desktop AI investing workspace.
- [Chat](https://docs.ainvest.com/terminal/chat.md): Ask questions, choose how AInvest should work, and organize related conversations.
- [Trading Studio](https://docs.ainvest.com/terminal/trading-studio.md): Build and control a multi-panel financial workspace with AI.
- [Extensions](https://docs.ainvest.com/terminal/extensions.md): Manage plugins, specialized skills, and MCP connections.
- [Automation](https://docs.ainvest.com/terminal/automations.md): Create recurring market monitors with natural language.
- [Credits and Rewards](https://docs.ainvest.com/terminal/credits.md): Understand Credits, check usage, and earn or add more.
- [Changelog](https://docs.ainvest.com/terminal/changelog.md): See recent AInvest Terminal releases and open the complete release history.
- [Getting Started](https://docs.ainvest.com/widgets/getting-started.md): Plan, configure, and integrate your first AInvest Widget.
- [Changelog](https://docs.ainvest.com/widgets/changelog.md): Track AInvest Widgets documentation and integration contract updates.
- [Super Chart](https://docs.ainvest.com/widgets/api-reference/super-chart.md): Advanced financial chart for price analysis, indicators, drawings, volume, and extended-hours context.
- [Watchlist](https://docs.ainvest.com/widgets/api-reference/watchlist.md): Personalized security list for tracking symbols, prices, movement, and market context.
- [Top List](https://docs.ainvest.com/widgets/api-reference/top-list.md): Ranked market lists for gainers, losers, active stocks, new highs, and other discovery workflows.
- [Quick Quote](https://docs.ainvest.com/widgets/api-reference/quick-quote.md): Compact regular-session and extended-hours quote with essential trading statistics.
- [Market Calendar](https://docs.ainvest.com/widgets/api-reference/market-calendar.md): Scheduled earnings and market events with timing, estimates, actuals, and surprise context.
- [Heat Map](https://docs.ainvest.com/widgets/api-reference/heat-map.md): Interactive market-performance map grouped by symbol, sector, size, and percentage change.
- [News Wire](https://docs.ainvest.com/widgets/api-reference/news-wire.md): Timely market headlines with related securities, timestamps, and live price context.
- [Getting started](https://docs.ainvest.com/docs/quickstart.md): Financial data suite built by finance people for engineers. Simple steps to try now
- [MCP servers](https://docs.ainvest.com/docs/mcp-servers.md): Connecting AI chatbots to Ainvest financial data
- [Changelog](https://docs.ainvest.com/docs/changelog.md): Product updates and release plan
- [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.
- [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.
- [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.
- [Stock dividends](https://docs.ainvest.com/reference/securities/stock-dividends.md): Get dividends for a specified stock
- [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.
- [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.
- [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
- [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.
- [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.
- [Splits calendar](https://docs.ainvest.com/reference/calendar/corporateactions.md): Get corporate actions (stock splits and reverse splits) on the specified date.
- [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.
- [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.
- [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.
- [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
- [US Congress trades](https://docs.ainvest.com/reference/ownership/congress.md): Get trades by US politicians, including date, type of trade, approximate dollar value
- [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
- [Codes](https://docs.ainvest.com/reference/codes.md)

## 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)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.