--- name: finance.toonhaus.dev description: finance.toonhaus.dev provides four read-only financial data endpoints covering market trending symbols, earnings events, market news, and upcoming IPOs. It is oriented toward event-driven and research workflows where an agent needs to survey what is happening in markets at a point in time, not execute trades or retrieve granular historical price series. host: finance.toonhaus.dev --- # finance.toonhaus.dev This host serves agents that need lightweight market intelligence: which symbols are trending, what earnings are coming up, what news is circulating, and which companies are going public soon. It covers equities and crypto at a surface level and is best suited for research, alerting, and context-gathering tasks rather than deep quantitative analysis or real-time quote streaming. ## When to use this host Use this host when an agent needs a broad, event-oriented snapshot of market activity: trending symbols, earnings schedules, IPO pipelines, or news headlines. It is appropriate for research, alerting, and context-enrichment tasks. Do not use it for real-time streaming quotes, intraday price data, or granular fundamental metrics (P/E ratios, market cap, balance sheet data) — those require a dedicated market data or fundamentals provider. It does not support trade execution, portfolio management, or historical time-series analysis beyond what the earnings calendar date range allows. For deep historical OHLCV data, route to a dedicated market data host instead. ## Capabilities ### Market Activity Signals Identifies what is moving in markets right now by surfacing trending symbols with price and daily change data for a given region. - **`fetch-market-trending`** — Returns a list of currently trending market symbols for a given region, including last price and daily change metrics. ### Corporate Event Calendar Tracks scheduled corporate events — earnings releases and IPO listings — within user-specified date windows, including estimates, actuals, and listing details. - **`fetch-earnings-calendar`** — Returns a list of upcoming and recent earnings events for a date range, including ticker, reporting date, before/after-market hour, fiscal quarter/year, and EPS/revenue estimates and actuals when available. - **`fetch-ipo-calendar`** — Returns upcoming IPO listings within a specified date range, including company name, ticker, exchange, share count, price range, and status. ### Market News Feed Retrieves paginated financial and business news headlines filtered by category, enabling agents to monitor current narratives across equities, forex, crypto, and M&A. - **`fetch-market-news`** — Returns a paginated feed of recent market and business news items including headline, summary, source, URL, publication timestamp, and category. ## Workflows ### Trending Symbol News Briefing *Use when an agent needs to explain why certain symbols are trending by pairing trending data with relevant news headlines.* 1. **`fetch-market-trending`** — Retrieve the list of currently trending symbols and their price/change metrics for the target region. 2. **`fetch-market-news`** — Fetch recent market news (e.g. category 'general') to surface headlines that may explain the observed price movements. ### Earnings Week Research Pack *Use when an agent needs to prepare a research summary for an upcoming earnings period, combining scheduled events with current market sentiment.* 1. **`fetch-earnings-calendar`** — Pull the list of earnings events for the target date range to identify which companies are reporting and their EPS/revenue estimates. 2. **`fetch-market-news`** — Fetch relevant news headlines to provide narrative context around the companies scheduled to report. 3. **`fetch-market-trending`** — Check whether any of the earnings-period tickers are currently trending to gauge market attention ahead of their reports. ### New Listings Market Context *Use when an agent needs to assess the market environment surrounding upcoming IPOs.* 1. **`fetch-ipo-calendar`** — Retrieve scheduled IPOs within the target date window to identify upcoming listings, price ranges, and exchanges. 2. **`fetch-market-news`** — Fetch merger or general news to surface any relevant coverage or sentiment around the IPO pipeline. ## Skill reference ### `fetch-market-trending` **Market Trending Data** — Returns a list of currently trending market symbols for a given region, including last price and daily change metrics. *Use when:* Use when an agent needs to identify which stock or crypto symbols are currently trending in a specific market region, along with their latest price, absolute change, and percent change for the day. *Not for:* Do not use for historical trending data or detailed fundamental metrics (P/E, market cap, etc.); use a dedicated quote or metrics endpoint instead. **Inputs:** - `region` (string) — Market region code to filter trending symbols. Defaults to 'US'. **Returns:** Returns a region string and a symbols array of trending tickers, each with symbol, name, current price, absolute daily change, and daily percent change. **Example:** `GET https://finance.toonhaus.dev/api/market/trending?region=US` --- ### `fetch-earnings-calendar` **Earnings Calendar** — Returns a list of upcoming and recent earnings events for a date range, including ticker, reporting date, before/after-market hour, fiscal quarter/year, and EPS/revenue estimates and actuals when available. *Use when:* Use when an agent needs to look up scheduled earnings dates, reporting times (pre-market or after-market close), or EPS/revenue estimates and actuals for one or more stocks within a specified date window. *Not for:* Do not use for real-time stock price quotes or intraday market data; use a quote endpoint instead. Not suitable for historical earnings going back more than a few weeks without adjusting the date range. **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 now. - `symbol` (string) — Filter results to a specific ticker symbol. - `international` (boolean) — When true, includes international market listings. Defaults to false. **Returns:** Returns a JSON object with from/to date bounds and an earnings array where each entry contains ticker, date, reporting hour (bmo/amc/empty), fiscal quarter and year, and nullable EPS/revenue estimate and actual fields. **Example:** `GET https://finance.toonhaus.dev/api/market/earnings-calendar?from=2026-05-16&to=2026-05-23` --- ### `fetch-market-news` **Market News Feed** — Returns a paginated feed of recent market and business news items including headline, summary, source, URL, publication timestamp, and category. *Use when:* Use when an agent needs current financial, geopolitical, or business headlines filtered by category (general, forex, crypto, or merger) or paginated by article ID. *Not for:* Do not use for real-time streaming price data or stock quotes; use a market data quote 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 items after this article ID. Used for pagination to fetch newer articles than a previously seen ID. **Returns:** Returns a news array where each item contains a headline, summary, source name, article URL, ISO 8601 publishedAt timestamp, and category string. **Example:** `GET https://finance.toonhaus.dev/api/market/news?limit=10&category=general` --- ### `fetch-ipo-calendar` **IPO Calendar** — Returns upcoming IPO listings within a specified date range, including company name, ticker, exchange, share count, price range, and status. *Use when:* Use when an agent needs a list of scheduled or expected IPOs within a given date window, such as for investment research, market event tracking, or alerting on new listings. *Not for:* Do not use for historical IPO data outside the supported date range, or for real-time post-IPO trading prices; 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 from/to date window and an ipos array where each entry contains date, name, ticker, exchange, shares, priceRange, and status for each upcoming IPO. **Example:** `GET https://finance.toonhaus.dev/api/market/ipo-calendar?from=2026-05-05&to=2026-06-04` ---