Symbol Markets

SymbolMarkets helps you find where a symbol is traded across TradingView scanners.

Quick Use

from tv_scraper import SymbolMarkets

scraper = SymbolMarkets()
scraper = SymbolMarkets()
result = scraper.get_symbol_markets(exchange="NASDAQ", symbol="AAPL")

Output structure:

{
    "status": "success",
    "data": [
        {
            "symbol": "NASDAQ:AAPL",
            "name": "AAPL",
            "close": 150.25,
            "exchange": "NASDAQ",
            "type": "stock",
            "currency": "USD",
        },
        ...
    ],
    "metadata": {
        "exchange": "NASDAQ",
        "symbol": "AAPL",
        "scanner": "global",
        "total": 14,
        "total_available": 14,
    },
    "warnings": [],
    "error": None,
}

You can also pass an exchange-prefixed symbol:

result = scraper.get_symbol_markets(exchange="NASDAQ", symbol="AAPL")

Output structure:

{
    "status": "success",
    "data": [
        {
            "symbol": "NASDAQ:AAPL",
            "name": "AAPL",
            "close": 150.25,
            "exchange": "NASDAQ",
        },
        ...
    ],
    "metadata": {
        "exchange": "NASDAQ",
        "symbol": "AAPL",
        "scanner": "global",
        "total": 14,
        "total_available": 14,
    },
    "warnings": [],
    "error": None,
}

The scraper uses only the part after : for matching.

Inputs

Parameter	Accepted values
symbol	plain symbol or EXCHANGE:SYMBOL
scanner	global, america, crypto, forex, cfd
limit	1 to 1000
fields	optional field list

wrong input

Older examples sometimes use the wrong method name. This is wrong:

scraper.get_markets(symbol="AAPL")

Use:

scraper.get_symbol_markets(exchange="NASDAQ", symbol="AAPL")

Notes

• If no rows are found, the method returns status="failed".
• Metadata keeps your original exchange and symbol inputs.