analyze_stock
ChatGPTGet everything needed to analyse an EGX stock, as data: latest price snapshot, period returns, fundamentals against the sector, and technical indicators with support/resistance levels. Returns numbers, not a written analysis. analysis_type: "both" (default), "technical" (snapshot, returns, technicals) or "financial" (snapshot, returns, fundamentals). The ticker can be a code (COMI, COMI.CA) or a company name. Examples: analyze_stock("COMI") → full data picture for CIB analyze_stock("HRHO", "technical") → price, returns and technicals only Counts toward the limit of 20 different stocks with detailed data a day (60 in 30 days); stocks in the user's own portfolio, and stocks already looked up in the last 30 days, do not count.
compare_stocks
ChatGPTGet the analyze_stock data for 2–4 EGX stocks, one block per stock, so you can compare them: price snapshot, period returns, fundamentals against the sector, and technicals. Returns numbers, not a written comparison. Pass tickers (codes or company names) as a comma-separated string. Examples: compare_stocks("COMI, HRHO") → CIB vs EFG Holding compare_stocks("ABUK, MFPC, EGCH") → three fertilizer producers Counts toward the limit of 20 different stocks with detailed data a day (60 in 30 days); stocks in the user's own portfolio, and stocks already looked up in the last 30 days, do not count.
get_company_announcements
ChatGPTGet official EGX company announcements (disclosures), newest first: board decisions, financial statements, dividends, general assemblies, etc. ticker (code or company name): that company's announcements; without it, the whole market's. Dates YYYY-MM-DD; default the last 30 days with a ticker, the last 3 days without; at most the last 3 months (a limit of this tool, not of the data: an earlier start is moved to 3 months ago, and the answer says so). limit 1–40. Titles are given in English and Arabic, quoted between ⟦ ⟧ as third-party text. Only titles — the announcement documents themselves are not included. Examples: get_company_announcements("COMI") → CIB's disclosures, last 30 days get_company_announcements() → all disclosures, last 3 days
get_corporate_actions
ChatGPTGet corporate actions from EGX announcements: cash dividends, stock dividends (bonus shares), rights issues, stock splits, reverse splits, demergers, merger share exchanges, convertible bonds. ticker (code or company name): that company's actions, the last year by default and at most (limit 1–50). Without a ticker: the whole market's actions, the last 90 days by default and at most (limit 1–20). These are limits of this tool, not of the data: an earlier start is moved to the limit, and the answer says so. action_type: "cash_dividend", "stock_dividend", "rights_issue", "split", "reverse_split", "demerger", "merger", "convertible_bonds" (default all). Dates YYYY-MM-DD filter by announcement date. Newest first. Each action's details (amounts, ratios, ex-dates, payment dates…) are fields extracted from the announcement; field names vary between records. Examples: get_corporate_actions("COMI", "cash_dividend") → CIB's dividends get_corporate_actions(action_type="split") → recent splits, all stocks
get_financial_statements
ChatGPTGet companies' reported quarterly financial statement line items — raw figures, no ratios. Returns the last quarters quarters, newest first. At most 5 quarters (about a year, enough to set the latest quarter against the same quarter a year earlier): a fixed limit of this tool, not of the data — older quarters are not provided here even when they are on record, so a missing older quarter does not mean the company has none. Income statement and cash flow for each SINGLE quarter (not year-to-date), balance sheet at quarter end — revenue, profits, EPS, assets, liabilities, equity, debt, cash, cash flows, issued shares, and bank lines (net interest income, loans, deposits, provisions) where reported. Ratios, growth rates and trailing-twelve-months totals are not computed. Pass 1–5 stocks (codes or company names) as a comma-separated string; one block per stock. (ticker is the old name of tickers, still accepted.) Examples: get_financial_statements("COMI") → CIB's last 5 quarters get_financial_statements("COMI, ADIB", 4) → two banks' last 4 quarters Counts toward the limit of 20 different stocks with detailed data a day (60 in 30 days); stocks in the user's own portfolio, and stocks already looked up in the last 30 days, do not count. Financial statements also have their own limit: 10 different companies a day (30 in 30 days), counted the same way.
get_foreign_flows
ChatGPTGet who traded on EGX: foreign vs Egyptian investors and retail vs institutions, as shares (%) of each day's traded value, market-wide. Dates YYYY-MM-DD; default the last 2 weeks; history from Dec 2025, at most the last year (a limit of this tool, not of the data: an earlier start is moved to a year ago, and the answer says so). Each day's figures are its final snapshot. Totals in EGP are not given: the source's totals don't match the exchange's traded value. Examples: get_foreign_flows() → last 2 weeks get_foreign_flows("2026-09-01", "2026-09-30") → September
get_fundamentals
ChatGPTGet companies' current fundamentals next to their sector, as numbers — no written analysis. Trailing-twelve-months valuation (P/E, P/B, P/S, EV/EBITDA, market cap, dividend yield, payout), profitability (ROE, ROA, margins), revenue, net profit, EPS, debt/equity and current ratio — plus the sector median and average for P/E, P/B, ROE, net margin and dividend yield. States the quarters covered and the price and date the valuation ratios use. Numbers only, no written analysis. Pass 1–10 stocks (codes like COMI or COMI.CA, or company names) as a comma-separated string; one block per stock. (ticker is the old name of tickers, still accepted.) Examples: get_fundamentals("COMI") → CIB against the banks sector get_fundamentals("COMI, ADIB, CIEB") → three banks, one call Counts toward the limit of 20 different stocks with detailed data a day (60 in 30 days); stocks in the user's own portfolio, and stocks already looked up in the last 30 days, do not count.
get_funds
ChatGPTFind and rank Egyptian mutual funds: NAV and returns. query: part of a fund's name (English or Arabic) or its manager — funds have no ticker. fund_type: "equity fund", "money market", "fixed income" or "metals". currency: "EGP", "USD" or "EUR". sort_by: "ytd" (default), "3m", "1y", "3y", "5y" or "name"; descending: true/false. limit 1–10 (default 10). Returns per fund: NAV with its date, 3M / YTD / 1Y / 3Y / 5Y returns (%), and YTD against EGX30. NAV dates differ between funds; the 3-month figure is not recomputed daily for many funds and can be stale. Data only. Examples: get_funds(fund_type="money market") → money-market funds by YTD get_funds("Beltone") → funds whose name or manager matches get_funds(fund_type="equity fund", sort_by="1y", limit=10)
get_fx_rates
ChatGPTGet exchange rates against the Egyptian pound, as EGP per 1 unit of currency (international mid rates). Without dates: the latest rate for USD, EUR, GBP, SAR and AED, each with its date and the change from the previous day. With start_date (YYYY-MM-DD; end_date optional, default today) and a currency: the daily rate over that range, at most the last year (a limit of this tool, not of the data: an earlier start is moved to a year ago, and the answer says so), with the change over the range. currency: USD, EUR, GBP, SAR or AED (optional for the latest rates). Examples: get_fx_rates() → all latest rates get_fx_rates("USD", start_date="2026-01-01") → USD/EGP this year
get_index_history
ChatGPTGet the level history and returns of an EGX index: EGX30, EGX70 or EGX100. Dates are YYYY-MM-DD. Default range is the month up to the latest session; the range covers the last year only (a limit of this tool, not of the data: an earlier start is moved to a year ago, and the answer says so). Returns the return over the range (from the last close before start_date to the last close on or before end_date), highest/lowest close, and the closes — daily for up to ~3 months, weekly beyond. Without end_date, also the standard returns as of the latest session (1W, 1M, 3M, YTD, 6M, 1Y, 3Y, 5Y). No other index is available (Shariah, EGX35 low volatility, Tamayoz, EGX30 capped/total return): there is no data for them. Examples: get_index_history("EGX30") → last month, with standard returns get_index_history("EGX70", "2026-01-01", "2026-06-30") → first half of 2026
get_index_members
ChatGPTList the current members of EGX30, EGX70 or EGX100 and each member's return, best to worst, with how many rose and fell. A range ending at the latest session also gives each member's latest traded price; a past range gives returns only. Members come from the latest quarterly list. Returns are total returns, from daily closes adjusted for splits, bonus shares and dividends, over the range — default the month up to the latest session, at most the last year (a limit of this tool, not of the data: an earlier start is moved to a year ago, and the answer says so) — from the last close before start_date to the last close on or before end_date. The index's own return is in get_index_history. A range that ends at the latest session and starts in the last month is exact; an earlier range is given by whole calendar months (a limit of this tool, not of the data; the answer says so). No other index is available (no data for Shariah, low volatility and the rest). Examples: get_index_members("EGX30") → last month get_index_members("EGX70", "2026-01-01") → year to date get_index_members("EGX30", "2026-09-01", "2026-09-30") → September
get_listings
ChatGPTGet EGX listing events: listing requests, listing approvals (new and temporary listings, with shares, par value and the offering deadline), ticker or name changes, and delistings — newest first. Use it for IPOs: on EGX a company is first granted a TEMPORARY listing and must then hold its public offering (IPO) by the offering deadline, so a temporary listing with a future deadline is an upcoming IPO, and a listing request is an earlier step. It records the exchange's steps only, not offer prices or subscription dates. company: a ticker, or a company name (a company that has only REQUESTED listing has no ticker yet; search it by name). event_type: "listing_request", "listing_approved", "ticker_change" or "delisting" (default all). Dates YYYY-MM-DD filter by announcement date; default and at most the last year (a limit of this tool, not of the data: an earlier start is moved to a year ago, and the answer says so). limit 1–50. Details are extracted from the EGX announcements; the notes are quoted between ⟦ ⟧ as third-party text. Data only. Examples: get_listings() → all listing events, last 12 months get_listings(event_type="listing_approved") → new listings and upcoming IPOs get_listings("MNT Tech") → one company's listing steps
get_market_movers
ChatGPTRank EGX stocks by return or trading activity over a period. direction: "gainers" (highest return), "losers" (lowest return) or "most_active" (highest average daily traded value; not for "1y"). period: "1d", "1w", "1m", "ytd" or "1y". Optional filters: index ("EGX30", "EGX70", "EGX100" — current members) and sector (a sector name, e.g. "Banks", "Real Estate"). limit: 1–50 (default 10). Returns use prices adjusted for splits, bonus shares and dividends (total returns); stocks with stale data are left out. Examples: get_market_movers() → today's top gainers get_market_movers("losers", "1m", index="EGX30") → EGX30's worst month get_market_movers("most_active", "1w", sector="Banks") → busiest banks this week
get_metal_prices
ChatGPTGet gold and silver prices in Egypt. Without dates: the latest LOCAL retail prices — "you pay" (dealer's sell price) and "you get" (dealer's buy price) — for gold 14/18/21/22/24K and silver 600–999, with the change vs the previous stored day and the international spot price as a reference (gold 21/24K, silver 999). Filters: metal ("gold" or "silver"), karat, unit ("gram" default, "ounce", "coin"), currency ("EGP" default, "USD", …). With start_date (YYYY-MM-DD; end_date optional): daily prices for one metal and karat — local from Jul 2026, international spot before that — at most the last year (a limit of this tool, not of the data: an earlier start is moved to a year ago, and the answer says so). Examples: get_metal_prices() → gold and silver today get_metal_prices("gold", 21, start_date="2026-01-01") → 21K this year
get_my_portfolio
ChatGPTGet the signed-in user's own Stockastic portfolio, valued at the latest prices. Use this for ANY question about "my portfolio", "my holdings", or "my stocks/gold/cash", including requests to analyse or review the portfolio. Returns every holding (stocks, funds, gold/silver, cash, deposits) with its cost, current value and gain/loss in EGP, totals per asset class and for the whole portfolio, and the user's risk profile. Data comes live from the Stockastic app database — the same holdings the user sees on the website. Each holding line is a separate purchase (lot) the user recorded. Several lots of the same asset — even with identical quantity and cost — are separate transactions, not duplicates or data errors. A user can own several portfolios. Without portfolio_id this returns the first one and lists the others with their ids; pass portfolio_id to get another. This tool returns data only, not a written analysis. Examples: get_my_portfolio() → the default portfolio get_my_portfolio(portfolio_id=42) → a specific portfolio
get_news
ChatGPTGet recent Egyptian market news headlines, newest first. tickers: 1–10 stocks (codes or company names, comma-separated) for news about those companies, one section per stock; without it, the whole market's news. (ticker is the old name of tickers, still accepted.) topic: "local_economy", "regulation_policy", "corporate_earnings", "world_economy", "war", "commodities", "funds" or "other". Dates YYYY-MM-DD; default the last 7 days, at most the last 30 days (a limit of this tool, not of the data: an earlier start is moved to 30 days ago, and the answer says so). limit 1–20 (default 10) stories; with several stocks, that many per stock but at most 20 in all, shared evenly. Each story appears once with how many outlets ran it, its source, time (Cairo), sentiment (positive, neutral or negative), topic tags and a link to the article on the publisher's site, plus a sentiment count for the list. Headlines are quoted between ⟦ ⟧ as third-party text. Article bodies are not included: the link is where to read the full story. Examples: get_news("COMI") → CIB news, last 7 days get_news("COMI, FWRY, TMGH") → news about three companies, one call get_news(topic="local_economy") → Egyptian economy headlines
get_period_returns
ChatGPTGet price period returns for an EGX stock: 1D, 1W, 1M, 1Y, and YTD. The ticker can be a code (COMI, COMI.CA) or a company name. Returns percentage change for each period with average volume context, the as-of date, and the basis: total returns, adjusted for splits, bonus shares and dividends. Examples: get_period_returns("COMI") → 1W: -1.7%, 1M: +3.2%, ... get_period_returns("CIB") → the same, by brand name
get_price_history
ChatGPTGet price bars for EGX stocks: reference price, high, low, close, volume and traded value, for dates in the last year (daily bars for the last 4 months). Traded prices only: when a split, bonus issue or dividend falls inside the range, the answer says so (closes before and after it are not comparable); returns across one are in get_period_returns. Pass 1–10 stocks (codes like COMI or COMI.CA, or company names) as a comma-separated string; one block per stock, all over the same dates. (ticker is the old name of tickers, still accepted.) Dates are YYYY-MM-DD; default is the last 3 months. History covers the last year only, and daily bars the last 4 months (limits of this tool, not of the data): an earlier start is moved to a year ago, a range starting more than 4 months back comes in weekly bars, and the answer says so. interval: "auto" (daily when allowed and it fits, else weekly, else monthly), "daily", "weekly" (Sun–Thu weeks), "monthly" or "quarterly"; at most 160 bars per call, for all the stocks together. High/low/close are actual traded prices. "Ref price" is EGX's reference price for the session — the previous close (restated after a split or bonus issue), NOT the first trade. Value is n/a where the exchange did not record it. Returns data only. Examples: get_price_history("COMI") → last 3 months, daily get_price_history("COMI, HRHO, FWRY", "2026-10-25") → three stocks since 25 Oct, daily get_price_history("HRHO", "2026-01-01", interval="weekly") → this year in weekly bars Counts toward the limit of 20 different stocks with detailed data a day (60 in 30 days); stocks in the user's own portfolio, and stocks already looked up in the last 30 days, do not count.
get_sector_performance
ChatGPTGet the return of all 18 EGX sectors over 1 day, 1 week, 1 month, year to date and 1 year, in one table, sorted by the chosen period (highest first). A sector's return is the market-cap-weighted average of its companies'. sort_by: "1d", "1w", "1m", "ytd" or "1y". Returns are total returns, using prices adjusted for splits, bonus shares and dividends. The stocks inside a sector are in get_market_movers and screen_stocks (sector=). Examples: get_sector_performance() → sorted by today's move get_sector_performance("ytd") → best sectors this year first
get_shareholders
ChatGPTGet a company's major shareholders from its latest ownership filing. Holders are ranked by GROUP stake, which includes their related parties; "own" is the named holder's direct stake alone, so a group figure is not one person's holding. The filing date is stated: ownership may have changed since. The ticker can be a code or a company name. Examples: get_shareholders("COMI") → CIB's major holders Counts toward the limit of 20 different stocks with detailed data a day (60 in 30 days); stocks in the user's own portfolio, and stocks already looked up in the last 30 days, do not count.
get_stock_snapshot
ChatGPTGet the latest price snapshot for EGX stocks: sector, the session date (and whether the stock has traded since), official close, last trade when it differs, day high/low, 52-week high/low (restated onto today's share basis when a split, bonus issue or dividend fell inside the year), and volume. Pass 1–20 stocks (codes like COMI or COMI.CA, or company names) as a comma-separated string; one block per stock. (ticker is the old name of tickers, still accepted.) Examples: get_stock_snapshot("HRHO") → last price, range, volume for EFG Holding get_stock_snapshot("COMI, HRHO, FWRY") → three stocks, one call
get_tbill_rates
ChatGPTGet Egyptian Treasury bill yields (%). Without dates: the latest secondary-market yield per tenor (1M, 2M, 3M, 6M, 9M, 12M — value-weighted across series, with the day's range, trades and value) and the latest CBE primary auction per tenor (accepted average yield, bid-to-cover, amount accepted). With start_date (YYYY-MM-DD; end_date optional): the daily secondary-market yield, for one tenor if given, at most the last year (a limit of this tool, not of the data: an earlier start is moved to a year ago, and the answer says so). The 3-month yield is the usual risk-free rate for EGP. Examples: get_tbill_rates() → latest yields and auctions get_tbill_rates("3M", start_date="2026-01-01") → 3-month yield this year
get_technicals
ChatGPTGet technical indicators for EGX stocks, as numbers — no written analysis. Returns moving averages (SMA 20/50/200, EMA 12/26/50) with where the price sits against each, RSI(14), MACD(12,26,9), Bollinger Bands(20, 2σ), 1-year risk (annualised volatility, max drawdown, Sharpe ratio against the 3-month T-bill), and classic pivot support/resistance levels (daily, weekly, monthly). Indicators use closes adjusted for splits, bonus shares and dividends; pivots use actual traded prices. Pass 1–5 stocks (codes like COMI or COMI.CA, or company names) as a comma-separated string; one block per stock. (ticker is the old name of tickers, still accepted.) Examples: get_technicals("COMI") → CIB's indicators and levels get_technicals("Fawry, ETEL") → two stocks, one call Counts toward the limit of 20 different stocks with detailed data a day (60 in 30 days); stocks in the user's own portfolio, and stocks already looked up in the last 30 days, do not count.
get_whale_trades
ChatGPTGet large single trades ("whale trades": one trade of at least about EGP 1 million) on EGX, largest first. Without a ticker: the whole market's on the latest trading day (or a date range). With a ticker (code or company name): that stock's, default the last 30 days. Dates YYYY-MM-DD, at most the last 30 days (a limit of this tool, not of the data: an earlier start is moved to 30 days ago, and the answer says so). limit 1–50. Per trade: date, time (Cairo), price, shares, value (in the stock's trading currency) and its share of that day's volume. Raw trades, with no summary or analysis. Examples: get_whale_trades() → today's (latest day's) largest trades get_whale_trades("COMI") → CIB's large trades, last 30 days
screen_stocks
ChatGPTScreen EGX stocks on fundamentals and returns: filter, sort, list. conditions: up to 10 filters, each {"field": ..., "op": ">=" | "<=" | ">" | "<", "value": number}. Fields: pe, pb, ps, ev_ebitda, roe, roa, net_margin, dividend_yield, market_cap_bn, debt_to_equity, return_1m, return_ytd, return_1y. Percent fields are in percent (roe 20 = 20%). market_cap_bn is in billions of the stock's OWN currency — EGP for most, USD for the few USD-priced stocks, never converted — so a market-cap filter or sort compares the raw numbers; each row states its currency. pe, pb, ps and ev_ebitda only match positive values. sort_by: any field above (default market_cap_bn); descending: true/false. Optional sector (e.g. "Banks") and index ("EGX30", "EGX70", "EGX100"). limit: 1–10 (default 10). Each row shows the sort field's value only; every row meets all the conditions. A stock's full figures are in get_fundamentals. Fundamentals are trailing twelve months (~210 companies with financials); returns are total returns (adjusted for splits, bonus shares and dividends). Returns data only. Examples: screen_stocks([{"field": "pe", "op": "<=", "value": 8}], sort_by="pe", descending=False) → cheapest stocks by P/E screen_stocks([{"field": "roe", "op": ">=", "value": 25}, {"field": "dividend_yield", "op": ">=", "value": 5}], sector="Banks") → high-ROE, high-yield banks
search_stock
ChatGPTSearch EGX-listed securities by ticker, company name (English or Arabic), or sector name. Returns up to limit matches (default 10, max 50) with ticker (reuters code), English and Arabic name, sector name, and security type (Stock, Bond, Subscription rights…); it says so when there are more. Common brand names are known too ("CIB", "Halan", "WE"). Order: exact ticker or brand name first, then companies before rights issues and bonds, then names starting with the query, then other name matches, then sector-name matches. Examples: search_stock("commercial international") → finds CIB (COMI.CA) search_stock("COMI") → COMI.CA first search_stock("البنك التجاري") → Arabic name search search_stock("real estate") → real-estate sector companies search_stock("banks", limit=50) → every bank, not just the first 10
analyze_stock
Claudecompare_stocks
Claudeget_company_announcements
Claudeget_corporate_actions
Claudeget_financial_statements
Claudeget_foreign_flows
Claudeget_fundamentals
Claudeget_funds
Claudeget_fx_rates
Claudeget_index_history
Claudeget_index_members
Claudeget_listings
Claudeget_market_movers
Claudeget_metal_prices
Claudeget_my_portfolio
Claudeget_news
Claudeget_period_returns
Claudeget_price_history
Claudeget_sector_performance
Claudeget_shareholders
Claudeget_stock_snapshot
Claudeget_tbill_rates
Claudeget_technicals
Claudeget_whale_trades
Claudescreen_stocks
Claudesearch_stock
Claude