akdAt
ChatGPTReturns broker transaction volume (AKD - Aracı Kurum Dağılımı) data for specified symbols or broker codes and date. Supports optional sorting in akdItem list using sortby and sortorder parameters. - sortby: Selects which numeric akdItem field to sort by. - sortorder: Sort direction, asc or desc (default: desc). - limit: Returns only the first N records from akdItem after sorting (optional). - codes: accepts symbol code/legacy code (GARAN, GARAN.E.BIST) and broker code/legacy code (BMK, BMK.B). - inputType (required): "symbol" | "broker". Use this to explicitly choose direction. - inputType=symbol: akdItem rows are brokers and brokerName is broker legal name. - inputType=broker: akdItem rows are symbols and brokerName is symbol display name (fallback: symbol code). When ranking top buyers or sellers, use sortby: NetAmount and sortorder: desc. Example (symbol -> brokers): codes: [GARAN], inputType: symbol, type: E, at: 20250118 Example (broker -> symbols): codes: [CIM], inputType: broker, type: E, at: 20250118 Note: No data for weekends Output: { "akdItem": [ { "brokerName": "GARAN", "TotalBuyVolume": 0, "TotalBuyAmount": 0, "TotalSellVolume": 0, "TotalSellAmount": 0, "BuyPrice": 0, "NetAmount": 0, "NetVolume": 0, "Cost": 0, "SellPrice": 0, "TotalAmount": 0, "TotalVolume": 0 } ], "GrandNetVolume": 0, "GrandNetAmount": 0, "GrandBuyAmount": 0, "GrandSellAmount": 0, "GrandBuyVolume": 0, "GrandSellVolume": 0, "GrandTotalVolume": 0, "GrandTotalAmount": 0 }
analystData
ChatGPTReturns analyst forecast and broker model portfolio data for BIST securities. type="forecast" — Analyst target price forecasts: - mode="averages": Consensus target prices (lowest/average/highest) and buy/sell/hold counts per symbol. - mode="detail": Target price forecasts filtered by broker and/or symbol. - mode="history": Historical price target revisions by broker for a symbol. type="portfolio" — Broker model portfolios: - mode="averages": Broker consensus target prices (lowest/average/highest) and analyst count per symbol. - mode="list": Target prices and portfolio weights filtered by broker, symbol, or both. - mode="updates": Recent broker model portfolio changes. last must be 1, 7, 14, or 30 days; default is 7. Client-side response reduction is applied after normalization and does not change the upstream request: filter selects rows by fields, limit caps rows after filtering, and calculate returns an aggregate or selected row using sum, count, min, max, avg, first, or last. Numeric calculations require field, for example {function: "avg", field: "targetPrice"}; multiple operations and groupBy are supported in order filter → limit → calculate. For keyed multi-symbol responses, transformations apply independently to each symbol's array and preserve symbol keys. The existing last parameter in portfolio updates remains its upstream day-window control; use limit for local output reduction. Examples: - Forecast averages: type: "forecast", mode: "averages", symbolCodes: ["GARAN", "THYAO"] - Forecast detail: type: "forecast", mode: "detail", brokerCode: "ACP", symbolCode: "GARAN" - Forecast history: type: "forecast", mode: "history", brokerCode: "FNY", symbolCode: "GARAN" - Portfolio averages: type: "portfolio", mode: "averages", symbolCodes: ["GARAN", "ASELS"] - Portfolio list: type: "portfolio", mode: "list", symbolCode: "GARAN" - Portfolio updates: type: "portfolio", mode: "updates", last: 7 Time zone: Europe/Istanbul.
balanceSheets
ChatGPTReturns balance sheet line items (assets, liabilities, equity) for the most recent periods. Period discovery uses the balance sheet nature endpoint; returns up to the requested limit per symbol. Example: balanceSheets with codes: ["GARAN", "ASELS"], limit: 4, consolidated: true — parallel execution.
brokerActivity
ChatGPTReturns historical settlement (takas/custody) positions for BIST symbols. Use mode "at" for one date or "last" for recent days. The optional rc parameter filters the response to specific broker/institution codes; it does not provide order-book depth. Example: { mode: "at", codes: ["GARAN"], at: "20250110", rc: ["CIY.B"] }. Time zone: Europe/Istanbul.
brokerDefinitions
ChatGPTResolves one or more broker codes to full brokerage firm records: BrokerId, BrokerCode, BrokerShortName, BrokerName, BrokerLegacyCode, BrokerType, BrokerStatus. Matches both internal codes (GDK) and legacy codes (GDK.B). Example: brokerDefinitions with brokerCodes: ["GDK", "FNY.B"] Use when you have broker codes from settlementAt, akdAt, or transaction and need their names.
cashFlows
ChatGPTReturns cash flow statement line items (operating/investing/financing activities) with description, value, and lineCodeId. Periods discovered from balance sheet nature endpoint; returns up to the requested limit per symbol. Example: codes: ["GARAN", "ASELS"], limit: 4, consolidated: true — parallel execution.
changeStatisticsMulti
ChatGPTReturns percentage and nominal price changes across multiple timeframes (daily, weekly, monthly, 3M, 6M, YTD, 1Y, 3Y, 5Y, all-time). Example: changeStatisticsMulti with codes: ["GARAN", "ASELS"]
chart
ChatGPTGenerates PNG chart images from historical price data using Canvas. Returns: PNG image as base64 encoded data via MCP image response. Chart Types: line, area, column, bar, pie Data Source: Uses historicalLast or historicalFromTo based on parameters Limitation: Supports up to 10 unique codes per request. Example usage: - Line chart with last 100 candles: chart with codes: [GARAN], chartType: line, resolution: 1440, last: 100 - Multiple symbols area chart: chart with codes: [GARAN, ASELS], chartType: area, resolution: 1440, from: 20241101000000, to: 20250101000000
companyInfos
ChatGPTReturns detailed company profile: BistCode, IpoDate, EstablishmentDate, Phone, FieldOfActivity, RegisteredCapital, GeneralManager, NumberOfEmployee, Address, Website, BoardMembers, CompanyName, Partners (subsidiaries with ownership %), Shareholders (major shareholders with %), ExchangePosition (FX assets/liabilities/net position). Example: companyInfos with codes: ["GARAN", "ASELS", "THYAO"] — parallel execution.
corporateActions
ChatGPTReturns corporate actions data: splits, dividends, rights issues, and future scheduled events. Types: - "historyByCode": Historical corporate actions for specified symbols. Fields: Date, Code, RightsIssuePercent, BonusIssuePercent, DividendPercent, GrossDividendAmount, NetDividendAmount, AdjustmentRatio. - "historyByDate": Corporate actions within a date range. Fields: Date, SymbolCode, RightIssuesPercent, BonusIssuesPercent, DividendPercent, GrossDividendAmount, NetDividendAmount, SplitRatio, SplitStatus, Exchange. Exchange can be BIST, CSE, or ATHEX. - "future": Future scheduled stock splits. Omit codes to return all symbols; when codes are provided the result is keyed by input code. Fields: symbolCode, announcementDate, isExecuted, rightsIssuePercent, bonusIssuePercent, otherRightsPercent, dividendPercent, isSpkApproved, futureCapital, currentCapital, effectiveDate, rightsDate, bonusDate, scripDate, otherRightsDate. - "dividendChamps": Top 20 BIST stocks by dividend yield per year. History GrossDividendAmount and NetDividendAmount are amounts, not percentages; null means unavailable. Client-side response reduction is applied after normalization and does not change the upstream request: filter selects rows by fields, limit caps rows after filtering, and calculate supports sum, count, min, max, avg, first, or last. Numeric calculations require field, for example {function: "avg", field: "DividendPercent"}; multiple operations and groupBy are supported in order filter → limit → calculate. For keyed symbol responses, transformations apply independently to each symbol's array and preserve symbol keys. Examples: - By code: type: "historyByCode", codes: ["GARAN", "ASELS"] - By date: type: "historyByDate", from: "20240101", to: "20241231", exchange: "BIST" - Future: type: "future", codes: ["GARAN"] — or omit codes for all symbols - Dividend champs: type: "dividendChamps", from: 2023, to: 2024 Time zone: Europe/Istanbul.
depths
ChatGPTReturns market depth (order book) data for given symbols via socket snapshot. Field Reference: - Bid: b0-b9 (prices), q0-q9 (lots), v0-v9 (amounts), bg (weighted avg), bl (total) - Ask: a0-a9 (prices), k0-k9 (lots), w0-w9 (amounts), ag (weighted avg), al (total) - Level 0 = best price, Level 9 = furthest from market Example: depths with codes: ["GARAN", "ASELS", "THYAO"]
dividendChamps
ChatGPTReturns top 20 BIST stocks by dividend yield (%) per year within a specified year range. Example: dividendChamps with from: 2023, to: 2024
economicCalendar
ChatGPTReturns economic calendar events: date, country, event name, importance level (1-3), and actual/forecast/previous values. Filters by country code (default: TR). Date format: YYYYMMDDHHmmss. Example: economicCalendar with countryCode: "US", from/to for date range.
fieldSearch
ChatGPTResolve the exact field short codes that the marketData tool's fields parameter expects. Full-text search over the live ForInvest field dictionary (short code ↔ English field name, e.g. l → Last, C → DailyChangePercent, pE → PriceEarning, s1 → SMA(5), DE → Delta). Why this tool exists: marketData.fields takes short codes (e.g. ["l", "C", "tV"]), NOT human-readable names. Field codes are opaque and must never be guessed. Call fieldSearch to discover the correct code for the metrics you need, then pass those codes to marketData. Search in English only: the field dictionary is indexed in English (field names/labels are English regardless of the user's language). Always translate the metric to its English term before searching — e.g. the user asking for "piyasa değeri" → search "market cap", "temettü verimi" → search "dividend yield", "fiyat kazanç" → search "price earning". Searching in Turkish (or any non-English language) returns no results. When to use: - Before calling marketData with any field beyond the common defaults, to resolve the metric name to its short code. - When the user asks for a specific metric (P/E, RSI, VWAP, market cap, a moving average, an option greek, order-book depth, etc.) and you need its field code. - Common defaults (l=Last, C=DailyChangePercent, tV=TotalVolume, E=Code, h=High, o=Open) are already known; you do not need fieldSearch for those. Parameters: - key (optional): A single search term — a metric name, keyword, or partial code (e.g. "price earning", "RSI", "VWAP", "delta", "SMA"). - keys (optional): Multiple search terms; the same where filter applies to all. Returns results grouped under "queries". - At least one non-empty term must be supplied via key or keys. - where (optional): { type } to narrow by value type (e.g. { "type": "NUMBER" }). Supported types: STRING, NUMBER, LONG, INT, TIME. - limit (optional, 1-50, default 15): Maximum matches to return per term. Returns: Matching fields with { shortCode, name, display, type }. Use the shortCode values in marketData.fields. A result may also carry scope: "stockScreener" — those are fundamental/meta fields (e.g. grossProfit, sector, ipoDate) that are NOT available through marketData; resolve and use them with the stockScreener tool instead. Results with no scope are live market-data fields usable in marketData.fields. Example queries: - "P/E ratio" → { "key": "price earning" } → finds pE (PriceEarning) - "RSI" → { "key": "RSI" } → finds r1 (RSI14) - "VWAP" → { "key": "VWAP" } → finds wa (VWAP) - "20-day moving average" → { "key": "SMA" } → finds s3 (SMA20) among SMA fields - "option delta" → { "key": "delta", "where": { "type": "NUMBER" } } → finds DE (Delta) - Multiple metrics at once → { "keys": ["market cap", "dividend yield", "book value"] } Time zone: Europe/Istanbul.
financialRatios
ChatGPTReturns financial ratio and fundamental analysis data. Modes: - "lastQuarter": Latest quarter metrics (NetProfit, EBITDA, ROA, ROE, debt ratios) per symbol. - "multiPeriod": Financial ratios across multiple quarters. Specify starting term and number of periods. - "snapshot": Real-time fundamental analysis metrics (P/E, P/B, EPS, dividend yield, market cap) per symbol. Examples: - lastQuarter: mode: "lastQuarter", codes: ["GARAN", "ASELS"] - multiPeriod: mode: "multiPeriod", codes: ["GARAN"], term: "2024-12", iry: 4 - snapshot: mode: "snapshot", codes: ["GARAN", "THYAO"] Time zone: Europe/Istanbul.
financialStatementDates
ChatGPTReturns financial statement announcement dates for BIST companies: SymbolCode, AnnouncementDate, Year, Period, IsConsolidated. Example: financialStatementDates with year: 2025, period: 1, last: 100
financialStatements
ChatGPTReturns financial statement data: balance sheet, income statement, or cash flow. - type "balance": Assets, liabilities, equity line items. Auto-discovers recent periods (use limit). - type "income": Revenue, expenses, net profit line items. Requires explicit term (e.g., "2024-12"). - type "cashFlow": Operating/investing/financing activities. Auto-discovers recent periods (use limit). Parameters: - codes: Symbol codes (parallel execution) - type: "balance" | "income" | "cashFlow" - consolidated: true (default) for consolidated statements - term: Required for income type. Format: "YYYY-M" (e.g., "2024-3", "2024-12") - limit: For balance/cashFlow — number of recent periods to return (default 4, max 20) Examples: - Balance: codes: ["GARAN"], type: "balance", limit: 4, consolidated: true - Income: codes: ["GARAN", "ASELS"], type: "income", term: "2024-12", consolidated: true - Cash Flow: codes: ["THYAO"], type: "cashFlow", limit: 4 Time zone: Europe/Istanbul.
forecastAverages
ChatGPTReturns analyst consensus target prices (lowest/average/highest) and buy/sell/hold recommendation counts per symbol. Example: forecastAverages with symbolCodes: ["GARAN", "THYAO"] — or omit symbolCodes for all symbols. Parallel execution.
forecastByBrokerOrSymbol
ChatGPTReturns target price forecasts filtered by broker and/or symbol: BrokerCode, SymbolCode, TargetPrice, TargetPriceDate, ForecastWeight. At least one of brokerCode or symbolCode must be provided. Example: forecastByBrokerOrSymbol with brokerCode: "ACP", symbolCode: "GARAN"
forecastHistory
ChatGPTReturns historical price target revisions by broker for a symbol: TargetPrice, PreviousTargetPrice, OpinionId (1=Sell, 2=Hold, 3=Buy), NewsContent. Example: forecastHistory with brokerCode: "FNY", symbolCode: "GARAN"
fundPortfolio
ChatGPTReturns licensed fund portfolio report data. Requires LIC_TEFASFUND_AND_EUROBOND. Modes: - mode="periods": Lists every available monthly portfolio report period for a fund. - mode="holdings": Returns all holdings for a monthly report. category can restrict asset groups; fundPeriod defaults upstream to the latest report. limit and sorting apply independently within each category. navWeight is the recommended client-facing weight. - mode="positionChanges": Compares the latest two consecutive reports and groups positions as increased, decreased, new, or exited. category=["stockDomestic"] is recommended for equity-focused views. Examples: - Available periods: { mode: "periods", fundCode: "IPJ" } - Latest holdings: { mode: "holdings", fundCode: "IPJ", category: ["stockDomestic"], sortBy: "navWeight", sortDirection: "DESC" } - A specific report: { mode: "holdings", fundCode: "IPJ", fundPeriod: "2026-07" } - Domestic stock changes: { mode: "positionChanges", fundCode: "IPJ", category: ["stockDomestic"], deltaType: ["increased", "decreased", "new", "exited"] } Time zone: Europe/Istanbul.
fundamentalAnalysisLast
ChatGPTCalculates fundamental analysis metrics (temel analiz) for one or multiple stock symbols. Returns per symbol: EarningsPerShare (HBK), PriceToEarningsRatio (F/K), FreeFloatMarketValue (FD), FreeFloatShareCount (FDH), FreeFloatPercentage (FDO), NetProfit (NK), NetDividend (NT), PriceToBookRatio (PD/DD), ReturnOnEquityPercentage (ROE), MarketCapitalization (PD), PublicShareCount (HH), NominalCapital (SN), PublicOfferingPercentage (HAO), ShareholdersEquity (ÖS), DividendYieldOnNominalPercentage (TP), DividendPayoutPercentage (TDO), ReportingPeriod. Example: fundamentalAnalysisLast with codes: ["GARAN", "THYAO"] — parallel execution.
futureSplit
ChatGPTReturns future stock split schedule: SymbolCode, AnnouncementDate, BonusIssuePercentage, RightsIssuePercentage, DividendPercentage, IsSpkApproved, FutureCapital, CurrentCapital, SplitEffectiveDate. Example: futureSplit with codes: ["GARAN", "ASELS"] — or omit codes for all symbols. Parallel execution.
globalMarket
ChatGPTGlobal Feed fundamental, analyst and technical data for US equities, addressed by ForInvest codes (e.g. "AAPL:EDGX"). Use for US company profiles/peers, financials, ownership, dividends, analyst recommendations/price targets/EPS, news sentiment, chart patterns, and exchange-based lists. Do NOT use for BIST/non-US markets, standalone symbol discovery (use symbolSearchFlex), or real-time quotes/price history. Actions: - companyProfile, peers — company info. - basicFinancials (requires metric, e.g. "all"); financials (requires statement: bs|ic|cf, and freq: annual|quarterly); ownership (exactly one code/symbol); dividends. - recommendation (company-specific analyst history); priceTarget (company price targets, NOT recommendation history); epsEstimate (requires freq); epsSurprises; newsSentiment. - patternRecognition (requires resolution, e.g. "5"); allPatternRecognition (one code/symbol, no resolution). - topPotential, analystRecommendation — exchange-based, require primaryExchange (e.g. "XNAS"), no codes/symbols. Note: recommendation (company) ≠ analystRecommendation (exchange). Input: For symbol-based actions provide either codes (exact codes like "AAPL:EDGX", sent as-is) OR symbols (tickers/names, resolved via us-equity CBOE/EDGX; ambiguous/no match fails — never guess, use symbolSearchFlex). ownership and allPatternRecognition take exactly one. Exchange-based actions take primaryExchange instead. limit trims local output only (1-1000; default 100 for ownership/analystRecommendation); ignored for actions that are not list-truncated. Responses are {data:[...]} (no-data/errors use standard MCP responses); list actions add meta {totalCount, returnedCount, truncated}. Time zone: Europe/Istanbul.
heatMap
ChatGPTReturns hierarchical XU100 index tree with nested sectors/subsectors. Each node: code, changePercentage, calculation (market value), childs array.
historicalData
ChatGPTReturns historical OHLCV price data for BIST and US market symbols, or tick-level trade data for parity symbols (forex, spot, indices/futures). Two modes: - Range mode (from + to): Returns candles within a date range. Use for exact calendar periods. - Last mode (last): Returns the most recent N candles/ticks. Use for "last 100 days" queries. Fields (candle): date (ISO 8601), open, high, low, close, volume, amount, weightedAvg, openInterest. Fields (tick): ISO timestamp, last price, bid, ask, amount. Use period: "tick" for forex pairs, spot, foreign indices/futures — NOT for BIST stocks. Response sizing for candles is automatic after local filter/limit: raw candles when the total across all symbols combined is ≤120 bars and the serialized JSON is ≤24000 characters. These thresholds apply to the whole response, not per symbol. If either threshold is exceeded, weekly/adaptive summaries with metadata are returned. Summary targets: 120 total bars across all symbols combined and 24000 serialized JSON characters. Max 10 codes per request. For indicators use technicalIndicator — never compute manually. Client-side response reduction is applied after normalization and does not change the upstream request: use filter for field conditions, limit for the maximum rows after filtering, and calculate for sum, count, min, max, avg, first, or last. Numeric calculations require field, for example {function: "avg", field: "volume"}. Multiple operations and groupBy are supported and run in order filter → limit → calculate. For multiple codes, operations apply independently to each symbol's returned array and preserve the symbol keys. The existing last parameter controls upstream retrieval/lookback; use limit for local output reduction. Parameters: - codes: Symbol codes (max 10, parallel execution) - period: "tick"/"1"/"5"/"15"/"30"/"60"/"1440" (daily)/"w"/"m"/"y". Default: "1440" - from/to: Date range in YYYYMMDDHHmmss format (range mode, not supported for tick) - last: Number of candles/ticks, max 260 for candles, max 1000 for tick (last mode). Examples: - Range: codes: ["GARAN", "ASELS"], period: "1440", from: "20241101000000", to: "20250101000000" - Last: codes: ["THYAO"], period: "1440", last: 100 - Intraday: codes: ["GARAN"], period: "5", from: "20260414094000", to: "20260414180000" - Tick: codes: ["EUR/USD", "USD/TRY"], period: "tick", last: 100 Time zone: Europe/Istanbul.
historicalFromTo
ChatGPTReturns historical OHLCV price data for specified symbol(s) within a date/time range. Usable for BIST and US markets. Fields: Timestamp, OpenPrice, HighPrice, LowPrice, ClosePrice, Volume, TradeAmount, WeightedAveragePrice, OpenInterest. Max 10 codes per request. Example: historicalFromTo with codes: ["GARAN", "ASELS"], period: "1440", from: "20241101000000", to: "20250101000000" — parallel execution.
historicalLast
ChatGPTReturns the last N historical OHLCV price entries for specified symbol(s). Usable for BIST and US markets. Fields: Timestamp, OpenPrice, HighPrice, LowPrice, ClosePrice, Volume, TradeAmount, WeightedAveragePrice, OpenInterest. Max 10 codes per request. Example: historicalLast with codes: ["GARAN", "ASELS"], resolution: "1440", last: 100 — parallel execution.
holidays
ChatGPTReturns BIST exchange holidays and early-close days with dates, status, and close time.
incomeStatements
ChatGPTReturns income statement line items (interest income/expense, fees, trading profit, operating income/expense, net profit, tax, EPS) with description, value, and lineCodeId. Example: incomeStatements with codes: ["GARAN", "ASELS"], consolidated: true, term: "2024-3" — parallel execution.
indicatorFromTo
ChatGPTReturns technical indicator calculations for a specified symbol within a given date range. Provides indicator values by providing code, time period, date range (from/to) and query parameters which include indicator parameters. Period Parameter Rules: - Supported values are positive integers in range 1-1440 and special values "w", "m", "y" - Minute periods between 1 and 60 are accepted (e.g., 1, 5, 7, 15, 30, 60) - Special values: "w" (week), "m" (month), "y" (year) - If period > 60, it must be divisible by 60 (e.g., 120, 240, 1440) Date Format: yyyyMMddHHmmss (e.g., 20251201000000) Indicator Stability Note: - Indicator values can vary when the requested date range is too narrow. - Expanding the from/to window generally stabilizes final indicator values (especially RSI/MACD family indicators). - Very short ranges may return null for some indicators (for example, RSI with period 14 often needs more than 14 bars). Indicator Parameter Syntax: Each indicator has specific parameter names. Format: "param1:value-param2:value" | Indicator | Parameters | Example | |-----------|------------|---------| | ADX | per (Period) | "per:14" | | ADXR | per (Period) | "per:14" | | APO | fast (Fast Period), slow (Slow Period) | "fast:12-slow:26" | | ARO | per (Period) | "per:25" | | ATR | per (Period) | "per:14" | | BOL | per (Period), devu (Upper Deviation), devd (Lower Deviation) | "per:20-devu:2-devd:2" | | CCI | per (Period) | "per:20" | | DEMA | per (Period) | "per:9" | | DX | per (Period) | "per:14" | | EMA | per (Period) | "per:9" | | ENVE | per (Period), perc (Percent) | "per:20-perc:2.5" | | ENVS | per (Period), perc (Percent) | "per:20-perc:2.5" | | ENVW | per (Period), perc (Percent) | "per:20-perc:2.5" | | MACD | fast (Fast Period), slow (Slow Period), sig (Signal Period) | "fast:12-slow:26-sig:9" | | MOM | per (Period) | "per:10" | | PPO | fast (Fast Period), slow (Slow Period) | "fast:12-slow:26" | | PVT | (value only, no params) | "classic", "camarilla", "fibonacci", "woodie" | | RSI | per (Period) | "per:14" | | SAR | acc (Acceleration), max (Maximum) | "acc:0.02-max:0.2" | | SMA | per (Period) | "per:20" | | STOCHRSI | fastk (Fast K), fastd (Fast D), per (Period) | "fastk:14-fastd:14-per:14" | | STOF | fastk (Fast K Period), fastd (Fast D Period) | "fastk:14-fastd:3" | | STOS | fastk (Fast K), slowk (Slow K), slowd (Slow D) | "fastk:14-slowk:3-slowd:3" | | T3 | per (Period), vfactor (Volume Factor 0-1) | "per:5-vfactor:0.7" | | TEMA | per (Period) | "per:9" | | TSF | per (Period) | "per:14" | | VOL | per (Period), dev (Deviation) | "per:20-dev:2" | | WIL | per (Period) | "per:14" | | WMA | per (Period) | "per:9" | Example Requests: - RSI: code: "GARAN", period: "1440", from: "20251101000000", to: "20251201235959", RSI: "per:14" - MACD: code: "GARAN", period: "1440", from: "20251101000000", to: "20251201235959", MACD: "fast:12-slow:26-sig:9" - Bollinger: code: "GARAN", period: "1440", from: "20251101000000", to: "20251201235959", BOL: "per:20-devu:2-devd:2" - Combined: code: "GARAN", period: "1440", from: "20251101000000", to: "20251201235959", RSI: "per:14", MACD: "fast:12-slow:26-sig:9", BOL: "per:20-devu:2-devd:2"
indicatorLast
ChatGPTReturns the latest technical indicator calculation result (single data point) for specified symbol(s). This tool requests indicator history from upstream using the given last value, then returns only the most recent data point per symbol. Provides indicator values by code, period, lookback window (last), and indicator query parameters. Output Behavior: - Returns exactly 1 data point per symbol (latest point only) - last controls the upstream lookback request, not the number of items returned to the client Indicator Stability Note: - Latest indicator values can vary when lookback history is short. - Increasing last generally stabilizes the latest value (especially RSI/MACD family indicators). - Very short history may return null for some indicators (for example, RSI with period 14 often needs more than 14 bars). Period Parameter (number | "w" | "m" | "y"): - Pass as a number (not a string) for minute-based periods: 1, 5, 15, 30, 60, 120, 240, 1440 - Pass as a string only for special values: "w" (weekly), "m" (monthly), "y" (yearly) - Valid numeric range: 1–1440. If > 60, must be divisible by 60 - Default: 1440 (daily candles) Indicator Parameter Syntax: Each indicator has specific parameter names. Format: "param1:value-param2:value" | Indicator | Parameters | Example | |-----------|------------|---------| | ADX | per (Period) | "per:14" | | ADXR | per (Period) | "per:14" | | APO | fast (Fast Period), slow (Slow Period) | "fast:12-slow:26" | | ARO | per (Period) | "per:25" | | ATR | per (Period) | "per:14" | | BOL | per (Period), devu (Upper Deviation), devd (Lower Deviation) | "per:20-devu:2-devd:2" | | CCI | per (Period) | "per:20" | | DEMA | per (Period) | "per:9" | | DX | per (Period) | "per:14" | | EMA | per (Period) | "per:9" | | ENVE | per (Period), perc (Percent) | "per:20-perc:2.5" | | ENVS | per (Period), perc (Percent) | "per:20-perc:2.5" | | ENVW | per (Period), perc (Percent) | "per:20-perc:2.5" | | MACD | fast (Fast Period), slow (Slow Period), sig (Signal Period) | "fast:12-slow:26-sig:9" | | MOM | per (Period) | "per:10" | | PPO | fast (Fast Period), slow (Slow Period) | "fast:12-slow:26" | | PVT | (value only, no params) | "classic", "camarilla", "fibonacci", "woodie" | | RSI | per (Period) | "per:14" | | SAR | acc (Acceleration), max (Maximum) | "acc:0.02-max:0.2" | | SMA | per (Period) | "per:20" | | STOCHRSI | fastk (Fast K), fastd (Fast D), per (Period) | "fastk:14-fastd:14-per:14" | | STOF | fastk (Fast K Period), fastd (Fast D Period) | "fastk:14-fastd:3" | | STOS | fastk (Fast K), slowk (Slow K), slowd (Slow D) | "fastk:14-slowk:3-slowd:3" | | T3 | per (Period), vfactor (Volume Factor 0-1) | "per:5-vfactor:0.7" | | TEMA | per (Period) | "per:9" | | TSF | per (Period) | "per:14" | | VOL | per (Period), dev (Deviation) | "per:20-dev:2" | | WIL | per (Period) | "per:14" | | WMA | per (Period) | "per:9" | Example Requests (note: period is a number, not a string): - Latest RSI (daily): codes: ["GARAN"], period: 1440, last: 100, indicators: [{"RSI": "per:14"}] - Latest MACD (hourly): codes: ["GARAN"], period: 60, last: 100, indicators: [{"MACD": "fast:12-slow:26-sig:9"}] - Latest Bollinger (daily): codes: ["GARAN"], period: 1440, last: 100, indicators: [{"BOL": "per:20-devu:2-devd:2"}] - Latest combined (daily): codes: ["GARAN"], period: 1440, last: 100, indicators: [{"RSI": "per:14"}, {"MACD": "fast:12-slow:26-sig:9"}, {"BOL": "per:20-devu:2-devd:2"}] - Weekly period: codes: ["GARAN"], period: "w", last: 100, indicators: [{"RSI": "per:14"}] Max last value: 1400 last Parameter: - Default: 1000 - Determines how much history is requested from upstream before selecting the latest point - Returned item count remains 1 per symbol
intradayFromTo
ChatGPTReturns intraday OHLCV price data for specified symbol(s) within a date range. Important input rules: - codes must be an array of symbol strings like ["THYAO", "AKBNK"] - period must be a JSON string, not a number. Supported values: "1", "5", "15", "30", "60", "1440", "w", "m", "y" - from and to must be JSON strings in yyyyMMddHHmmss format - Do not send ISO timestamps like "2026-04-14T09:40:00" - Do not double-quote values inside strings. Use "5", not "\"5\"" Valid JSON example: ``json { "codes": ["THYAO", "AKBNK"], "period": "5", "from": "20260414094000", "to": "20260414180500" } ` **Common invalid examples:** - period: 5 - period: "\"5\"" - from: 20260414094000 - from: "2026-04-14T09:40:00"`
kapData
ChatGPTUnified KAP data tool for disclosures, asset transactions, business relations, fund details, and fund asset-group distribution. - type="assetPurchase": Returns KAP-disclosed fixed asset purchases (CompanyCode, TransactionDate, TransactionValue, TryEquivalent, AssetTransactionRatio, AssetNature, TransactionImpact, AssetLocation). - type="assetSale": Returns KAP-disclosed fixed asset sales (same fields as assetPurchase). - type="businessRelation": Requires LIC_KAP_INSIGHTS. Returns AI-parsed new business relation insights with sub-modes: - mode="summary": total statistics for a disclosure year. Optional code filters locally. - mode="detail": transaction details for a company and disclosure year. - mode="last": latest new business relation disclosures. - type="fundDetails": Provide exactly one of code, kapFundCode, or legacyCode. - mode="details" (default): KAP fund management, strategy, benchmark, risk, trading/settlement, and fee data when published. - mode="assets": TEFAS/BEFAS asset-group percentages such as equities, deposits, government bonds, and reverse repo. This is not security-level holdings data. - mode="all": Fetches both details and asset-group distribution. Client-side response reduction is applied after normalization and does not change the upstream request: filter selects rows by fields, limit caps rows after filtering, and calculate supports sum, count, min, max, avg, first, or last. Numeric calculations require field, for example {function: "avg", field: "tryEquivalent"}; multiple operations and groupBy are supported in order filter → limit → calculate. The existing last parameter remains the upstream KAP retrieval count; use limit for local output reduction. Examples: - kapData with type: "assetPurchase", from: "20230101", to: "20231231", last: 10 - kapData with type: "assetSale", from: "20230101", to: "20231231", last: 10 - kapData with type: "businessRelation", mode: "summary", year: 2025 - kapData with type: "businessRelation", mode: "detail", code: "ASELS", year: 2025 - kapData with type: "businessRelation", mode: "last", last: 10 - kapData with type: "fundDetails", mode: "all", code: "ALE" - kapData with type: "fundDetails", kapFundCode: "AK2" - kapData with type: "fundDetails", mode: "assets", legacyCode: "AK2.FON" Time zone: Europe/Istanbul.
kapFundDetails
ChatGPTReturns detailed fund information (TEFAS funds) from KAP: fund manager, portfolio managers, investment strategy, risk indicator, trading details (settlement periods, cut-off times, min/max quantities), and commissions. Provide exactly one of kapFundCode or legacyCode.
lastQuarterRatios
ChatGPTReturns latest quarter financial metrics: NetProfit, GrossProfit, EBITDA, ROA, ROE, CompanyValue, TotalAssets, NetSales, debt ratios, and YearOverYearProfit. Example: lastQuarterRatios with codes: ["GARAN", "ASELS", "THYAO"] — parallel execution.
liquidity
ChatGPTReturns liquidity analysis: market value, trading volumes, transaction ratios, free float data for specified instruments over a time period. Example: liquidity with codes: ["GARAN", "ASELS"], period: "1440", from: "20250101000000", to: "20250110000000"
marketData
ChatGPTReturns real-time snapshot: symbol code, last price, daily change %, volume, and custom fields (l=last, C=change%, v=volume, E=code, h=high, o=open). Supports sorting and limiting. Usable for BIST and US markets.
news
ChatGPTReturns financial news articles or KAP announcements with related stocks, tags, header, content, attachments, and publish date. Supports sources: FRKS, KAP, PICNEWS, IHA. - tags: array of strings, e.g. ["GARAN"] or ["FRKS-Y", "GARAN"]. Multiple entity tags are fetched in parallel, deduplicated, and sorted by date. Tags: FRKS-H=Enerji, FRKS-E=Menkul Piyasalar, FRKS-D=Kıymetli Metal, FRKS-F=Firma, FRKS-S=Genel, FRKS-U=Metal, FRKS-G=Ürün, FRKS-Y=Analiz Yorum, FRKS-I=Döviz, FRKS-T=Lojistik, FRKS-K=Kripto, FRKS-A=Ekonomi, FRKS-W=Son Dakika, FRKS-X=Flaş, FRKS-L=Halka Arz, FRKS-Q=Temettü, FRKS-P=Anket, FRKS-R=Şirketler
nonCurrentAssetPurchase
ChatGPTReturns KAP-disclosed fixed asset purchases: CompanyCode, TransactionDate, TransactionValue, TryEquivalent, NonCurrentAssetTransactionRatio, NatureOfNonCurrentAsset, ImpactOfTheTransaction, LocationOfNonCurrentAsset. Example: nonCurrentAssetPurchase with from: "20230101", to: "20231231", last: 10
nonCurrentAssetSale
ChatGPTReturns KAP-disclosed fixed asset sales: CompanyCode, TransactionDate, TransactionValue, TryEquivalent, NonCurrentAssetTransactionRatio, NatureOfNonCurrentAsset, ImpactOfTheTransaction, LocationOfNonCurrentAsset. Example: nonCurrentAssetSale with from: "20230101", to: "20231231", last: 10
portfolioAverages
ChatGPTReturns broker consensus target prices: lowest, average, highest price forecasts and analyst count per symbol. Example: portfolioAverages with symbolCodes: ["GARAN", "ASELS"] — or omit symbolCodes for all symbols. Parallel execution.
portfolioListByBrokerOrSymbol
ChatGPTRetrieves broker target prices, portfolio weights, and price dates per symbol or broker. - symbolCode: Returns all brokers' target prices for that symbol - brokerCode: Returns all symbols in that broker's portfolio Exactly one parameter is required. Example: portfolioListByBrokerOrSymbol with symbolCode: "GARAN"
portfolioUpdates
ChatGPTReturns recent broker model portfolio changes: symbol code, number of portfolios holding it, and each broker's target price with update date. - last: Number of days to look back (1, 7, 14, or 30). Default: 7 Example: portfolioUpdates with last: 7
priceAnalysis
ChatGPTReturns price ladder analysis: total buy/ask amounts, weighted avg prices, buy-ask ratio, and price levels array with amounts split by buyer/seller type for each price point. Example: priceAnalysis with codes: ["GARAN", "ASELS"], at: "20250110" — parallel execution.
priceStatistics
ChatGPTUnified price and fund statistics tool with four modes: - mode="periodic": Returns WTD/WOW/MTD/MOM/YTD/YOY high/low prices with dates, volumes, turnovers, and previous close prices. - mode="changes": Returns percentage and nominal price changes across multiple timeframes (daily, weekly, monthly, 3M, 6M, YTD, 1Y, 3Y, 5Y, all-time). - mode="liquidity": Returns liquidity analysis: market value, trading volumes, transaction ratios, free float data. - mode="fundAnalytics": Returns analytics for 1-20 funds. Fund total value is asset; fund price/return is last/lastChangePercent; investor count is partnerCount; period fund flow is fundFlowTotal. Use .Close as the period-end value of OHLC-style metric objects. assetChangePercent is fund-size change, not investment return. Client-side response reduction is applied after normalization and does not change the upstream request: filter selects rows by fields, limit caps rows after filtering, and calculate supports sum, count, min, max, avg, first, or last. Numeric calculations require field, for example {function: "avg", field: "WTDVolume"}; multiple operations and groupBy are supported in order filter → limit → calculate. For keyed responses, transformations apply independently to each symbol's array and preserve symbol keys. Examples: - priceStatistics with mode: "periodic", codes: ["GARAN", "ASELS"] - priceStatistics with mode: "changes", codes: ["GARAN", "ASELS"] - priceStatistics with mode: "liquidity", codes: ["GARAN"], period: "1440", from: "20250101000000", to: "20250110000000" - priceStatistics with mode: "fundAnalytics", codes: ["ALE"], period: "30D", at: "20260731", fields: ["asset", "lastChangePercent", "partnerCount", "fundFlowTotal"] Time zone: Europe/Istanbul.
publicOffering
ChatGPTReturns public offering (IPO) data for Turkish stocks. Modes: - "all": All public offerings list with CompanyCode, CompanyName, PublicOfferingId. CompanyCode may be absent for early-stage offerings. - "calendar": IPO calendar for a year range with full details. from must be less than or equal to to, and the range cannot exceed 3 years. - "detail": Detailed IPO information for a specific company. Client-side response reduction is applied after the API response is normalized and does not change the upstream request. Use filter for field conditions, limit for the maximum rows after filtering, and calculate for sum, count, min, max, avg, first, or last. Numeric calculations require field, for example {function: "count"} or {function: "avg", field: "IpoHighPrice"}; multiple operations and groupBy are supported in order filter → limit → calculate. Examples: - All: mode: "all" - Calendar: mode: "calendar", from: "2024", to: "2026" - Detail: mode: "detail", companyCode: "ARMGD" Time zone: Europe/Istanbul.
publicOfferingAll
ChatGPTReturns all public offerings (IPOs) list: CompanyCode, CompanyName, PublicOfferingId. Some offerings may not have a CompanyCode yet if in early stages. Example: publicOfferingAll (no parameters)
publicOfferingCalendar
ChatGPTReturns IPO calendar for Turkish stocks: CompanyCode, CompanyName, Market, IpoAmount (total/secondary/capital increase), IpoLowPrice, IpoHighPrice, BookBuildingDates, FirstTransactionDate, IpoPlatform, IpoDistributionType, Brokers, IpoStatus. Example: publicOfferingCalendar with from: "2024", to: "2024"
publicOfferingDetail
ChatGPTReturns detailed IPO information for a specific company: IpoAmount, PreIpoCapital, PostIpoCapital, prices, BookBuildingDates, FirstTransactionDate, Brokers, IpoDistributionStatistics, IpoStatus. Example: publicOfferingDetail with companyCode: "ARMGD"
quarterRatioMulti
ChatGPTReturns financial ratio analysis for multiple selected periods: liquidity, profitability, debt ratios, etc. Example: quarterRatioMulti with codes: ["GARAN", "ASELS"], term: "2024-3", iry: 4 — parallel execution.
searchSymbol
ChatGPTSearches ForInvest symbol definitions across BIST, VIOP, SPOT, FX, Crypto, CBOE exchanges. Returns matching codes with names and types. Use when: You need to find the correct symbol code for a company name, ticker, or instrument. Example: searchSymbol with key: "Garanti" or key: "THYAO"
settlementAt
ChatGPTReturns broker-level settlement (custody) data for symbol(s) or broker code(s) on a specific date. Accepts both symbol codes (GARAN) and broker codes (TBY) as input. Fields: BrokerCode, Amount, DailyDelta, WeeklyDelta, MonthlyDelta, QuarterlyDelta, ShortSale2Day/1Day/Day, Price, TotalSettlement. Optional: rc (broker filter), sortby, sortorder, limit for BrokerPositions. Example: settlementAt with codes: ["GARAN"], at: "20250110", sortby: "Amount", sortorder: "desc", limit: 5
settlementLast
ChatGPTReturns last N days of broker settlement (custody/takas) data for symbol(s) or broker code(s). Accepts both symbol codes (GARAN) and broker codes (TBY) as input. Data: InstrumentCode, Date, Price, TotalSettlement, BrokerPositions (BrokerCode, Amount, DailyDelta, WeeklyDelta, MonthlyDelta, QuarterlyDelta, Spot2Day, Spot1Day, SpotDay). Common foreign broker codes: CIY.B, DBY.B, TEB.B, JPY.B Foreign ownership %: Sum foreign broker Amounts / TotalSettlement × 100 Optional parameters: - f: Field filter (i, i.rc, i.a, i.dd, i.wd, i.md, i.qd). Cannot be used with rc. - rc: Broker code filter. Cannot be used with f. - Routing: If user asks for a broker's holdings, pass broker code in codes (not rc). - sortby, sortorder, limit: Sort/limit BrokerPositions per day. Example: settlementLast with codes: ["GARAN"], last: 10, sortby: "Amount", sortorder: "desc", limit: 5
settlementRatioTopBottom
ChatGPTReturns top/bottom securities by settlement ratio change between two dates. Tracked brokers: FOREIGN (CIY.B, DBY.B, TEB.B), FUND (XEM.A, XYA.B). Fields: SymbolCode, RatioChangePercentage, FromPeriod/ToPeriod (Date, SettlementRatio, TrackedBrokerAmount, TotalLots). Example: settlementRatioTopBottom with direction: "TOP", period: "WEEKLY", size: 5, brokerType: "FOREIGN"
shortSalesAggregateVolume
ChatGPTReturns aggregate short sales data by symbol for a date range: SymbolCode, TotalShortSalesVolumeTRY, TotalShortSalesAmount. Example: shortSalesAggregateVolume with from: "20241101", to: "20241130"
shortSalesBulletinAt
ChatGPTReturns daily short sale bulletin for all symbols: ShortSalesVolume, ShortSalesAmount, TotalVolume, TotalAmount, LowPrice, HighPrice, WeightedAveragePrice, ShortSalesVolumeRatio, ShortSalesAmountRatio. Example: shortSalesBulletinAt with at: "20240218"
skills
ChatGPTSkill management tool with two actions: - "index": Returns the in-memory skill index containing all active skill keys, descriptions, and MCP tool names. Used by the ForMind client to cache the skill list for routing decisions. - "load": Loads one or more skills by key and returns a versioned skill bundle with selected skill versions, merged instructionsMarkdown, an explicit all/allowlist tool policy, canonical tool names, live tool schemas, and validation warnings. Examples: - Index: action: "index" - Load: action: "load", keys: ["market-overview"] Time zone: Europe/Istanbul.
specialTransaction
ChatGPTReturns special transactions (block orders and forced sales) for BIST Equity, VIOP, and Inforex markets. - stype "S" = Special/Blocked Orders (BIST + Inforex), "F" = Forced Sales (Inforex only) - Response: transaction ID, date, symbol, price, amount, volume, buyer/seller codes (AKD license required), process kind, direction. Example: specialTransaction with code: "GARAN", stype: "S"
splitByCode
ChatGPTReturns historical corporate actions: stock splits, dividends, rights issues, and adjustment ratios for specified symbols. Example: splitByCode with codes: ["GARAN", "ASELS"] — parallel execution.
splitFromTo
ChatGPTReturns corporate action split data within a date range: Date, SymbolCode, RightIssuesPercent, BonusIssuesPercent, DividendPercent, SplitRatio, SplitStatus, Exchange. Supports filtering by exchange (BIST, CSE, ATHEX). Example: splitFromTo with from: "20240101", to: "20241231", exchange: "BIST"
statistic
ChatGPTReturns statistical values for securities: WTD/WOW/MTD/MOM/YTD/YOY high/low prices with dates, volumes, turnovers, and previous close prices. Example: statistic with codes: ["GARAN", "ASELS"] — parallel execution.
stockAnalysis
ChatGPTReturns last 5 analysis reports per symbol: RelatedStocks, Tags, AnalysisTitle, ContentUrl, AttachmentUrls, PublishDate. Example: stockAnalysis with codes: ["GARAN", "ASELS"] — parallel execution.
stockChangeDistribution
ChatGPTReturns BIST stock count distribution grouped by percentage change levels across 8 time periods (1d, 1w, 1m, 3m, 6m, 1y, 3y, 5y). Each period contains threshold levels with StockCount showing how many stocks changed by at least that percentage. Use for market breadth analysis and volatility measurement. Example: stockChangeDistribution (no parameters)
stockScreener
ChatGPTFilters Borsa İstanbul equities with the Stock Screener service. Returns stock results based on provided filtering criteria. ⚠️ Works ONLY with Borsa İstanbul stocks. Available Filter Fields: - Definition: code, status (ACTIVE/PASSIVE), grossSettlement (Y/N), securityDescription, subMarket, subMarketDescription, sector, index, shortSalePolicy (NA/NR) - Price & Trading: open, close, previousClose, last, high, low, vwap, dailyChangePercent, weeklyChangePercent, monthlyChangePercent, yearlyChangePercent, woWeeklyChangePercent, moMonthlyChangePercent, yoYearlyChangePercent, volatility, totalTurnover, totalVolume, dailyDirection, lastPeriod - Moving Averages: sma5/8/10/20/50/100/200, ema5/8/10/20/50/100/200 - Historical Volatility: hisVol21/30/42/63/126/252 - Market & Valuation: bookValue, netCapital, marketValue, marketValueUSD, earningPerShare, priceEarning, priceBookValue, capital, capitalRatio - Ownership: returnOnEquity, freeFloatRate, publicOfferingRatio, individualInvestorRatio, institutionalInvestorRatio, freeFloatStockSize, publicStockSize - Quarter Ratios: grossProfit, netProfit, ebitda, grossMargin, netMargin, returnonAssets, companyValue, totalAssests, netSales, yoyprofit - Company Detail: numberOfEmployee, ipoDate, establishmentDate, shareholders, foreignCurrencyAssets/Liabilities, netForeignCurrencyPosition - Other: dividendYield, dividendYieldYears, threeMonthsChangePct, sixMonthsChangePct, threeYearsChangePct, fiveYearsChangePct, allTimeChangePct Supported Operators: - eq/neq: number, string, or boolean - gt/lt/gte/lte: number only - in/nin: non-empty array of primitives - between: array of exactly 2 numbers (inclusive) - exists: boolean (true/false) Example: filters=[{field:"priceEarning",op:"between",value:[5,15]}, {field:"sector",op:"in",value:["S8316","S1210"]}, {field:"close",op:"lt",value:200}], fields=["open","last"]
supplyDemandLastMinutes
ChatGPTSupply-demand active trade analysis. Returns bid volume (bv), ask volume (av), total volume (tv), volume difference (vd), and percentages (bvp, avp, vdp) for the last N minutes. Supported periods: 5, 10, 15, 30, 60, 1440 minutes. Example: supplyDemandLastMinutes with codes: ["GARAN", "AKBNK"], last: 60 — parallel execution.
symbolSearchFlex
ChatGPTFuzzy full-text search across ForInvest symbol definitions. Searches code, name, issuer, exchange, and all metadata fields with typo tolerance. Usable for both BIST and US market symbols when available. When to use: - User mentions a company/asset name partially or with typos (e.g., "garant" → finds "Garanti Bankası") - Search policy: preserve the user's natural wording first. If the user says "ons altın", "altın", or "petrol", search those words first; do not prematurely rewrite them to tickers like "XAU/USD". Only try English equivalents if needed. - Finding symbols when exact code is unknown - Exploring available instruments in a sector or category - Searching US equities (e.g., Tesla, Apple) with superDomain: "us-equity" DIRECTIVE: Always use a superDomain when the user's query matches an available category. This improves search accuracy and performance. Available superDomains: - "bist-stock": Stocks traded on Borsa Istanbul (BIST). Use for Turkish equities, shares, and company stocks. - "us-equity": US equities from CBOE/EDGX definitions. Use for US stock symbol discovery. - "bist-derivatives": VIOP futures contracts, warrants, and options. Use for derivatives, VIOP sözleşmeleri, varantlar, and opsiyonlar. - "bist-broker": BIST broker/intermediary institutions. Use for searching brokers by code, name, or type. - "tefas-funds": TEFAS mutual funds (yatırım fonları). Use for searching Turkish investment funds by name or code. Parameters: - key (optional, min 2 chars): Search term - can be a partial name, ticker, or keyword. Prefer the user's original natural-language wording first; use ticker-style input only if the user explicitly gives it or it is already known. - keys (optional): Multiple search terms in one request. Uses the same where/superDomain for all keys. - topPercent (optional, 1-100, default: 40): Filters results to top X% by relevance score. Lower = stricter matching. Usually leave at default. - where (optional): Filter object with domain, exchange, market, securityType, and/or index fields (e.g., { domain: "BIST" }, { domain: "FX" }, { domain: "CBOE", exchange: "EDGX" }, { index: "XU030" }) - superDomain (optional): Choose a specific index to search first (e.g., "bist-stock", "us-equity", "bist-derivatives"). Falls back to default index if no results found. Returns: For a single key, matching symbols with: code, name, securityType, domain, sector. For multiple keys, returns the same result structure grouped under "queries". Instructions - Where clause (filtering) should only be used if specified by the agent prompt. Do not use filters that are not specified here. - For natural-language asset requests, search the asset name/phrase first (e.g., "ons altın"), not a guessed symbol code or parity. Example queries: - User asks: "Ons altın saatlik grafikte..." → use { "key": "ons altın" }, not { "key": "XAU/USD" } - "ons altın" → search with "ons altın" first; may find gold spot / XAUUSD-related instruments - "altın" or "gold" → Altın, Gold, Gold spot, gold futures, gold ETFs - "garanti" → GARAN (Garanti Bankası stock), { "key": "garanti", "where": { "securityType": "Stock" } } - "dolar" or "usd" → USD/TRY and related FX pairs, { "key": "USDTRY", "where": { "domain": "FX" } } - "tesla" → US equity listing, { "key": "Tesla", "superDomain": "us-equity" } or { "key": "Tesla", "where": { "domain": "CBOE" } } - "bist 30" → XU030 index, eg.: { "key": "<<optional>>", "where": { "index": "XU030" } } - "tahvil" or "bond" → Government and corporate bonds - "viop" → VIOP futures contracts / VIOP sözleşmeleri, eg.: { "key": "garanti", "superDomain": "bist-derivatives" } - "varant" → Warrants, eg.: { "key": "garanti", "superDomain": "bist-derivatives" } - "opsiyon" → Options, eg.: { "key": "akbank", "superDomain": "bist-derivatives" } - Other words for filtering Varant -> { "securityType": "Warrant" }, Opsiyon -> { "securityType": "Option" } - "aracı kurum" or "broker" → Broker institutions, eg.: { "key": "garanti", "superDomain": "bist-broker" } - "fon" or "yatırım fonu" → TEFAS mutual funds, eg.: { "key": "garanti", "superDomain": "tefas-funds" } - Multi search → { "keys": ["garanti", "akbank"], "superDomain": "bist-stock" }
symbolsByIndex
ChatGPTGets BIST symbols by index Parameters: sector (string) - see list of sector codes above Indexes: - XTAST - BIST TAS TOPRAK - XMESY - BIST METAL ESYA MAKINA - XKMYA - BIST KIMYA PETROL PLASTIK - XYORT - BIST MENKUL KIYM YO - XGMYO - BIST GAYRIMENKUL YO - XU100 - BIST 100 - XSPOR - BIST SPOR - XTMTU - BIST TEMETTU - XUTUM - BIST TUM - XSGRT - BIST SIGORTA - XUSRD - BIST SURDURULEBILIRLIK - XYUZO - BIST 100-30 - X100S - BIST 100 AGIRLIK SINIRLAMALI 10 - XUTEK - BIST TEKNOLOJI - X030S - BIST 30 AGIRLIK SINIRLAMALI 10 - XTM25 - BIST TEMETTU 25 - XILTM - BIST ILETISIM - XBLSM - BIST BILISIM - XUMAL - BIST MALI - XBANA - BIST ANA - KAT50 - KATILIM 50 - XU050 - BIST 50 - XYLDZ - BIST YILDIZ - XU030 - BIST 30 - KATLM - KATILIM 30 - XULAS - BIST ULASTIRMA - XUSIN - BIST SINAI - XUHIZ - BIST HIZMETLER - XMADN - BIST MADENCILIK - XTCRT - BIST TICARET - XINSA - BIST INSAAT - XTUMY - BIST TUM-100 - XTEKS - BIST TEKSTIL DERI - XTKJS - BIST TEKNOLOJI AGIRLIK SINIRLAMALI - XGIDA - BIST GIDA ICECEK - XKAGT - BIST ORMAN KAGIT BASIM - XELKT - BIST ELEKTRIK - XBANK - BIST BANKA - XKURY - BIST KURUMSAL YONETIM - XMANA - BIST METAL ANA - XHARZ - BIST HALKA ARZ - XTRZM - BIST TURIZM - XHOLD - BIST HOLDING VE YATIRIM - TIMEX - TIM IHRACAT - XLBNK - BIST LIKIT BANKA - X10XB - BIST BANKA DISI LIKIT 10 - XPGIP - BIST GIP - XAKUR - BIST ARACI KURUMLAR - X100C - BIST 100 AGIRLIK SINIRLAMALI 25 - X030C - BIST 30 AGIRLIK SINIRLAMALI 25 - X030EA - BIST 30 ESIT AGIRLIKLI - XELOT - BIST 50-30 - XELOS - BIST 50-30 AGIRLIK SINIRLAMALI 10 - XELOC - BIST 50-30 AGIRLIK SINIRLAMALI 25 - XK030 - BIST KATILIM 30 - XKTUM - BIST KATILIM TUM - XSRDK - BIST KATILIM SURDURULEBILIRLIK - XK100 - BIST KATILIM 100 - XK050 - BIST KATILIM 50 - XK030EA - BIST KATILIM 30 ESIT AGIRLIKLI - XKTMT - BIST KATILIM TEMETTU - XSD25 - BIST SURDURULEBILIRLIK 25 - XTM25S - BIST TEMETTU 25 AGIRLIK SINIRLAMALI 10 - XUGRA - BIST GERI ALIM - SUOSE - BIST SURDURULEBILIR OSBA EUROBOND USD - YEOSE - BIST YESIL OSBA EUROBOND USD - XSINS - BIST SINAI AGIRLIK SINIRLAMALI - XGYOS - BIST GAYRIMENKUL YO AGIRLIK SINIRLAMALI Use when: BIST index symbol information or list needed
technicalChart
ChatGPTGenerates technical analysis charts with OHLC candlesticks and optional indicators. Returns: PNG image as base64 encoded data via MCP image response. Chart Type: OHLC (candlestick) chart with optional technical indicators overlay Indicators: Uses indicatorLast/indicatorFromTo services - supports all available indicators (SMA, EMA, RSI, MACD, Bollinger, etc.) Data Source: Uses historicalLast or historicalFromTo for OHLC data Limitation: Single code per request for technical analysis. Example usage: - OHLC chart: technicalChart with code: GARAN, resolution: 1440, last: 100 - OHLC with SMA: technicalChart with code: GARAN, resolution: 1440, last: 100, indicators: [{"SMA": "per:20"}] - Multiple indicators: technicalChart with code: GARAN, resolution: 1440, last: 100, indicators: [{"SMA": "per:20"}, {"RSI": "per:14"}, {"BOL": "per:20-devu:2-devd:2"}] - Date range with indicators: technicalChart with code: GARAN, resolution: 1440, from: 20241101000000, to: 20250114000000, indicators: [{"EMA": "per:12"}, {"EMA": "per:26"}]
technicalIndicator
ChatGPTReturns server-calculated technical indicators. Never compute them from OHLCV. - mode "latest" (default): Latest point per symbol. - mode "history": Last outputCount points per symbol (default 2) for crossover checks. Both support multiple codes. from/to returns a single-symbol series; omit mode, outputCount and last. Output: {date, open, high, low, close, volume, ...indicator values}. Single-value indicators as flat keys (ema50, rsi14), multi-value as objects (macd_12_26_9: {value, signal, histogram}). Indicator syntax — format: "param1:value-param2:value" Single-param (per:N): ADX, ADXR, ARO, ATR, CCI, DEMA, DX, EMA, MOM, RSI, SMA, TEMA, TSF, WIL, WMA Two-param: APO/PPO (fast:N-slow:N), SAR (acc:N-max:N), VOL (per:N-dev:N), ENVE/ENVS/ENVW (per:N-perc:N), STOF (fastk:N-fastd:N), T3 (per:N-vfactor:N) Three-param: BOL (per:N-devu:N-devd:N), MACD (fast:N-slow:N-sig:N), STOS (fastk:N-slowk:N-slowd:N), STOCHRSI (fastk:N-fastd:N-per:N) PVT: "classic", "camarilla", "fibonacci", "woodie" Parameters: - codes: Symbol codes - period: 1-1440 (if >60 divisible by 60), "w"/"m"/"y". Default: 1440 (daily) - indicators: Array of indicator objects [{RSI: "per:14"}, {MACD: "fast:12-slow:26-sig:9"}] - last: Calculation lookback (default 1000, max 1400), independent of outputCount. Short histories can yield missing or unstable RSI/MACD. - outputCount: History points per symbol (default 2); cannot exceed last. - from/to: Date range in YYYYMMDDHHmmss format (range mode) Examples: - Latest: codes: ["GARAN", "ASELS"], period: 1440, indicators: [{"RSI":"per:14"},{"MACD":"fast:12-slow:26-sig:9"}] - History: mode: "history", codes: ["GARAN", "ASELS"], outputCount: 2, indicators: [{"MACD":"fast:12-slow:26-sig:9"}] - Range: codes: ["GARAN"], period: 1440, from: "20251101000000", to: "20251201235959", indicators: [{"RSI":"per:14"}] Time zone: Europe/Istanbul.
tickAtLast
ChatGPTReturns historical tick transaction data for parity symbols (forex pairs, spot, foreign indices/futures) at a specific datetime. NOT for BIST stocks. Returns: co, d (timestamp), l (last), bid, ask, a (amount). Example: tickAtLast with codes: ["EUR/USD"], at: "20230101120000", last: 100
tickLast
ChatGPTReturns latest tick transactions for parity symbols (forex pairs, spot, foreign indices/futures). Each tick: timestamp, last price, bid, ask, amount. NOT for BIST stocks. Example: tickLast with codes: ["EUR/USD", "USD/TRY"], last: 100
transaction
ChatGPTReturns last N tick-level trades for one or more symbols: TransactionId, SymbolCode, Timestamp, Price, Amount, Volume, BuyerBrokerCode, SellerBrokerCode, ProcessKind (S=Special, N=Normal, F=Forced), Direction (0=buyer, 1=seller initiated), BidPrice, AskPrice. Broker codes can be resolved via brokerDefinitions tool. Example: transaction with codes: ["GARAN", "ASELS"], last: 10 — parallel execution.