YH Finance APIs
Programmatic access to live stock quotes, OHLCV charts, company fundamentals, earnings calendar, screeners and financial news. Build trading apps, portfolio dashboards and research tools with real-time equity data. Trusted by fintech and trading platforms worldwide.
Symbol and keyword auto-complete
Type-ahead symbol and keyword search for equities, ETFs and indices. Power search boxes and symbol pickers in trading and research apps. Returns matching symbols and entities as users type for fast ticker discovery.
Count events in a time period
Count the number of events (earnings, splits, IPO info, economic events) in a period. Use filter operands for date range and region. Ideal for dashboard KPIs and alert thresholds.
Get events in a time period
Fetch events (earnings, splits, IPO info, economic events) with pagination, sort and optional fields. Request body supports filter operators for flexible calendar feeds.
Count conversations for a symbol
Get total conversation count for a ticker's message board. Use messageBoardId from market/v2/get-quotes. Lightweight metric for community and sentiment dashboards.
List conversations (Deprecated)
List conversations relating to a symbol with sort and pagination. Deprecated; prefer conversations/v2/list for new integrations.
List conversations (v2)
List conversations for a symbol with count, offset and sort. Use messageBoardId from market/v2/get-quotes. Powers community and sentiment tabs.
Chart data for symbol and comparisons (Deprecated)
Get data to draw chart for a specific symbol and comparison symbols. Deprecated; consider stock/v2/get-chart or stock/v3/get-chart.
Get recent market earnings
Get recent earnings in the market by region and date range. Supports size for result count. Powers market-wide earnings recap and screens.
Get popular watchlists
Get popular watchlists in the market. No parameters; returns list of curated watchlists for discovery and portfolio templates.
Spark/mini chart data
Lightweight OHLCV data for multiple tickers to render sparklines and mini charts. Pair with market/get-trending-tickers for trending spark views.
Tickers grouped by quote type
Get tickers grouped by quote types (equity, ETF, mutual fund, etc.). Optional region and lang for universe selection and filters.
Get trending tickers
Get latest trending tickers in the market by region. Pair with market/get-spark for spark charts. No symbol input; returns current trending list.
Watchlist detail
Get detail information of a specific watchlist by userId and portfolio id (pfId). Full definition and metadata for display or editing.
Watchlist performance
Get performance information of a specific watchlist. Optional symbols and region. Returns and related stats for portfolio and comparison views.
Day gainers, losers, actives
The live day gainers, losers and most active stocks in a specific region. Supports count and start for pagination. Pre-computed lists for the trading day.
Live price quotes
Get live price quotes for one or more symbols. Comma-separated symbols; region required. Quotes synced at request time for quote strips and order forms.
Market summary by region
Get live summary information of the market by region. Single call per region; no symbol input. High-level indices and status for dashboards.
News article details
Read a specific news article in full. UUID from news/v2/list response. Fetch full content for reader views and deep links.
List news and feeds
List latest general news or video feeds, or news relating to a symbol (parameter s). POST body for pagination (uuids). Paginated financial news and videos.
Screener filter options
Get optional filters for later use in screeners/list. Category and quoteType narrow filter set. Build dynamic screening UIs and documentation.
Symbols by predefined screener
Get symbols related to a predefined screener (e.g. MOST_ACTIVES). scrIds, optional start and count. Curated symbol lists without custom filters.
Run screener with filters
List gainers, losers, most active, mutual funds, ETFs and more with optional filters. POST body for filter criteria. Custom and category screens.
Screener IDs for a ticker
Get screener IDs related to a ticker. Use symbol from auto-complete. Find which predefined or custom screeners contain this stock.
Company outlook
Get company outlook for a symbol. Includes high-level business and growth narrative; optional region and lang. Curated outlook text and key themes.
Earnings for a symbol
Get earnings related to a symbol. Historical and upcoming earnings; optional region and lang. All earnings data for one ticker.
ESG risk scores for peers (Deprecated)
Get ESG risk scores for peers related to a symbol. Deprecated; prefer stock/get-esg-scores where applicable.
ESG scores for symbol
Get ESG scores related to a symbol. Optional region and lang. Scores and ratings for sustainability and risk for sustainable investing.
Events calendar for symbol
Get events calendar (IPO, earnings, SEC reports) for a symbol. modules and tickersFilter required; optional date range. Multi-ticker calendar support.
Fees and expenses
Get fees and expenses related to a symbol (e.g. funds). Optional region and lang. Expense ratio and fee details for fund comparison.
Fundamentals data
Get fundamentals data. modules (comma-separated) select which blocks to return; symbol and optional region and lang. Comprehensive fundamental data.
Futures chain
Get futures chain for a symbol. Optional region and lang. Contracts and expiries for the underlying for derivatives workflows.
Recent updates for symbol
Get recent updates related to a symbol. Optional region and lang. Chronological updates for activity feeds.
Recommendation trend
Get recommended trending information (analyst consensus trend). Optional region and lang. Aggregate analyst recommendation over time.
SEC filings for symbol
Get SEC filings related to a symbol. Optional region and lang. Filing list with type and date for compliance and research.
Top holdings for symbol
Get top holdings related to a symbol (e.g. for funds or ETFs). Optional region and lang. Top positions with weights for composition views.
What analysts are saying
Get the "what analysts are saying" section for one or more symbols. Comma-separated symbols; optional region and lang. Narrative and key takeaways.
Chart data (v2)
Get data to draw full-screen chart. range and interval or period1/period2; optional region. OHLCV for charting and backtest.
Brief reports for symbol (v2)
Get brief reports relating to a symbol. Single symbol. Short reports and highlights for quick context.
Similar and recommended symbols
Get similar symbols relating to the specified one. Single symbol. Symbols similar or often compared for discovery.
Financials timeseries (quarterly/annual)
Get quarterly or annual data in Financials tab. type selects metrics; period1 and period2 for range. Historical fundamentals for charts and models.
Chart data (v3)
Get data to draw full-screen chart with comparisons, events (dividends, splits), and pre/post market. range and interval required. Rich charting for pros.
Holders for symbol
Get holders (institutional, major, insider) related to a symbol. Optional region and lang. Ownership breakdown for analysis.
Brief reports for symbol (v3)
Get brief reports relating to a symbol. Preferred over v2 for new integrations. Insight reports and highlights.
Option prices
Get option prices for a symbol. Optional date, straddle, region and lang. Calls and puts with strikes and expirations.
Ticker profile
Get ticker profile (sector, industry, employees, description, etc.). Optional region and lang. Company profile for detail pages.
Upgrades and downgrades history
Get upgrades and downgrades histories related to a symbol. Optional region and lang. Chronological rating changes.
Statistics for symbol
Get statistics related to a symbol. Preferred statistics endpoint; optional region and lang. Valuation, profitability and market metrics.
Analysis section (Deprecated)
Get data in Analysis section. Deprecated. Use fundamentals or insights endpoints instead.
Balance sheet (Deprecated)
Get Balance Sheet tab data. Use stock/v2/get-timeseries and stock/get-fundamentals instead.
Cash flow (Deprecated)
Get cash flow tab. Use stock/v2/get-timeseries and stock/get-fundamentals instead.
Income statement annual (Deprecated)
Get Income Statement annual data. Use get-timeseries and get-fundamentals instead; for quarterly use get-timeseries.
Holdings tab (Deprecated)
Get Holdings tab (mutual fund). Single symbol. Use stock/get-top-holdings where applicable.
Insider roster (Deprecated)
Get Insider Roster tab in Holders section. Use get-fundamentals or v3/get-holders.
Insider transactions (Deprecated)
Get Insider Transactions tab. Use get-fundamentals modules.
Similar symbols (Deprecated)
Get similar and recommended symbols. Prefer stock/v2/get-recommendations.
Statistics tab (Deprecated)
Get Statistics tab. Use stock/get-fundamentals or stock/v4/get-statistics instead.
Upgrades downgrades (Deprecated)
Get upgrades and downgrades. Prefer stock/v3/get-upgrades-downgrades.
Balance sheet v3 (Deprecated)
Get Balance Sheet tab. Use get-timeseries and get-fundamentals instead.
Historical data tab (Deprecated)
Get Historical Data tab. Use stock/get-fundamentals instead.
Statistics v3 (Deprecated)
Get Statistics tab. Use stock/get-fundamentals or stock/v4/get-statistics instead.