TradingView API & Scraper
The TradingView API returns TradingView's screener, quotes, company profiles, technical-analysis summaries, financial statements, OHLCV history, earnings, dividend, IPO and economic calendars, news and community ideas and scripts from tradingview.com as JSON.
🤖 Using an AI assistant? Copy this link into ChatGPT / Claude / Cursor — it reads every endpoint and parameter instantly and tells you if this API fits your use case.
It reads the site logged out. `screener` runs TradingView's own screener over any of 71 country stock markets (8,060 US stocks in the site's stock universe on 2026-11-16) or over crypto pairs, coins, forex, futures, government bond yields, CFDs and economic indicators, with the filters the site's screener offers: sector, industry, exchange, company country and index membership by TradingView's own names (S&P 500: 498 rows), market cap, price, daily change, volume, relative volume, P/E, dividend yield, RSI, year-to-date performance, beta, employees, analyst rating and technical rating, ready-made presets such as gainers or 52-week highs, plus any of the ~3,800 TradingView fields as a raw condition such as 'close > SMA200'; `screener_fields` lists those fields and the accepted values. `crypto` and `etfs` are TradingView's coin and ETF screeners. `search` finds any instrument by ticker, name, ISIN or CUSIP. `quote` prices up to 100 instruments in one call and says for each whether the price is real time or delayed: 15 minutes for NASDAQ, NYSE, BIST, NSE and XETRA, 20 for Tokyo, 10 for CME futures and the S&P 500 index, real time for crypto, forex and London. `symbol` returns the full company record: description, CEO, website, headquarters, founded, employees, ISIN, CUSIP, FIGI, valuation, dividends, earnings, analyst price targets and buy/hold/sell counts, performance and the all-time range; `markets` lists the same instrument's other listings. `technicals` gives the buy/sell gauges and every oscillator, moving average and pivot for one timeframe; `financials` the statements; `history` up to 5,000 OHLCV candles per call. `earnings_calendar`, `dividends_calendar`, `ipo_calendar` and `economic_calendar` cover the calendars; `news` and `news_story` the news feed with full text; `ideas`, `idea`, `idea_comments`, `scripts`, `script`, `minds`, `mind` and `user` TradingView's community posts and members.
What a TradingView field actually contains
Fields that read differently from how they look. Every row was measured against live tradingview.com data on 2026-11-15 and 2026-11-16.
| Field | What it holds |
|---|---|
| price, quote price | The last price the symbol page prints ('trades at X'), in the listing's own currency (currency). On 10 symbols in 8 markets checked the same minute, 10 of 10 matched the page. |
| data_mode, delay_minutes | Whether the price is real time or delayed, as TradingView publishes it to logged-out visitors: NASDAQ, NYSE, BIST, NSE and XETRA 15 minutes, Tokyo 20, CME futures and the S&P 500 index 10, crypto, forex and London real time (0). |
| sector, industry, exchange, country, index (screener) | TradingView's own names and symbols, as the screener prints them (sector Finance, index SP:SPX). Upper or lower case and common spellings are accepted; screener_fields lists every accepted value per market. |
| market_cap, market_cap_currency | The screener's 'Market cap' column, in the company's reporting currency (Shell: 210.62 B GBP while the price is in pence). The page's FAQ sentence multiplies price by current shares instead and can differ: Turkish Airlines 441.94 B vs 439.50 B TRY, SAP 249.22 B vs 240.98 B EUR. shares_outstanding is returned too. |
| fundamental_currency | The currency of every fundamental number (EPS, revenue, market cap): the company's reporting currency, as the page prints it. Reliance EPS reads 18.90 INR, not a USD conversion. |
| analysts.price_target | The analysts' price range in the price currency, as the page prints it (Shell 3,468.87 to 5,002.56 GBX), with price_target.currency. |
| analysts.recommendations | The 5-point analyst count: strong_buy, buy, hold, sell, strong_sell and total. analyst_rating in screener rows is the consensus label. |
| technical_rating, technical_rating_label | TradingView's daily Buy/Sell gauge from -1 to 1, labelled with TradingView's own thresholds: 0.5 and above strong_buy, 0.1 buy, between -0.1 and 0.1 neutral, -0.5 or below strong_sell. |
| earnings.next_release_time_code | TradingView's code for when the next report comes out, as published (-1, 1 …), not translated. |
| financials history | Arrays newest first. TradingView publishes 20 fiscal years or 32 quarters of history for 12 lines (revenue, gross profit, net income, EBITDA, EPS, dividends per share, total assets, total debt, free cash flow, capital expenditures); the other lines carry the latest period and the trailing twelve months. Quarterly history carries no period labels. |
| ideas symbol.name | Idea lists carry the symbol, ticker and exchange but not the instrument's long name; idea returns it. |
On 10 symbols in 8 markets, 127 of 128 values matched what the symbol page itself prints, the same minute. The one difference was a crypto page showing an older 1-day change than the live price.
Real request and response JSON
Captured from the indexed primary action, search, on .
{
"method": "POST",
"url": "https://api.reefapi.com/tradingview/v1/search",
"headers": {
"x-api-key": "$REEF_KEY",
"content-type": "application/json"
},
"body": {
"query": "apple"
}
}{
"ok": true,
"meta": {
"api": "tradingview",
"endpoint": "search",
"mode": "live",
"latency_ms": 769.5,
"record_count": 50,
"bytes": 22096,
"cache_hit": false,
"upstream_requests": 1,
"charged_credits": 1,
"version": "1.0.1",
"request_id": "ec94c8f7e7ec4640",
"queue_ms": 1.3,
"fetched_at": "2026-11-15T22:38:35.996Z"
},
"data": {
"query": "apple",
"type": null,
"results": [
{
"symbol": "NASDAQ:AAPL",
"ticker": "AAPL",
"exchange": "NASDAQ",
"exchange_name": "Nasdaq Stock Market",
"name": "Apple Inc.",
"link": "https://www.tradingview.com/symbols/NASDAQ-AAPL/",
"type": "stock",
"typespecs": [
"common"
],
"country": "US",
"currency": "USD",
"isin": "US0378331005",
"cusip": "037833100",
"cik": "0000320193",
"is_primary_listing": true,
"found_by_isin": false,
"found_by_cusip": false,
"ipo_date": null,
"logo": "https://s3-symbol-logo.tradingview.com/apple.svg",
"logo_secondary": null,
"data_provider": "ice",
"futures_root": null,
"contracts": null
},
{
"symbol": "ICEEUR:89A1!",
"ticker": "89A1!",
"exchange": "ICEEUR",
"exchange_name": "ICE Futures Europe",
"name": "Apple Inc - STND Futures",
"link": "https://www.tradingview.com/symbols/ICEEUR-89A1!/",
"type": "futures",
"typespecs": [],
"country": "EU",
"currency": "USD",
"isin": null,
"cusip": null,
"cik": null,
"is_primary_listing": null,
"found_by_isin": false,
"found_by_cusip": false,
"ipo_date": null,
"logo": null,
"logo_secondary": null,
"data_provider": "ice",
"futures_root": "ICEEUR:89A",
"contracts": [
{
"symbol": "[trimmed-depth]",
"name": "[trimmed-depth]"
},
{
"symbol": "[trimmed-depth]",
"name": "[trimmed-depth]"
},
{
"symbol": "[trimmed-depth]",
"name": "[trimmed-depth]"
}
]
},
{
"symbol": "OKX:XAAPLUSDT",
"ticker": "XAAPLUSDT",
"exchange": "OKX",
"exchange_name": "OKX",
"name": "Apple Inc./USDT",
"link": "https://www.tradingview.com/symbols/OKX-XAAPLUSDT/",
"type": "spot",
"typespecs": [
"crypto",
"defi"
],
"country": null,
"currency": "USDT",
"isin": null,
"cusip": null,
"cik": null,
"is_primary_listing": null,
"found_by_isin": false,
"found_by_cusip": false,
"ipo_date": null,
"logo": "https://s3-symbol-logo.tradingview.com/crypto/XTVCAAPLX.svg",
"logo_secondary": null,
"data_provider": "okx",
"futures_root": null,
"contracts": null
}
],
"count": 50,
"page": 1,
"page_size": 50,
"total": 1056,
"total_pages": 22,
"has_next": true
}
}What the TradingView API does
| Action | Description | Concrete use case | Key params |
|---|---|---|---|
| search | Search every instrument TradingView lists — stocks, ETFs, crypto pairs, futures, forex, indices, bonds, options, economic series — by ticker, name, ISIN or CUSIP, with type / exchange / country filters. 50 per page, up to 10,000 results (200 pages). | Fintech apps call search to search every instrument TradingView lists. | query, type, exchange, country, page |
| quote | Live quotes for up to 100 instruments in one call (any mix of markets): price, change, open / high / low, volume, market cap, pre-/post-market, 52-week range, technical rating, and whether the price is real-time or delayed (delay_minutes). | Portfolio dashboards call quote to get live quotes for up to 100 instruments in one call (any mix of markets). | symbols |
| symbol | Everything TradingView publishes about one instrument: company profile (description, CEO, website, headquarters, founded, employees, sector / industry, ISIN, CUSIP, FIGI), price and today's range, pre/post-market, market cap, valuation (P/E, P/S, P/B, EV/EBITDA), margins, dividends (yield, last and next ex-date and amount), earnings (last, next date, EPS / revenue estimates and surprise), analyst price targets and buy/hold/sell counts, performance (1W … all time), 52-week and all-time range, technical rating, crypto supply data, the site's daily summary and latest earnings summary, and peers. | Analysts call symbol to get everything TradingView publishes about one instrument. | symbol |
| technicals | TradingView's technical-analysis summary for one symbol at one timeframe (1m … 1mo): the overall, moving-average and oscillator gauges (strong buy … strong sell), every oscillator value (RSI, Stochastic, CCI, ADX, AO, Momentum, MACD, Stoch RSI, Williams %R, Bull Bear Power, Ultimate), every moving average (EMA/SMA 10-200, Ichimoku, VWMA, Hull), per-indicator signals, monthly pivot points (Classic, Fibonacci, Camarilla, Woodie, DeMark), Bollinger bands, ATR, VWAP. | Data teams call technicals to get tradingView's technical-analysis summary for one symbol at one timeframe (1m … 1mo). | symbol, interval |
| financials | Financial statements of a company as TradingView publishes them: income statement, balance sheet, cash flow and ratios — history arrays (newest first; up to 20 fiscal years or 32 quarters), the latest period and the trailing twelve months, with the fiscal period labels. | Fintech apps call financials to get financial statements of a company as TradingView publishes them. | symbol, statement, period |
| history | OHLCV candles from TradingView's chart feed for any symbol and timeframe (1m … 1mo): up to 5000 most recent bars per call, split-adjusted, with the symbol's session and timezone. | Portfolio dashboards call history to get oHLCV candles from TradingView's chart feed for any symbol and timeframe (1m … 1mo). | symbol, interval, bars |
| markets | Every listing of an instrument across exchanges (the symbol page's Markets tab): e.g. BTCUSD on each crypto exchange, or a stock's foreign listings, with price, change, volume and rating. | Analysts call markets to get every listing of an instrument across exchanges (the symbol page's Markets tab). | symbol |
| screener | TradingView's screener over any market: stocks of 71 countries, crypto, coins, forex, futures, bonds, CFDs, economic indicators — with the site's own filters (sector, industry, exchange, country, index membership, market cap, price, change, volume, relative volume, P/E, dividend yield, RSI, YTD performance, beta, employees, analyst and technical rating, name match), market-movers presets, any scanner field as a raw filter (field-vs-field too), column presets or your own columns, sort by any field, pages of up to 150 rows with the full total. | Data teams call screener to get tradingView's screener over any market. | market, preset, sector, industry, exchange, ... |
| screener_fields | The field catalogue of a scanner market — every field id the screener / filters / columns accept (~3,800 for stock markets), its type, and the allowed values of text fields (sectors, industries, exchanges, countries …) as published for that market. | Fintech apps call screener_fields to get the field catalogue of a scanner market. | market, query, type |
| crypto | Crypto coins ranked as on TradingView's coin screener: rank, price, 24h change, market cap, 24h volume and its change, circulating / total / max supply, categories, technical rating and performance — with market-cap / volume / change filters and sorts. | Portfolio dashboards call crypto to get crypto coins ranked as on TradingView's coin screener. | sort, order, category, market_cap_min, volume_min, ... |
| etfs | ETFs of a country market as on TradingView's ETF screener: AUM, fund flows (1M / 1Y), expense ratio, NAV total return (1/3/5Y), dividend yield, focus, asset class, category, issuer, index tracked, holdings count, launch date — with AUM / expense-ratio / asset-class / issuer filters and sorts. | Analysts call etfs to get eTFs of a country market as on TradingView's ETF screener. | market, sort, order, asset_class, issuer, ... |
| earnings_calendar | Earnings calendar of a country market for a date range: upcoming releases (date, before/after-market time code, EPS and revenue estimates) or reported ones (actual EPS / revenue, estimate, surprise), largest companies first. | Data teams call earnings_calendar to get earnings calendar of a country market for a date range. | market, from, to, status, market_cap_min, ... |
| dividends_calendar | Dividend calendar of a country market: companies whose ex-dividend date (or payment date) falls in the range, with amount, payment date, yield and frequency. | Fintech apps call dividends_calendar to get dividend calendar of a country market. | market, from, to, date_type, market_cap_min, ... |
| ipo_calendar | IPOs of a country market: listings whose IPO date falls in the range, with offer price, price range, shares offered, deal size, market cap at IPO and the performance since the offer. | Portfolio dashboards call ipo_calendar to get iPOs of a country market. | market, from, to, page, page_size |
| economic_calendar | Economic calendar: releases (CPI, GDP, jobs, rates, PMIs …) in a date range for chosen countries, with actual, forecast and previous values, unit, importance, period and source. | Analysts call economic_calendar to get economic calendar. | from, to, countries, importance |
| news | TradingView news headlines with the site's own filters: one symbol, market (stocks, crypto, forex, futures, bonds, ETFs, economy), country, provider (Reuters, Dow Jones, Benzinga …), format (flash, important, top stories, key facts), sector, corporate activity (earnings, dividends, M&A, IPOs, analysts …), economic category, crypto topic and language. One feed answers up to 200 newest headlines; the site offers no further paging to logged-out readers. | Data teams call news to get tradingView news headlines with the site's own filters. | symbol, market, country, provider, priority, ... |
| news_story | One news story with its full text as TradingView shows it (paywalled providers carry a preview only), short description, images, tags, related symbols and provider. | Fintech apps call news_story to get one news story with its full text as TradingView shows it (paywalled providers carry a previe…. | story, lang |
| ideas | Trading ideas published on TradingView: for a symbol, by a member, a market / topic feed (stocks, crypto, forex, editors-picks, trend-analysis …) or a text search; sorted recent / popular / trending. Each idea: title, preview text, chart image, symbol, timeframe, long / short, likes, comments, author with profile link. Feeds stop at 1,000 ideas. | Portfolio dashboards call ideas to get trading ideas published on TradingView. | symbol, user, topic, query, type, ... |
| idea | One trading idea in full: title, the complete text, chart image and images in the text, symbol, timeframe, long / short, likes, views, comments count, tags, updates, related ideas, author (username, profile link, badges, plan) and the first comments. | Analysts call idea to get one trading idea in full. | idea |
| idea_comments | Comments on an idea (top-level, page by page), or the replies under one comment. | Data teams call idea_comments to get comments on an idea (top-level, page by page), or the replies under one comment.. | idea, comment, page |
| scripts | Community scripts (indicators, strategies, libraries): the scripts feed, a tag feed (rsi, volume, supertrend …), a text search or one member's scripts; with access type (open-source / protected / invite-only), likes, comments and author. Feeds stop at 1,000 scripts. | Fintech apps call scripts to get community scripts (indicators, strategies, libraries). | query, tag, user, type, sort, ... |
| script | One community script in full: description, type, access, version, likes, views, author, tags, and the Pine Script source code when the author publishes it open-source. | Portfolio dashboards call script to get one community script in full. | script |
| minds | Minds — TradingView's short posts — for a symbol or by a member, newest first, with text, likes, comments, tagged symbols, chart snapshot and author; cursor paging. | Analysts call minds to get minds. | symbol, user, cursor |
| mind | One Minds post with its comments. | Data teams call mind to get one Minds post with its comments.. | mind |
| user | A TradingView member profile: followers, following, ideas and scripts published, join date, last seen, badges / plan, bio and social links. | Fintech apps call user to get a TradingView member profile. | user |
Call search from your stack
curl -X POST https://api.reefapi.com/tradingview/v1/search \
-H "x-api-key: $REEF_KEY" \
-H "content-type: application/json" \
-d '{"query":"apple"}'import os
import requests
REEF_KEY = os.environ["REEF_KEY"]
r = requests.post(
"https://api.reefapi.com/tradingview/v1/search",
headers={"x-api-key": REEF_KEY},
json={
"query": "apple"
},
timeout=90,
)
print(r.json()["data"])const res = await fetch("https://api.reefapi.com/tradingview/v1/search", {
method: "POST",
headers: {
"x-api-key": process.env.REEF_KEY,
"content-type": "application/json",
},
body: JSON.stringify({
"query": "apple"
}),
});
const { ok, data, meta, error } = await res.json();Ask your MCP-connected assistant: call reefapi.tradingview.search with {"query":"apple"}.Who uses this API and why
- Run a daily stock screen (sector, market cap, RSI, analyst rating) across any of 71 countries.
- Price a portfolio of up to 100 stocks, ETFs, coins and currency pairs in one call, knowing which prices are delayed.
- Pull company profiles, analyst targets and financial statements for a watchlist.
- Feed OHLCV candles and technical summaries into a trading model.
- Collect earnings, dividend, IPO and economic calendars with estimates and actuals.
Questions developers ask before integrating
Is there a TradingView API?
Yes. The tradingview API on ReefAPI returns TradingView's screener, quotes, company profiles, technicals, financials, OHLCV history, calendars, news, ideas and scripts as JSON, read logged out, no TradingView account needed. Watchlists, alerts, portfolios and private ideas need a login and are not available.
Which screener filters can I use?
Sector, industry, exchange, company country and index membership (by TradingView's own names), market cap, price, daily change, volume, relative volume, P/E, dividend yield, RSI, year-to-date performance, beta, employees, analyst rating, technical rating and a name match, plus any TradingView field as 'field operator value' (RSI < 30, close > SMA200, EMA20 crosses_above EMA50). On 8,060 US stocks on 2026-11-16: Finance 1,790, S&P 500 members 498, market cap over 10 B 759, dividend yield 4 % or more 758, RSI under 30 570, analysts' strong buy 1,620, closing above the 200-day SMA 2,412.
Which markets does the screener cover?
Stocks of 71 countries (US 8,060, India 5,476, China 5,379, Japan 3,869, UK 1,323, Turkey 623, Germany 427 in the site's stock universe), 65,355 crypto pairs, 2,431 coins, 6,291 forex pairs, 52,462 futures, 1,163 government bond yields, 650 CFDs and 15,170 economic indicators.
Are the prices real time?
As TradingView publishes them to logged-out visitors, and every row says which: delay_minutes is 15 for NASDAQ, NYSE, BIST, NSE and XETRA, 20 for Tokyo, 10 for CME futures and the S&P 500 index, and 0 for crypto, forex and London.
How much price history can I get?
Up to 5,000 candles per call at 1 minute to 1 month. Asking for every daily Apple bar returned 11,568, back to 1980.
How deep do the lists go?
Screener pages of up to 150 rows over the full total. Symbol search stops at 10,000 results. Idea and script feeds stop at 1,000 items sorted by popularity and 12,000 sorted by newest; a symbol's or member's ideas at 1,000. A news feed returns the newest 200 headlines; TradingView offers no further paging to logged-out readers.
Can I get TradingView's technical analysis summary?
Yes: technicals returns the overall, moving-average and oscillator gauges and every indicator value and pivot for 1m to 1 month on stocks, ETFs, indices, crypto and forex. Continuous futures contracts carry the daily summary only, and government bond yields carry none.
Do I get the authors of ideas and scripts?
Yes, as TradingView publishes them: username, profile link, avatar, badges and plan, and user returns the member's followers, ideas and scripts counts and social links.
What is the TradingView API?
TradingView API is a ReefAPI endpoint group for tradingview's screener with every filter, quotes, company profiles, technicals, financials, ohlcv history, calendars, news, ideas and scripts as json. It returns live JSON through POST requests under /tradingview/v1.
Is the TradingView API free to try?
Yes. ReefAPI starts with 1,000 free credits, no card required. TradingView calls use the same shared credit balance as every other ReefAPI engine.
Do I need a TradingView login or account?
No login to TradingView is needed for the API response. You call ReefAPI with your x-api-key header, and the playground can run live examples before you create a production key.
How fresh is the TradingView data?
The page example is captured from a live search call, and production requests fetch live data through ReefAPI rather than a static sample.
How many credits does the TradingView API use?
TradingView actions currently cost 1-3 credits per successful call. Failed or blocked calls are free. All APIs draw from one credit pool.
Can I call TradingView from an AI assistant or MCP client?
Yes. Connect ReefAPI once through MCP and your assistant can call tradingview actions with the same key, credit pool and JSON envelope used by normal REST requests.