tradingview-mcp 1.0.0__py3-none-any.whl

tradingview_mcp/__init__.py

@@ -0,0 +1,14 @@
+"""
+TradingView MCP Server - A comprehensive MCP server for TradingView market screening.
+
+This package provides:
+- Direct TradingView API integration for market screening
+- SQL-like query interface for building complex filters
+- MCP tools for market analysis and technical indicators
+- Support for 76+ markets including crypto, stocks, forex, and futures
+"""
+
+from tradingview_mcp.server import mcp, main
+
+__version__ = "1.0.0"
+__all__ = ["mcp", "main"]

tradingview_mcp/column.py

@@ -0,0 +1,231 @@
+"""
+Column class for building filter expressions.
+
+Provides a SQL-like interface for creating WHERE clauses.
+"""
+
+from __future__ import annotations
+
+from typing import TYPE_CHECKING, Iterable, Optional
+
+if TYPE_CHECKING:
+    from tradingview_mcp.models import FilterOperationDict
+
+
+class Column:
+    """
+    A Column object represents a field in the TradingView stock screener.
+
+    Used in SELECT queries and WHERE queries with the Query object.
+    Supports all comparison operations: <, <=, >, >=, ==, !=
+    Plus methods like between(), isin(), crosses(), etc.
+
+    Examples:
+        >>> Column('close') > 2.5
+        >>> Column('close').between(2.5, 15)
+        >>> Column('high') > Column('VWAP')
+        >>> Column('type').isin(['stock', 'fund'])
+        >>> Column('description').like('apple')
+        >>> Column('RSI') < 30
+    """
+
+    def __init__(self, name: str) -> None:
+        """
+        Create a Column object from a column name.
+
+        Args:
+            name: The column/field name (e.g., 'close', 'RSI', 'volume')
+        """
+        self.name = name
+
+    @staticmethod
+    def _extract_name(obj: "Column | str | int | float") -> str | int | float:
+        """Extract the name from a Column or return the value as-is."""
+        if isinstance(obj, Column):
+            return obj.name
+        return obj
+
+    def __gt__(self, other: "Column | str | int | float") -> "FilterOperationDict":
+        """Greater than comparison."""
+        return {"left": self.name, "operation": "greater", "right": self._extract_name(other)}
+
+    def __ge__(self, other: "Column | str | int | float") -> "FilterOperationDict":
+        """Greater than or equal comparison."""
+        return {"left": self.name, "operation": "egreater", "right": self._extract_name(other)}
+
+    def __lt__(self, other: "Column | str | int | float") -> "FilterOperationDict":
+        """Less than comparison."""
+        return {"left": self.name, "operation": "less", "right": self._extract_name(other)}
+
+    def __le__(self, other: "Column | str | int | float") -> "FilterOperationDict":
+        """Less than or equal comparison."""
+        return {"left": self.name, "operation": "eless", "right": self._extract_name(other)}
+
+    def __eq__(self, other: "Column | str | int | float") -> "FilterOperationDict":  # type: ignore[override]
+        """Equal comparison."""
+        return {"left": self.name, "operation": "equal", "right": self._extract_name(other)}
+
+    def __ne__(self, other: "Column | str | int | float") -> "FilterOperationDict":  # type: ignore[override]
+        """Not equal comparison."""
+        return {"left": self.name, "operation": "nequal", "right": self._extract_name(other)}
+
+    def crosses(self, other: "Column | str") -> "FilterOperationDict":
+        """Check if column crosses another column/value."""
+        return {"left": self.name, "operation": "crosses", "right": self._extract_name(other)}
+
+    def crosses_above(self, other: "Column | str") -> "FilterOperationDict":
+        """Check if column crosses above another column/value."""
+        return {"left": self.name, "operation": "crosses_above", "right": self._extract_name(other)}
+
+    def crosses_below(self, other: "Column | str") -> "FilterOperationDict":
+        """Check if column crosses below another column/value."""
+        return {"left": self.name, "operation": "crosses_below", "right": self._extract_name(other)}
+
+    def between(
+        self, left: "Column | str | int | float", right: "Column | str | int | float"
+    ) -> "FilterOperationDict":
+        """
+        Check if value is between two bounds (inclusive).
+
+        Examples:
+            >>> Column('close').between(10, 50)
+            >>> Column('close').between(Column('EMA5'), Column('EMA20'))
+        """
+        return {
+            "left": self.name,
+            "operation": "in_range",
+            "right": [self._extract_name(left), self._extract_name(right)],
+        }
+
+    def not_between(
+        self, left: "Column | str | int | float", right: "Column | str | int | float"
+    ) -> "FilterOperationDict":
+        """Check if value is NOT between two bounds."""
+        return {
+            "left": self.name,
+            "operation": "not_in_range",
+            "right": [self._extract_name(left), self._extract_name(right)],
+        }
+
+    def isin(self, values: Iterable) -> "FilterOperationDict":
+        """
+        Check if value is in a list of values.
+
+        Examples:
+            >>> Column('type').isin(['stock', 'fund'])
+            >>> Column('exchange').isin(['NASDAQ', 'NYSE'])
+        """
+        return {"left": self.name, "operation": "in_range", "right": list(values)}
+
+    def not_in(self, values: Iterable) -> "FilterOperationDict":
+        """Check if value is NOT in a list of values."""
+        return {"left": self.name, "operation": "not_in_range", "right": list(values)}
+
+    def has(self, values: str | list[str]) -> "FilterOperationDict":
+        """
+        Check if field contains any of the values (for set-type fields).
+
+        Examples:
+            >>> Column('typespecs').has(['common', 'preferred'])
+        """
+        return {"left": self.name, "operation": "has", "right": values}
+
+    def has_none_of(self, values: str | list[str]) -> "FilterOperationDict":
+        """Check if field contains NONE of the values (for set-type fields)."""
+        return {"left": self.name, "operation": "has_none_of", "right": values}
+
+    def in_day_range(self, a: int, b: int) -> "FilterOperationDict":
+        """Check if date is within day range (0 = today)."""
+        return {"left": self.name, "operation": "in_day_range", "right": [a, b]}
+
+    def in_week_range(self, a: int, b: int) -> "FilterOperationDict":
+        """Check if date is within week range."""
+        return {"left": self.name, "operation": "in_week_range", "right": [a, b]}
+
+    def in_month_range(self, a: int, b: int) -> "FilterOperationDict":
+        """Check if date is within month range."""
+        return {"left": self.name, "operation": "in_month_range", "right": [a, b]}
+
+    def above_pct(self, column: "Column | str", pct: float) -> "FilterOperationDict":
+        """
+        Check if value is above another column by a percentage.
+
+        Args:
+            column: Reference column
+            pct: Percentage multiplier (1.03 = 3% above)
+
+        Examples:
+            >>> Column('close').above_pct('VWAP', 1.03)  # 3% above VWAP
+            >>> Column('close').above_pct('price_52_week_low', 2.5)  # 150% above 52w low
+        """
+        return {
+            "left": self.name,
+            "operation": "above%",
+            "right": [self._extract_name(column), pct],
+        }
+
+    def below_pct(self, column: "Column | str", pct: float) -> "FilterOperationDict":
+        """
+        Check if value is below another column by a percentage.
+
+        Examples:
+            >>> Column('close').below_pct('VWAP', 1.03)  # 3% below VWAP
+        """
+        return {
+            "left": self.name,
+            "operation": "below%",
+            "right": [self._extract_name(column), pct],
+        }
+
+    def between_pct(
+        self, column: "Column | str", pct1: float, pct2: Optional[float] = None
+    ) -> "FilterOperationDict":
+        """
+        Check if percentage change relative to column is within range.
+
+        Examples:
+            >>> Column('close').between_pct('EMA200', 1.2, 1.5)  # 20-50% above EMA200
+        """
+        return {
+            "left": self.name,
+            "operation": "in_range%",
+            "right": [self._extract_name(column), pct1, pct2],
+        }
+
+    def not_between_pct(
+        self, column: "Column | str", pct1: float, pct2: Optional[float] = None
+    ) -> "FilterOperationDict":
+        """Check if percentage change relative to column is NOT within range."""
+        return {
+            "left": self.name,
+            "operation": "not_in_range%",
+            "right": [self._extract_name(column), pct1, pct2],
+        }
+
+    def like(self, pattern: str) -> "FilterOperationDict":
+        """
+        Pattern matching (case-insensitive LIKE '%pattern%').
+
+        Examples:
+            >>> Column('description').like('apple')
+        """
+        return {"left": self.name, "operation": "match", "right": pattern}
+
+    def not_like(self, pattern: str) -> "FilterOperationDict":
+        """Negative pattern matching."""
+        return {"left": self.name, "operation": "nmatch", "right": pattern}
+
+    def empty(self) -> "FilterOperationDict":
+        """Check if field is empty/null."""
+        return {"left": self.name, "operation": "empty", "right": None}
+
+    def not_empty(self) -> "FilterOperationDict":
+        """Check if field is NOT empty/null."""
+        return {"left": self.name, "operation": "nempty", "right": None}
+
+    def __repr__(self) -> str:
+        return f"Column({self.name!r})"
+
+
+# Convenience alias
+col = Column

tradingview_mcp/constants.py

@@ -0,0 +1,425 @@
+"""
+Constants for TradingView Screener integration.
+
+Contains API URLs, headers, supported markets, and column definitions.
+"""
+
+from __future__ import annotations
+
+# API Configuration
+URL = "https://scanner.tradingview.com/{market}/scan"
+
+HEADERS = {
+    "authority": "scanner.tradingview.com",
+    "sec-ch-ua": '" Not A;Brand";v="99", "Chromium";v="98", "Google Chrome";v="98"',
+    "accept": "text/plain, */*; q=0.01",
+    "content-type": "application/x-www-form-urlencoded; charset=UTF-8",
+    "sec-ch-ua-mobile": "?0",
+    "user-agent": (
+        "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 "
+        "(KHTML, like Gecko) Chrome/98.0.4758.102 Safari/537.36"
+    ),
+    "sec-ch-ua-platform": '"Windows"',
+    "origin": "https://www.tradingview.com",
+    "sec-fetch-site": "same-site",
+    "sec-fetch-mode": "cors",
+    "sec-fetch-dest": "empty",
+    "referer": "https://www.tradingview.com/",
+    "accept-language": "en-US,en;q=0.9",
+}
+
+DEFAULT_RANGE = [0, 50]
+
+# Supported Markets (76 total)
+MARKETS = {
+    # Financial Instruments
+    "bonds",
+    "cfd",
+    "coin",
+    "crypto",
+    "economics2",
+    "forex",
+    "futures",
+    "options",
+    # Countries (67)
+    "america",
+    "argentina",
+    "australia",
+    "austria",
+    "bahrain",
+    "bangladesh",
+    "belgium",
+    "brazil",
+    "canada",
+    "chile",
+    "china",
+    "colombia",
+    "cyprus",
+    "czech",
+    "denmark",
+    "egypt",
+    "estonia",
+    "finland",
+    "france",
+    "germany",
+    "greece",
+    "hongkong",
+    "hungary",
+    "iceland",
+    "india",
+    "indonesia",
+    "israel",
+    "italy",
+    "japan",
+    "kenya",
+    "korea",
+    "ksa",
+    "kuwait",
+    "latvia",
+    "lithuania",
+    "luxembourg",
+    "malaysia",
+    "mexico",
+    "morocco",
+    "netherlands",
+    "newzealand",
+    "nigeria",
+    "norway",
+    "pakistan",
+    "peru",
+    "philippines",
+    "poland",
+    "portugal",
+    "qatar",
+    "romania",
+    "rsa",
+    "russia",
+    "serbia",
+    "singapore",
+    "slovakia",
+    "spain",
+    "srilanka",
+    "sweden",
+    "switzerland",
+    "taiwan",
+    "thailand",
+    "tunisia",
+    "turkey",
+    "uae",
+    "uk",
+    "venezuela",
+    "vietnam",
+}
+
+# Exchange to Screener Mapping
+EXCHANGE_SCREENER = {
+    # Crypto Exchanges
+    "all": "crypto",
+    "huobi": "crypto",
+    "kucoin": "crypto",
+    "coinbase": "crypto",
+    "gateio": "crypto",
+    "binance": "crypto",
+    "bitfinex": "crypto",
+    "bitget": "crypto",
+    "bybit": "crypto",
+    "okx": "crypto",
+    "kraken": "crypto",
+    "bitstamp": "crypto",
+    "gemini": "crypto",
+    "poloniex": "crypto",
+    # Stock Exchanges
+    "bist": "turkey",
+    "nasdaq": "america",
+    "nyse": "america",
+    "amex": "america",
+    # Malaysia
+    "bursa": "malaysia",
+    "myx": "malaysia",
+    "klse": "malaysia",
+    "ace": "malaysia",
+    "leap": "malaysia",
+    # Hong Kong
+    "hkex": "hongkong",
+    "hk": "hongkong",
+    "hsi": "hongkong",
+    # Others
+    "lse": "uk",
+    "tsx": "canada",
+    "asx": "australia",
+    "nse": "india",
+    "bse": "india",
+    "sse": "china",
+    "szse": "china",
+    "tse": "japan",
+    "krx": "korea",
+}
+
+# Allowed Timeframes
+ALLOWED_TIMEFRAMES = {"1m", "5m", "15m", "30m", "1h", "2h", "4h", "1D", "1W", "1M"}
+
+# Timeframe to TradingView Resolution
+TIMEFRAME_MAP = {
+    "1m": "1",
+    "5m": "5",
+    "15m": "15",
+    "30m": "30",
+    "1h": "60",
+    "2h": "120",
+    "4h": "240",
+    "1D": "1D",
+    "1W": "1W",
+    "1M": "1M",
+}
+
+# Column Definitions - Human readable names to API column names
+COLUMNS = {
+    # Technical Indicators
+    "Average Day Range (14)": "ADR",
+    "Average Directional Index (14)": "ADX",
+    "Positive Directional Indicator (14)": "ADX+DI",
+    "Negative Directional Indicator (14)": "ADX-DI",
+    "Awesome Oscillator": "AO",
+    "Average True Range (14)": "ATR",
+    "Aroon Down (14)": "Aroon.Down",
+    "Aroon Up (14)": "Aroon.Up",
+    "Bollinger Lower Band (20)": "BB.lower",
+    "Bollinger Upper Band (20)": "BB.upper",
+    "Bull Bear Power": "BBPower",
+    "Commodity Channel Index (20)": "CCI20",
+    "Chaikin Money Flow (20)": "ChaikinMoneyFlow",
+    "Donchian Channels Lower Band (20)": "DonchCh20.Lower",
+    "Donchian Channels Upper Band (20)": "DonchCh20.Upper",
+    # EMAs
+    "Exponential Moving Average (5)": "EMA5",
+    "Exponential Moving Average (10)": "EMA10",
+    "Exponential Moving Average (20)": "EMA20",
+    "Exponential Moving Average (30)": "EMA30",
+    "Exponential Moving Average (50)": "EMA50",
+    "Exponential Moving Average (100)": "EMA100",
+    "Exponential Moving Average (200)": "EMA200",
+    # Highs/Lows
+    "1-Month High": "High.1M",
+    "3-Month High": "High.3M",
+    "6-Month High": "High.6M",
+    "All Time High": "High.All",
+    "1-Month Low": "Low.1M",
+    "3-Month Low": "Low.3M",
+    "6-Month Low": "Low.6M",
+    "All Time Low": "Low.All",
+    # Hull MA
+    "Hull Moving Average (9)": "HullMA9",
+    # Ichimoku
+    "Ichimoku Base Line (9, 26, 52, 26)": "Ichimoku.BLine",
+    "Ichimoku Conversion Line (9, 26, 52, 26)": "Ichimoku.CLine",
+    "Ichimoku Leading Span A (9, 26, 52, 26)": "Ichimoku.Lead1",
+    "Ichimoku Leading Span B (9, 26, 52, 26)": "Ichimoku.Lead2",
+    # Keltner Channels
+    "Keltner Channels Lower Band (20)": "KltChnl.lower",
+    "Keltner Channels Upper Band (20)": "KltChnl.upper",
+    # MACD
+    "MACD Level (12, 26)": "MACD.macd",
+    "MACD Signal (12, 26)": "MACD.signal",
+    # Other Indicators
+    "Momentum (10)": "Mom",
+    "Money Flow (14)": "MoneyFlow",
+    "Parabolic SAR": "P.SAR",
+    # Performance
+    "Monthly Performance": "Perf.1M",
+    "3-Month Performance": "Perf.3M",
+    "5Y Performance": "Perf.5Y",
+    "6-Month Performance": "Perf.6M",
+    "All Time Performance": "Perf.All",
+    "Weekly Performance": "Perf.W",
+    "Yearly Performance": "Perf.Y",
+    "YTD Performance": "Perf.YTD",
+    # Pivot Points (Classic)
+    "Pivot Classic P": "Pivot.M.Classic.Middle",
+    "Pivot Classic R1": "Pivot.M.Classic.R1",
+    "Pivot Classic R2": "Pivot.M.Classic.R2",
+    "Pivot Classic R3": "Pivot.M.Classic.R3",
+    "Pivot Classic S1": "Pivot.M.Classic.S1",
+    "Pivot Classic S2": "Pivot.M.Classic.S2",
+    "Pivot Classic S3": "Pivot.M.Classic.S3",
+    # Pivot Points (Fibonacci)
+    "Pivot Fibonacci P": "Pivot.M.Fibonacci.Middle",
+    "Pivot Fibonacci R1": "Pivot.M.Fibonacci.R1",
+    "Pivot Fibonacci R2": "Pivot.M.Fibonacci.R2",
+    "Pivot Fibonacci R3": "Pivot.M.Fibonacci.R3",
+    "Pivot Fibonacci S1": "Pivot.M.Fibonacci.S1",
+    "Pivot Fibonacci S2": "Pivot.M.Fibonacci.S2",
+    "Pivot Fibonacci S3": "Pivot.M.Fibonacci.S3",
+    # Rate of Change
+    "Rate Of Change (9)": "ROC",
+    # RSI
+    "Relative Strength Index (14)": "RSI",
+    "Relative Strength Index (7)": "RSI7",
+    # Recommendations
+    "Technical Rating": "Recommend.All",
+    "Moving Averages Rating": "Recommend.MA",
+    "Oscillators Rating": "Recommend.Other",
+    # SMAs
+    "Simple Moving Average (5)": "SMA5",
+    "Simple Moving Average (10)": "SMA10",
+    "Simple Moving Average (20)": "SMA20",
+    "Simple Moving Average (30)": "SMA30",
+    "Simple Moving Average (50)": "SMA50",
+    "Simple Moving Average (100)": "SMA100",
+    "Simple Moving Average (200)": "SMA200",
+    # Stochastic
+    "Stochastic %D (14, 3, 3)": "Stoch.D",
+    "Stochastic %K (14, 3, 3)": "Stoch.K",
+    "Stochastic RSI Slow (3, 3, 14, 14)": "Stoch.RSI.D",
+    "Stochastic RSI Fast (3, 3, 14, 14)": "Stoch.RSI.K",
+    # Other
+    "Ultimate Oscillator (7, 14, 28)": "UO",
+    "Volume Weighted Average Price": "VWAP",
+    "Volume Weighted Moving Average (20)": "VWMA",
+    "Volume*Price": "Value.Traded",
+    "Volatility": "Volatility.D",
+    "Volatility Month": "Volatility.M",
+    "Volatility Week": "Volatility.W",
+    "Williams Percent Range (14)": "W.R",
+    # Fundamentals
+    "Net Margin (TTM)": "after_tax_margin",
+    "Average Volume (10 day)": "average_volume_10d_calc",
+    "Average Volume (30 day)": "average_volume_30d_calc",
+    "Average Volume (60 day)": "average_volume_60d_calc",
+    "Average Volume (90 day)": "average_volume_90d_calc",
+    "Basic EPS (FY)": "basic_eps_net_income",
+    "1-Year Beta": "beta_1_year",
+    "Cash & Equivalents (MRQ)": "cash_n_equivalents_fq",
+    "Cash & Equivalents (FY)": "cash_n_equivalents_fy",
+    # Price/Change
+    "Change %": "change",
+    "Change": "change_abs",
+    "Change from Open %": "change_from_open",
+    "Change from Open": "change_from_open_abs",
+    "Price": "close",
+    "Country": "country",
+    "Currency": "currency",
+    # Debt
+    "Current Ratio (MRQ)": "current_ratio",
+    "Debt to Equity Ratio (MRQ)": "debt_to_equity",
+    # Dividends
+    "Dividend Yield Forward": "dividend_yield_recent",
+    "Dividends Paid (FY)": "dividends_paid",
+    "Dividends per Share (MRQ)": "dividends_per_share_fq",
+    # EPS
+    "Basic EPS (TTM)": "earnings_per_share_basic_ttm",
+    "EPS Diluted (TTM)": "earnings_per_share_diluted_ttm",
+    "EPS Forecast (MRQ)": "earnings_per_share_forecast_next_fq",
+    "EPS Diluted (MRQ)": "earnings_per_share_fq",
+    # Earnings
+    "Recent Earnings Date": "earnings_release_date",
+    "Upcoming Earnings Date": "earnings_release_next_date",
+    "EBITDA (TTM)": "ebitda",
+    # Enterprise Value
+    "Enterprise Value/EBITDA (TTM)": "enterprise_value_ebitda_ttm",
+    "Enterprise Value (MRQ)": "enterprise_value_fq",
+    # Basic Info
+    "Exchange": "exchange",
+    "Shares Float": "float_shares_outstanding",
+    # Gap
+    "Gap %": "gap",
+    # Margins
+    "Gross Margin (TTM)": "gross_margin",
+    "Gross Profit (FY)": "gross_profit",
+    # OHLCV
+    "High": "high",
+    "Low": "low",
+    "Open": "open",
+    "Volume": "volume",
+    # Identification
+    "Industry": "industry",
+    "Sector": "sector",
+    "Market": "market",
+    "Name": "name",
+    "Description": "description",
+    "Type": "type",
+    # Market Cap
+    "Market Capitalization": "market_cap_basic",
+    # Net Income
+    "Net Debt (MRQ)": "net_debt",
+    "Net Income (FY)": "net_income",
+    # P/E Ratios
+    "Price to Earnings Ratio (TTM)": "price_earnings_ttm",
+    "Price to Book (MRQ)": "price_book_fq",
+    "Price to Sales (FY)": "price_sales_ratio",
+    "Price to Free Cash Flow (TTM)": "price_free_cash_flow_ttm",
+    # 52 Week
+    "52 Week High": "price_52_week_high",
+    "52 Week Low": "price_52_week_low",
+    # Pre/Post Market
+    "Pre-market Change %": "premarket_change",
+    "Pre-market Change": "premarket_change_abs",
+    "Pre-market Close": "premarket_close",
+    "Pre-market High": "premarket_high",
+    "Pre-market Low": "premarket_low",
+    "Pre-market Open": "premarket_open",
+    "Pre-market Volume": "premarket_volume",
+    "Pre-market Gap %": "premarket_gap",
+    "Post-market Change %": "postmarket_change",
+    "Post-market Change": "postmarket_change_abs",
+    "Post-market Close": "postmarket_close",
+    "Post-market High": "postmarket_high",
+    "Post-market Low": "postmarket_low",
+    "Post-market Open": "postmarket_open",
+    "Post-market Volume": "postmarket_volume",
+    # Relative Volume
+    "Relative Volume": "relative_volume_10d_calc",
+    "Relative Volume at Time": "relative_volume_intraday|5",
+    # Returns
+    "Return on Assets (TTM)": "return_on_assets",
+    "Return on Equity (TTM)": "return_on_equity",
+    "Return on Invested Capital (TTM)": "return_on_invested_capital",
+    # Revenue
+    "Total Revenue (FY)": "total_revenue",
+    "Revenue per Employee (FY)": "revenue_per_employee",
+    # Shares
+    "Total Shares Outstanding": "total_shares_outstanding_fundamental",
+    # Assets
+    "Total Assets (MRQ)": "total_assets",
+    "Total Current Assets (MRQ)": "total_current_assets",
+    "Total Debt (MRQ)": "total_debt",
+    "Total Liabilities (MRQ)": "total_liabilities_fq",
+    # Crypto specific
+    "24h Volume": "24h_vol|5",
+    "24h Change %": "24h_close_change|5",
+    "24h Volume Change %": "24h_vol_change|5",
+    "24h Volume to Market Cap": "24h_vol_to_market_cap",
+    # Quick ratio
+    "Quick Ratio (MRQ)": "quick_ratio",
+}
+
+# Default columns for different query types
+DEFAULT_COLUMNS = ["name", "close", "volume", "market_cap_basic"]
+
+PREMARKET_COLUMNS = ["name", "close", "volume", "premarket_change", "premarket_change_abs", "premarket_volume"]
+
+POSTMARKET_COLUMNS = ["name", "close", "volume", "postmarket_change", "postmarket_change_abs", "postmarket_volume"]
+
+CRYPTO_COLUMNS = ["name", "close", "volume", "change", "market_cap_basic", "24h_vol|5"]
+
+TECHNICAL_COLUMNS = [
+    "name",
+    "close",
+    "volume",
+    "change",
+    "RSI",
+    "MACD.macd",
+    "MACD.signal",
+    "BB.upper",
+    "BB.lower",
+    "SMA20",
+    "EMA50",
+    "EMA200",
+    "ADX",
+    "Stoch.K",
+    "Stoch.D",
+]
+
+
+def get_column_name(name: str) -> str:
+    """Get the API column name from a human-readable name or return as-is."""
+    return COLUMNS.get(name, name)