- market_status(): Is the Tehran market open right now? Tehran time, session hours, bourse state and totals (وضعیت بازار).
- market_overview(market): Index value, equal-weight index, total value/volume/trades and market cap for the market (نمای کلی بازار). [market: 'bourse' or 'fara']
- indices(market, only_headline): All indices: total, equal-weight, free-float and every industry index with change % (شاخص‌ها و شاخص صنایع). [market: 'bourse' or 'fara'; only_headline: Skip the ~50 industry indices]
- market_watch(market, security_type, industry, board, min_value, only_traded, sort_by, descending, limit, detail): Whole-market screen (دیده‌بان بازار): filter, sort and page through every listed instrument in one call. [market: 'bourse' or 'fara' (Fara Bourse). Omit for both where applicable.; security_type: Substring filter, e.g. 'سهام' (stocks), 'صندوق' (funds), 'اوراق'; industry: Industry name substring, e.g. 'فلزات', 'بانک'; board: Board substring, e.g. 'اول', 'دوم', 'نوآفرین'; min_value: Minimum traded value in rial; sort_by: last_pct, close_pct, value, volume, trades, market_cap, pe, effect_on_index; detail: 'compact' (default) or 'full' (every field incl. best bid/ask, limits, EPS)]
- top_movers(kind, market, security_type, limit): Ranked lists: top gainers/losers, most traded, buy/sell queues (صف خرید/فروش), real-person money inflow/outflow (ورود/خروج پول حقیقی), buyer power. [kind: gainers, losers, value, volume, trades, buy_queue, sell_queue, real_inflow, real_outflow, real_buyer_power; market: 'bourse' or 'fara' (Fara Bourse). Omit for both where applicable.; security_type: Substring filter, default 'سهام' (stocks)]
- industry_summary(market): Per-industry breakdown: traded value, average and cap-weighted change, index effect, queue counts (گروه‌های صنعتی). [market: 'bourse' or 'fara' (Fara Bourse). Omit for both where applicable.]
- index_contributors(limit): Stocks pushing the total index up or down the most, in index points (بیشترین تاثیر بر شاخص).
- market_snapshot(date*, sort_by, limit, security_type): End-of-day table for every instrument on a past date (تاریخچه کل بازار در یک روز). [date: Gregorian or Jalali date of a past trading day; sort_by: value, volume, trades, change_pct; security_type: stock, fund or bond]
- market_holder_moves(limit): Large holders whose positions changed most over the last 5 reported days, market-wide (تغییرات سهامداران عمده).
- supervisor_messages(symbol, limit, full_text, market): Exchange supervisor notices (پیام ناظر): trading restrictions, clarifications, halts. [symbol: Symbol, or omit for market-wide messages; market: 'bourse' or 'fara' (when no symbol)]
- search_symbol(query*, limit): Find instruments by symbol or name fragment; returns symbol, name, market, board, insCode (جستجوی نماد).
- symbol_overview(symbol*): One-call dossier for a symbol: identity, quote, order book, real/legal flow, top shareholders, latest Codal filings and supervisor notices. Start here. [symbol: Persian symbol such as 'فولاد', or an insCode]
- quote(symbol*): Live/last quote with correct change %, volume, value, VWAP, price limits, ranges, P/E and market cap (قیمت لحظه‌ای). [symbol: Persian symbol such as 'فولاد', or an insCode]
- order_book(symbol*): Five-level order book (عمق بازار) with order counts, imbalance and buy/sell queue (صف) detection. [symbol: Persian symbol such as 'فولاد', or an insCode]
- order_book_history(symbol*, date, from_time, to_time, step_seconds): Intraday order-book evolution rebuilt from every event: sampled depth plus buy/sell queue episodes with peak sizes (تاریخچه صف خرید و فروش). [symbol: Persian symbol such as 'فولاد', or an insCode; date: Gregorian 2026-11-03 / 20261103 or Jalali 1405/08/12. Omit for the latest trading day.; from_time: HH:MM[:SS] Tehran time; to_time: HH:MM[:SS] Tehran time; step_seconds: Sampling step]
- trades(symbol*, date, from_time, to_time, min_volume, limit, newest_first): Raw tick-by-tick trades (ریز معاملات) with time, price, volume, value. Filter by time and size; prefer trade_summary for analysis. [symbol: Persian symbol such as 'فولاد', or an insCode; date: Gregorian 2026-11-03 / 20261103 or Jalali 1405/08/12. Omit for the latest trading day.; from_time: HH:MM[:SS]; to_time: HH:MM[:SS]; min_volume: Only trades with at least this many shares]
- trade_summary(symbol*, date, from_time, to_time, interval_minutes): Aggregate a day's ticks: intraday bars, VWAP, biggest trades, volume by price level, tick-rule pressure estimate, and a completeness check against official totals. [symbol: Persian symbol such as 'فولاد', or an insCode; date: Gregorian 2026-11-03 / 20261103 or Jalali 1405/08/12. Omit for the latest trading day.; from_time: HH:MM[:SS]; to_time: HH:MM[:SS]]
- price_history(symbol*, from_date, to_date, limit, adjusted): Daily OHLCV history since listing, optionally adjusted (تاریخچه قیمت). [symbol: Persian symbol such as 'فولاد', or an insCode; from_date: Range bound: Gregorian 2026-11-03 / 20261103 or Jalali 1405/08/12. Omit for no bound.; to_date: Range bound: Gregorian 2026-11-03 / 20261103 or Jalali 1405/08/12. Omit for no bound.; adjusted: Back-adjust for capital increases/dividends (تعدیل شده)]
- real_legal_flow(symbol*, days): Real vs legal buying/selling (حقیقی و حقوقی): counts, per-capita, buyer power, net money flow, with daily history. [symbol: Persian symbol such as 'فولاد', or an insCode; days: How many past trading days of history to add (0 = latest session only)]
- shareholders(symbol*): Major shareholders (سهامداران عمده) with shares, percent and the holder_id for deeper lookups. [symbol: Persian symbol such as 'فولاد', or an insCode]
- shareholder_history(symbol*, date): Dated major-holder snapshots for a symbol with computed changes between snapshots. [symbol: Persian symbol such as 'فولاد', or an insCode; date: Gregorian 2026-11-03 / 20261103 or Jalali 1405/08/12. Omit for the latest trading day.]
- shareholder_portfolio(holder_id*): Everything else that major holder owns across the market (پرتفوی سهامدار). [holder_id: holder_id from shareholders]
- corporate_actions(symbol*): Capital increases and price adjustments (افزایش سرمایه، تعدیل قیمت) with dates and factors. [symbol: Persian symbol such as 'فولاد', or an insCode]
- symbol_statistics(symbol*): Exchange-computed averages and stats for the symbol (e.g. average traded value over 3 months). [symbol: Persian symbol such as 'فولاد', or an insCode]
- etf_nav(symbol*): Fund/ETF issue and redemption NAV vs market price: premium/discount (صدور و ابطال). [symbol: Persian symbol such as 'فولاد', or an insCode]
- codal_filings(symbol, from_date, to_date, title_contains, category, letter_type, limit, page): Search Codal disclosures (کدال): title, publish time, tracing number and links to the page, PDF, Excel and attachments. [symbol: Symbol, or omit for all companies; from_date: Range bound: Gregorian 2026-11-03 / 20261103 or Jalali 1405/08/12. Omit for no bound.; to_date: Range bound: Gregorian 2026-11-03 / 20261103 or Jalali 1405/08/12. Omit for no bound.; title_contains: Client-side title filter, e.g. 'صورت‌های مالی', 'افزایش سرمایه', 'فعالیت ماهانه'; category: Codal category id, -1 for all; letter_type: Codal letter type id, -1 for all]
- codal_company(symbol*): Issuer profile from Codal: CEO, ISIC, address, activity description (اطلاعات ناشر). [symbol: Persian symbol such as 'فولاد', or an insCode]
- glossary(term): Explain Iranian market terms (صف خرید، سرانه خرید، حقیقی/حقوقی، دامنه نوسان …) so answers use them correctly. [term: Persian or English term; omit to list all]