--- name: finance.toon.haus description: finance.toon.haus provides four read-only financial market data endpoints covering trending equities, earnings schedules, market news, and IPO calendars. It returns structured JSON snapshots suitable for dashboards, research agents, and event-driven workflows. It does not offer real-time streaming, full stock quotes, or historical price series. host: finance.toon.haus --- # finance.toon.haus finance.toon.haus is a lightweight market-intelligence host serving agents that need scheduled or event-driven financial context rather than live price feeds. It covers four distinct data surfaces — trending movers, earnings dates, news headlines, and IPO schedules — making it useful for briefing agents, research summarizers, and calendar-aware trading assistants. It does not compete with full-featured quote or charting APIs; it fills the gap between raw price data and narrative market context. ## When to use this host Use finance.toon.haus when an agent needs scheduled event data (earnings dates, IPO listings), trending equity snapshots, or categorized news headlines in a structured JSON format. It is well-suited for briefing pipelines, calendar-aware agents, and research summarizers. Do not use it for full stock quotes (open, high, low, volume, market cap), real-time or streaming price feeds, historical OHLCV data, or fundamental financials — those require a dedicated market data or charting API. The earnings and IPO calendars are forward-looking; for historical results already reported, use a historical financials endpoint instead. ## Capabilities ### Market Movers Surfaces stocks that are actively moving in a given region, providing symbol, price, and change data suitable for dashboard displays or momentum screens. - **`fetch-trending-market-symbols`** — Returns a list of trending stock symbols for a given market region, including current price, absolute change, and percent change for each symbol. ### Corporate Event Calendar Tracks scheduled corporate events — earnings reports and IPO listings — within user-specified date windows, including consensus estimates and offering details. - **`fetch-earnings-calendar`** — Returns a list of upcoming and recent earnings report dates with EPS and revenue estimates for stocks within a specified date range. - **`fetch-ipo-calendar`** — Returns upcoming IPO schedule entries for a given date window, including listing date, company name, ticker, exchange, share count, price range, and status. ### Market News Feed Retrieves paginated recent news articles with headlines, summaries, sources, and category tags for broad market or sector-specific news consumption. - **`fetch-market-news`** — Returns a paginated JSON feed of recent market and business news articles, each with headline, summary, source, URL, published timestamp, and category. ## Workflows ### Upcoming Corporate Event Briefing *Use when an agent needs to prepare a combined briefing of all scheduled corporate events (earnings and IPOs) plus relevant news context for a given date window.* 1. **`fetch-earnings-calendar`** — Retrieve all companies reporting earnings within the target date range, including EPS and revenue estimates and report timing. 2. **`fetch-ipo-calendar`** — Retrieve all IPOs scheduled within the same date range, including exchange, price range, and status. 3. **`fetch-market-news`** — Pull recent market news filtered by relevant category to provide narrative context around the identified earnings and IPO events. ### Trending Stocks News Digest *Use when an agent needs to identify actively moving stocks in a region and then surface recent news that may explain or contextualize the price action.* 1. **`fetch-trending-market-symbols`** — Identify the current trending symbols and their price changes for the target market region. 2. **`fetch-market-news`** — Fetch recent market news to provide potential explanations or context for the observed trending movements. ## Skill reference ### `fetch-trending-market-symbols` **Trending Market Symbols** — Returns a list of trending stock symbols for a given market region, including current price, absolute change, and percent change for each symbol. *Use when:* Use when an agent needs to display or analyze a short list of actively moving stocks in a specific market region, such as surfacing top movers for a US market dashboard or alerting on trending equities. *Not for:* Do not use for full stock quote details (open, high, low, market cap, etc.) on a specific ticker — use a dedicated stock quote endpoint instead. Not suitable for streaming or real-time price feeds. **Inputs:** - `region` (string) — Market region code to filter trending symbols. Defaults to 'US'. **Returns:** Returns a region string and a symbols array of 5 trending stocks, each with ticker symbol, company name, current price, absolute change, and percent change for the day. **Example:** `GET https://finance.toon.haus/api/market/trending?region=US` --- ### `fetch-earnings-calendar` **Earnings Calendar** — Returns a list of upcoming and recent earnings report dates with EPS and revenue estimates for stocks within a specified date range. *Use when:* Use when an agent needs to know which companies are reporting earnings within a date window, including report timing (before/after market), quarter, year, and consensus EPS or revenue estimates. *Not for:* Do not use for real-time stock prices or historical earnings results already reported; use a stock quote or historical financials endpoint instead. **Inputs:** - `from` (string) — Start date in YYYY-MM-DD format. Defaults to today. - `to` (string) — End date in YYYY-MM-DD format. Defaults to 7 days from the start date. - `symbol` (string) — Filter results to a specific ticker symbol. - `international` (boolean) — When true, includes international market earnings. Defaults to false. **Returns:** Returns from/to date strings and an earnings array where each entry includes ticker, report date, timing code (bmo/amc/blank), fiscal quarter and year, and nullable EPS and revenue estimate and actual values. **Example:** `GET https://finance.toon.haus/api/market/earnings-calendar?from=2026-05-18&to=2026-05-25` --- ### `fetch-market-news` **Market News Feed** — Returns a paginated JSON feed of recent market and business news articles, each with headline, summary, source, URL, published timestamp, and category. *Use when:* Use when an agent needs recent market or business news headlines, optionally filtered by category (general, forex, crypto, merger) or paginated by article ID. *Not for:* Do not use for real-time streaming news or ticker-level price data; use a market quotes endpoint instead. **Inputs:** - `limit` (integer) — Maximum number of articles to return. Must be between 1 and 100. Defaults to 20. - `category` (string) — News category filter. One of: general, forex, crypto, merger. Defaults to general. - `minId` (integer) — Only return news articles with an ID greater than this value, used for pagination. **Returns:** Returns a news array where each item contains headline, summary, source name, article URL, ISO 8601 publishedAt timestamp, and a category string such as 'business' or 'top news'. **Example:** `GET https://finance.toon.haus/api/market/news?limit=10&category=crypto` --- ### `fetch-ipo-calendar` **IPO Calendar** — Returns upcoming IPO schedule entries for a given date window, including listing date, company name, ticker, exchange, share count, price range, and status. *Use when:* Use when an agent needs a list of upcoming IPOs within a specific date range, such as to answer questions about scheduled public offerings, expected listing dates, or IPO price ranges on major exchanges. *Not for:* Do not use for historical IPO data outside the query window or for real-time post-IPO stock quotes; use a stock quote endpoint instead. **Inputs:** - `from` (string) — Start date in YYYY-MM-DD format. Defaults to today. - `to` (string) — End date in YYYY-MM-DD format. Defaults to 30 days from now. **Returns:** Returns a JSON object with from/to date bounds and an ipos array, each entry containing date, name, ticker, exchange, shares, priceRange (nullable), and status for each upcoming IPO in the window. **Example:** `GET https://finance.toon.haus/api/market/ipo-calendar?from=2026-05-16&to=2026-06-15` ---