TradingView symbol overview
One symbol on TradingView (stock, ETF, crypto pair, currency, index, future): name, type, exchange, currency, country, sector, industry, ISIN/CUSIP/CIK; price, open, high, low, change, volume and average volume, pre- and post-market price; market cap, enterprise value, P/E, EPS, dividend yield, P/B, P/S, revenue, net income, margins, ROE, debt/equity, employees, beta, share counts, next and last earnings dates; 52-week and all-time high/low, performance (1 w to 5 y), volatility and the overall technical rating. Fields that do not apply to the asset type are null. Also returns analyst (average, median, high and low price target; strong buy, buy, hold, sell and strong sell counts; consensus rating; EPS and revenue forecasts for this and next fiscal quarter), dividends (yield, payout ratio, dividend per share for the fiscal year and quarter with growth, the last and upcoming dividend with amount, ex-date and payment date, years of continuous payouts and growth) and financials (total assets, total debt, cash and short-term investments, free cash flow, EBITDA, return on assets, current and quick ratio, price to free cash flow, EV/EBITDA); each is null when it does not apply. fields adds any other screener columns under fields.
Every response includes credits_used: the credits this call cost.
Parameters
| name | type | description |
|---|---|---|
symbolrequired | string | Symbol as EXCHANGE:TICKER, e.g. NASDAQ:AAPL, NYSE:BRK.B, NSE:RELIANCE, BINANCE:BTCUSDT, FX:EURUSD, TVC:GOLD (find it with /tradingview/v1/search). Example: NASDAQ:AAPL |
fields | string | Extra columns to return under fields, comma-separated screener column names (up to 50), e.g. Perf.10Y,EMA50,RSI|60,price_target_1y. Unknown columns come back as null. |
Every endpoint also takes fresh, raw, fields (see lean responses and caching).
Example
curl "https://api.api.sh/tradingview/v1/symbol?symbol=NASDAQ%3AAAPL" \
-H "x-api-key: $APISH_KEY" import os, requests
res = requests.get(
"https://api.api.sh/tradingview/v1/symbol",
params={"symbol": "NASDAQ:AAPL"},
headers={"x-api-key": os.environ["APISH_KEY"]},
timeout=120,
)
res.raise_for_status()
data = res.json() const url = new URL("https://api.api.sh/tradingview/v1/symbol");
url.searchParams.set("symbol", "NASDAQ:AAPL");
const res = await fetch(url, { headers: { "x-api-key": process.env.APISH_KEY } });
if (!res.ok) throw new Error(`${res.status} ${await res.text()}`);
const data = await res.json(); Response
A JSON object with the fields described above, plus raw (the source's own data), cached, fetched_at and credits_used. Errors return {"success": false, "error": "…"} with the HTTP status (see errors). A lookup that ran but found nothing (404) costs the price above; refused calls and errors on our side are free (what's charged).