# TradingView API — stock, crypto, forex, futures, bond and ETF screener with every TradingView filter (sector, index, market cap, P/E, RSI, analyst and technical rating, any of ~3,800 fields), market movers, symbol search, batch quotes, full symbol profiles, technical analysis per timeframe, financial statements, OHLCV history, earnings / dividend / IPO / economic calendars, news with full text, trading ideas, scripts, Minds and member profiles — no API key, no account

> 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).
> ReefAPI engine `tradingview` · 25 endpoints · clean JSON, no scraping or browsers to manage.

## How to call
- **Endpoint:** `POST https://api.reefapi.com/tradingview/v1/<action>` with a JSON body.
- **Auth:** header `x-api-key: <YOUR_REEFAPI_KEY>` — create one free (1,000 credits, no card): https://reefapi.com/signup
- **Response (every call):** `{ ok: boolean, data: ..., meta: { record_count, credits, ... }, error: { code, message } }` — branch on `ok`. Failed calls are free.
- **One key + one shared credit pool** across every ReefAPI API. Per-call credits are listed on each endpoint below.
- **Use it from an AI agent (MCP):** connect `https://api.reefapi.com/mcp` (remote streamable-http). Clients that add connectors by URL, such as ChatGPT and the Claude app, connect with OAuth 2.1 (the user pastes their key once on a ReefAPI page; discovery at `/.well-known/oauth-protected-resource/mcp`). Config files send the key as `Authorization: Bearer <key>`. `?key=<key>` in the URL also works as a last-resort fallback.

## Endpoints

### POST https://api.reefapi.com/tradingview/v1/search — 1 credit
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).

**Parameters:**
- `query` (string, required) — Ticker, company / instrument name, ISIN or CUSIP.
- `type` (enum, optional) — Asset class. [one of: stock, etf, fund, crypto, futures, forex, index, bond, economic, option, cfd]
- `exchange` (string, optional) — Exchange code (NASDAQ, NYSE, BIST, NSE, BINANCE …).
- `country` (string, optional) — ISO country code of the listing (US, DE, TR, IN …).
- `page` (integer, optional, default 1) — Page of 50.

**Returns:** results[]{symbol (EXCHANGE:TICKER), ticker, exchange, exchange_name, name, link, type, typespecs, country, currency, isin, cusip, cik, is_primary_listing, ipo_date, logo, data_provider} + total + page + has_next

**Example request body:**
```json
{
  "query": "apple"
}
```

### POST https://api.reefapi.com/tradingview/v1/quote — 1 credit
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).

**Parameters:**
- `symbols` (array, required) — Up to 100 symbols as EXCHANGE:TICKER (bare tickers are resolved through search, up to 10 per call).

**Returns:** results[]{symbol, ticker, exchange, name, price, change, change_percent, open, high, low, volume, market_cap, premarket_price, postmarket_price, high_52_week, low_52_week, technical_rating(+_label), rsi, currency, data_mode, delay_minutes, link, logo} + not_found[]

**Example request body:**
```json
{
  "symbols": [
    "NASDAQ:AAPL",
    "BINANCE:BTCUSDT"
  ]
}
```

### POST https://api.reefapi.com/tradingview/v1/symbol — 2 credits
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.

**Parameters:**
- `symbol` (string, required) — The instrument as EXCHANGE:TICKER (NASDAQ:AAPL, BIST:THYAO, BINANCE:BTCUSDT, FX:EURUSD, CME_MINI:ES1!), a bare ticker (AAPL — resolved through the site's own search, primary listing first) or a tradingview.com symbol link.

**Returns:** symbol, ticker, exchange, name, link, type, profile{description, ceo, website, headquarters, founded, employees, sector, industry, isin, cusip, figi, …}, price{…}, market_cap, valuation{…}, dividends{…}, earnings{…}, analysts{price_target{…}, recommendations{…}, rating}, performance{…}, ranges{…}, technicals{rating, label, rsi}, crypto{…}, fund{…}, daily_summary, latest_earnings_summary, peers[]

**Example request body:**
```json
{
  "symbol": "NASDAQ:AAPL"
}
```

### POST https://api.reefapi.com/tradingview/v1/technicals — 1 credit
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.

**Parameters:**
- `symbol` (string, required) — The instrument as EXCHANGE:TICKER (NASDAQ:AAPL, BIST:THYAO, BINANCE:BTCUSDT, FX:EURUSD, CME_MINI:ES1!), a bare ticker (AAPL — resolved through the site's own search, primary listing first) or a tradingview.com symbol link.
- `interval` (enum, optional, default "1d") — Timeframe. [one of: 1m, 5m, 15m, 30m, 1h, 2h, 4h, 1d, 1w, 1mo]

**Returns:** symbol, interval, price, summary{rating,label}, moving_averages{…}, oscillators{…}, oscillator_values{…}, moving_average_values{…}, price_vs_moving_averages{…}, indicator_signals{…}, pivots_monthly{classic{s3..r3}, …}, bollinger_bands, atr, vwap

**Example request body:**
```json
{
  "symbol": "NASDAQ:AAPL"
}
```

### POST https://api.reefapi.com/tradingview/v1/financials — 1 credit
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.

**Parameters:**
- `symbol` (string, required) — The instrument as EXCHANGE:TICKER (NASDAQ:AAPL, BIST:THYAO, BINANCE:BTCUSDT, FX:EURUSD, CME_MINI:ES1!), a bare ticker (AAPL — resolved through the site's own search, primary listing first) or a tradingview.com symbol link.
- `statement` (enum, optional, default "all") — Which statement. [one of: all, income, balance, cashflow, ratios]
- `period` (enum, optional, default "annual") — Fiscal years or quarters. [one of: annual, quarterly]

**Returns:** symbol, period, currency, periods[], statements{income{revenue{history[], latest, ttm}, …}, balance{…}, cashflow{…}, ratios{…}}

**Example request body:**
```json
{
  "symbol": "NASDAQ:AAPL"
}
```

### POST https://api.reefapi.com/tradingview/v1/history — 1 credit
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.

**Parameters:**
- `symbol` (string, required) — The instrument as EXCHANGE:TICKER (NASDAQ:AAPL, BIST:THYAO, BINANCE:BTCUSDT, FX:EURUSD, CME_MINI:ES1!), a bare ticker (AAPL — resolved through the site's own search, primary listing first) or a tradingview.com symbol link.
- `interval` (enum, optional, default "1d") — Timeframe. [one of: 1m, 5m, 15m, 30m, 1h, 2h, 4h, 1d, 1w, 1mo]
- `bars` (integer, optional, default 300) — Number of most recent candles (1-5000).

**Returns:** symbol, interval, count, symbol_info{name, exchange, type, currency, timezone, session, data_mode}, bars[]{time, timestamp, open, high, low, close, volume}

**Example request body:**
```json
{
  "symbol": "NASDAQ:AAPL"
}
```

### POST https://api.reefapi.com/tradingview/v1/markets — 1 credit
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.

**Parameters:**
- `symbol` (string, required) — The instrument as EXCHANGE:TICKER (NASDAQ:AAPL, BIST:THYAO, BINANCE:BTCUSDT, FX:EURUSD, CME_MINI:ES1!), a bare ticker (AAPL — resolved through the site's own search, primary listing first) or a tradingview.com symbol link.

**Returns:** symbol, count, results[]{symbol, ticker, exchange, exchange_name, name, type, price, change_percent, volume / volume_24h, high, low, technical_rating, link, logo}

**Example request body:**
```json
{
  "symbol": "NASDAQ:AAPL"
}
```

### POST https://api.reefapi.com/tradingview/v1/screener — 1 credit
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.

**Parameters:**
- `market` (enum, optional, default "america") — Scanner market: a country's listings (america, uk, germany, india, turkey, japan … 71 countries) or an asset class (crypto, coin, forex, futures, bonds = government bond yields, cfd, economics2). [one of: america, argentina, australia, austria, bahrain, bangladesh, belgium, brazil, bulgaria, canada, chile, china, colombia, croatia, cyprus, czech, denmark, egypt, estonia, finland, france, germany, greece, hongkong, hungary, iceland, india, indonesia, ireland, 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, slovenia, spain, srilanka, sweden, switzerland, taiwan, thailand, tunisia, turkey, uae, uk, venezuela, vietnam, crypto, coin, forex, futures, bonds, cfd, economics2]
- `preset` (enum, optional) — A ready-made screen (the site's market-movers lists): gainers, losers, most_active, unusual_volume, overbought, oversold, 52_week_high, all_time_high, large_cap, premarket_gainers …; combine with any filter. [one of: top_market_cap, gainers, losers, most_active, most_volatile, unusual_volume, overbought, oversold, strong_buy, strong_sell, large_cap, small_cap, penny_stocks, high_dividend, high_beta, 52_week_high, 52_week_low, all_time_high, highest_revenue, highest_net_income, largest_employers, premarket_gainers, premarket_losers, premarket_most_active, afterhours_gainers, afterhours_losers, afterhours_most_active]
- `sector` (array, optional) — Sector names as the site prints them (Finance, Electronic Technology, Technology Services, Health Technology …).
- `industry` (array, optional) — Industry names (Semiconductors, Regional Banks, Biotechnology …).
- `exchange` (array, optional) — Exchange codes (NASDAQ, NYSE, AMEX, OTC, LSE, XETR, NSE, BIST …).
- `country` (array, optional) — Company country (Canada, Israel, China …) — not the listing market.
- `index` (string, optional) — Only members of an index: SP:SPX (S&P 500), NASDAQ:NDX, DJ:DJI, BIST:XU100, NSE:NIFTY … (any index symbol), or SPX / NDX / DJI shortcuts.
- `market_cap_min` (number, optional) — Market capitalisation (in the listing's currency) minimum
- `market_cap_max` (number, optional) — Market capitalisation (in the listing's currency) maximum
- `price_min` (number, optional) — Last price minimum
- `price_max` (number, optional) — Last price maximum
- `change_min` (number, optional) — Today's change in % minimum
- `change_max` (number, optional) — Today's change in % maximum
- `volume_min` (number, optional) — Today's volume minimum
- `volume_max` (number, optional) — Today's volume maximum
- `relative_volume_min` (number, optional) — Relative volume (today vs 10-day average) minimum
- `relative_volume_max` (number, optional) — Relative volume (today vs 10-day average) maximum
- `pe_min` (number, optional) — P/E (TTM) minimum
- `pe_max` (number, optional) — P/E (TTM) maximum
- `dividend_yield_min` (number, optional) — Dividend yield % minimum
- `dividend_yield_max` (number, optional) — Dividend yield % maximum
- `rsi_min` (number, optional) — RSI(14), daily minimum
- `rsi_max` (number, optional) — RSI(14), daily maximum
- `perf_ytd_min` (number, optional) — Year-to-date performance % minimum
- `perf_ytd_max` (number, optional) — Year-to-date performance % maximum
- `beta_min` (number, optional) — 1-year beta minimum
- `beta_max` (number, optional) — 1-year beta maximum
- `employees_min` (number, optional) — Number of employees minimum
- `employees_max` (number, optional) — Number of employees maximum
- `analyst_rating` (array, optional) — Analyst consensus rating(s). [one of: strong_buy, buy, neutral, sell, strong_sell, no_rating]
- `technical_rating` (array, optional) — Daily technical rating(s) (the site's Buy/Sell gauge). [one of: strong_buy, buy, neutral, sell, strong_sell]
- `query` (string, optional) — Match in ticker or company name.
- `filters` (array, optional) — Any scanner field as 'field operator value' — operators > >= < <= = != between not_between in not_in has has_none_of match crosses crosses_above crosses_below above% below%; lists with | ('sector in Finance|Utilities', 'market_cap_basic between 1e9|1e10'); the right side can be another field ('close > SMA200', 'EMA20 crosses_above EMA50'). Field ids: the screener_fields action. Unknown fields are refused, not ignored.
- `columns` (array, optional) — Column presets (overview, performance, valuation, dividends, profitability, income, balance, cashflow, technicals, extended_hours) and/or scanner field ids; default overview.
- `sort` (string, optional) — Scanner field to sort by (default market cap, or the preset's own).
- `order` (enum, optional) — Sort direction. [one of: desc, asc]
- `universe` (enum, optional, default "stocks") — Country markets only. [one of: stocks, all]
- `page` (integer, optional, default 1) — Page number (1-based).
- `page_size` (integer, optional, default 50) — Rows per page (1-150).

**Returns:** results[]{symbol, ticker, exchange, link, name, price, change_percent, volume, market_cap, … one key per column, data_mode, delay_minutes} + total + page + total_pages + has_next + filters_applied

**Example request body:**
```json
{
  "market": "america"
}
```

### POST https://api.reefapi.com/tradingview/v1/screener_fields — 1 credit
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.

**Parameters:**
- `market` (enum, optional, default "america") — Scanner market. [one of: america, argentina, australia, austria, bahrain, bangladesh, belgium, brazil, bulgaria, canada, chile, china, colombia, croatia, cyprus, czech, denmark, egypt, estonia, finland, france, germany, greece, hongkong, hungary, iceland, india, indonesia, ireland, 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, slovenia, spain, srilanka, sweden, switzerland, taiwan, thailand, tunisia, turkey, uae, uk, venezuela, vietnam, crypto, coin, forex, futures, bonds, cfd, economics2]
- `query` (string, optional) — Only field ids containing this text (case-insensitive).
- `type` (enum, optional) — Only fields of this type. [one of: number, price, percent, fundamental_price, text, bool, time, set, time-yyyymmdd, num_slice, map, interface]

**Returns:** market, count, fields[]{id, type, values[]}

**Example request body:**
```json
{
  "market": "america"
}
```

### POST https://api.reefapi.com/tradingview/v1/crypto — 1 credit
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.

**Parameters:**
- `sort` (enum, optional, default "rank") — Sort. [one of: rank, market_cap, volume, change, price, name, perf_ytd]
- `order` (enum, optional) — Default asc for rank/name, desc otherwise. [one of: desc, asc]
- `category` (array, optional) — Coin categories as published (e.g. defi, layer-1, meme, stablecoins).
- `market_cap_min` (number, optional) — Minimum market cap (USD).
- `volume_min` (number, optional) — Minimum 24h volume (USD).
- `change_min` (number, optional) — Minimum 24h change %.
- `change_max` (number, optional) — Maximum 24h change %.
- `page` (integer, optional, default 1) — Page number (1-based).
- `page_size` (integer, optional, default 50) — Rows per page.

**Returns:** results[]{symbol, ticker, name, rank, price, currency, change_24h_percent, market_cap, volume_24h, volume_24h_change_percent, circulating_supply, total_supply, max_supply, categories[], technical_rating, performance_week … , logo, link} + total + paging

**Example request body:**
```json
{
  "sort": "rank"
}
```

### POST https://api.reefapi.com/tradingview/v1/etfs — 1 credit
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.

**Parameters:**
- `market` (enum, optional, default "america") — Country market. [one of: america, argentina, australia, austria, bahrain, bangladesh, belgium, brazil, bulgaria, canada, chile, china, colombia, croatia, cyprus, czech, denmark, egypt, estonia, finland, france, germany, greece, hongkong, hungary, iceland, india, indonesia, ireland, 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, slovenia, spain, srilanka, sweden, switzerland, taiwan, thailand, tunisia, turkey, uae, uk, venezuela, vietnam]
- `sort` (enum, optional, default "aum") — Sort. [one of: aum, volume, change, expense_ratio, return_1y, flows_1m, flows_1y, dividend_yield, name, launch_date]
- `order` (enum, optional) — Sort direction (default desc; asc for name). [one of: desc, asc]
- `asset_class` (array, optional) — Asset class as published (Equity, Fixed income, Commodities, Currency …).
- `issuer` (array, optional) — Issuer brand (iShares, Vanguard, SPDR …).
- `query` (string, optional) — Match in ticker or fund name.
- `aum_min` (number, optional) — Minimum assets under management.
- `expense_ratio_max` (number, optional) — Maximum expense ratio %.
- `page` (integer, optional, default 1) — Page number (1-based).
- `page_size` (integer, optional, default 50) — Rows per page.

**Returns:** results[]{symbol, ticker, name, price, change_percent, volume, aum, fund_flows_1m, fund_flows_1y, expense_ratio, nav_return_1y/3y/5y, dividend_yield, focus, asset_class, category, issuer, index_tracked, holdings_count, launch_date, link} + total + paging

**Example request body:**
```json
{
  "market": "america"
}
```

### POST https://api.reefapi.com/tradingview/v1/earnings_calendar — 1 credit
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.

**Parameters:**
- `market` (enum, optional, default "america") — Country market. [one of: america, argentina, australia, austria, bahrain, bangladesh, belgium, brazil, bulgaria, canada, chile, china, colombia, croatia, cyprus, czech, denmark, egypt, estonia, finland, france, germany, greece, hongkong, hungary, iceland, india, indonesia, ireland, 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, slovenia, spain, srilanka, sweden, switzerland, taiwan, thailand, tunisia, turkey, uae, uk, venezuela, vietnam]
- `from` (string, optional) — First day YYYY-MM-DD (default today).
- `to` (string, optional) — Last day YYYY-MM-DD (default from + 7 days; max 92 days).
- `status` (enum, optional, default "upcoming") — Upcoming or reported. [one of: upcoming, reported]
- `market_cap_min` (number, optional) — Minimum market cap.
- `page` (integer, optional, default 1) — Page number (1-based).
- `page_size` (integer, optional, default 50) — Rows per page.

**Returns:** results[]{symbol, ticker, name, market_cap, fiscal_period, reported{date, time_code, eps_actual, eps_estimate, eps_surprise(_percent), revenue_actual, revenue_estimate}, upcoming{date, time_code, eps_estimate, revenue_estimate}, sector, industry, link} + paging

**Example request body:**
```json
{
  "market": "america"
}
```

### POST https://api.reefapi.com/tradingview/v1/dividends_calendar — 1 credit
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.

**Parameters:**
- `market` (enum, optional, default "america") — Country market. [one of: america, argentina, australia, austria, bahrain, bangladesh, belgium, brazil, bulgaria, canada, chile, china, colombia, croatia, cyprus, czech, denmark, egypt, estonia, finland, france, germany, greece, hongkong, hungary, iceland, india, indonesia, ireland, 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, slovenia, spain, srilanka, sweden, switzerland, taiwan, thailand, tunisia, turkey, uae, uk, venezuela, vietnam]
- `from` (string, optional) — First day YYYY-MM-DD (default today).
- `to` (string, optional) — Last day YYYY-MM-DD (default from + 7 days; max 92 days).
- `date_type` (enum, optional, default "ex_date") — Which date the range applies to. [one of: ex_date, payment_date]
- `market_cap_min` (number, optional) — Minimum market cap.
- `page` (integer, optional, default 1) — Page number (1-based).
- `page_size` (integer, optional, default 50) — Rows per page.

**Returns:** results[]{symbol, ticker, name, price, market_cap, dividend_yield, frequency, upcoming{ex_date, payment_date, amount}, recent{ex_date, payment_date, amount}, link} + paging

**Example request body:**
```json
{
  "market": "america"
}
```

### POST https://api.reefapi.com/tradingview/v1/ipo_calendar — 1 credit
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.

**Parameters:**
- `market` (enum, optional, default "america") — Country market. [one of: america, argentina, australia, austria, bahrain, bangladesh, belgium, brazil, bulgaria, canada, chile, china, colombia, croatia, cyprus, czech, denmark, egypt, estonia, finland, france, germany, greece, hongkong, hungary, iceland, india, indonesia, ireland, 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, slovenia, spain, srilanka, sweden, switzerland, taiwan, thailand, tunisia, turkey, uae, uk, venezuela, vietnam]
- `from` (string, optional) — First day YYYY-MM-DD (default 30 days ago).
- `to` (string, optional) — Last day YYYY-MM-DD (default 30 days ahead; max 366-day range).
- `page` (integer, optional, default 1) — Page number (1-based).
- `page_size` (integer, optional, default 50) — Rows per page.

**Returns:** results[]{symbol, ticker, name, exchange, ipo_date, ipo_time, announced, offer_price, offer_price_usd, price_range{min, max}, shares_offered, deal_amount(_usd), market_cap_at_ipo, performance_since_offer_percent, price, sector, industry, link} + paging

**Example request body:**
```json
{
  "market": "america"
}
```

### POST https://api.reefapi.com/tradingview/v1/economic_calendar — 1 credit
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.

**Parameters:**
- `from` (string, optional) — First day YYYY-MM-DD (default today).
- `to` (string, optional) — Last day YYYY-MM-DD (default from + 7 days; max 31 days).
- `countries` (array, optional) — ISO country codes (US, EU, GB, DE, JP, CN, TR …); default US + EU.
- `importance` (enum, optional) — Minimum importance. [one of: low, medium, high]

**Returns:** results[]{id, title, indicator, ticker, country, currency, date, period, importance, actual, forecast, previous, unit, scale, category, source, source_link, description} + count

**Example request body:**
```json
{
  "from": "2026-11-16"
}
```

### POST https://api.reefapi.com/tradingview/v1/news — 1 credit
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.

**Parameters:**
- `symbol` (string, optional) — News about one symbol (EXCHANGE:TICKER or a link).
- `market` (array, optional) — Market feed(s). [one of: stock, etf, crypto, forex, index, futures, bond, corp_bond, economic]
- `country` (string, optional) — One ISO country code the news is about (US, TR, DE …); the service refuses several at once.
- `provider` (array, optional) — Provider ids (reuters, dow-jones, benzinga, tradingview, market-watch, zacks, cointelegraph …).
- `priority` (array, optional) — Format. [one of: flash, important, top_stories, key_facts]
- `sector` (array, optional) — Sector. [one of: Commercial Services, Communications, Consumer Durables, Consumer Non-Durables, Consumer Services, Distribution Services, Electronic Technology, Energy Minerals, Finance, Government, Health Services, Health Technology, Industrial Services, Miscellaneous, Non-Energy Minerals, Process Industries, Producer Manufacturing, Retail Trade, Technology Services, Transportation, Utilities]
- `corp_activity` (array, optional) — Corporate activity. [one of: ipo, earnings, earnings_calls, dividends, share_buybacks, strategy_business_products, mergers_and_acquisitions, management, insider_trading, ownership_changes, esg, recommendation, credit_ratings]
- `economic_category` (array, optional) — Economic category. [one of: gdp, labor, prices, health, money, trade, government, business, consumer, housing, taxes]
- `crypto_topic` (array, optional) — Crypto topic. [one of: market, etfs, pegs_reserves_and_liquidity, regulation, adoption, technology, security, fundraising, tokenomics, exchanges, people]
- `lang` (enum, optional, default "en") — Feed language. [one of: en, ar, de, en_IN, es, fr, he, id, it, ja, ko, ms, pl, pt, ru, th, tr, vi, zh-Hans, zh-Hant]
- `limit` (integer, optional, default 50) — Headlines to return (1-200).

**Returns:** results[]{id, title, link, published, provider{id, name, link}, urgency, is_flash, is_paywalled, permission, related_symbols[]} + count + available

**Example request body:**
```json
{
  "symbol": "NASDAQ:AAPL",
  "limit": 10
}
```

### POST https://api.reefapi.com/tradingview/v1/news_story — 1 credit
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.

**Parameters:**
- `story` (string, required) — Story id from `news` (tradingview:ab5c900008e42:0) or its link.
- `lang` (enum, optional, default "en") — Story language. [one of: en, ar, de, en_IN, es, fr, he, id, it, ja, ko, ms, pl, pt, ru, th, tr, vi, zh-Hans, zh-Hant]

**Returns:** id, title, link, published, provider, short_description, text, images[], tags[], related_symbols[], is_paywalled, is_preview_only, language

**Example request body:**
```json
{
  "story": "tradingview:ab5c900008e42:0"
}
```

### POST https://api.reefapi.com/tradingview/v1/ideas — 1 credit
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.

**Parameters:**
- `symbol` (string, optional) — Ideas about one symbol.
- `user` (string, optional) — Ideas published by one member (username or profile link).
- `topic` (string, optional) — A feed of tradingview.com/ideas/<topic>/: stocks, crypto, forex, futures, indices, bonds, economy, editors-picks, education, trend-analysis, fibonacci … (alone).
- `query` (string, optional) — Text search over ideas (alone).
- `type` (enum, optional) — Symbol / member feeds: trade ideas, education or all. [one of: all, trade, education]
- `sort` (enum, optional, default "recent") — Order. [one of: recent, popular, trending]
- `page` (integer, optional, default 1) — Page. Popular feeds stop at 1,000 ideas, recent feeds at 12,000; symbol / member feeds at 1,000.
- `page_size` (integer, optional, default 24) — Ideas per page: 1-50 on symbol / member feeds; topic and search feeds serve 24.

**Returns:** results[]{id, title, description_preview, link, image, published, symbol{…}, interval, direction, likes, comments, is_video, is_education, is_editors_pick, author{username, link, badges, plan}} + total + paging

**Example request body:**
```json
{
  "symbol": "NASDAQ:AAPL"
}
```

### POST https://api.reefapi.com/tradingview/v1/idea — 1 credit
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.

**Parameters:**
- `idea` (string, required) — Idea id (8 characters, from `ideas`) or its tradingview.com/chart/ link.

**Returns:** id, title, text, link, image, published, updated, symbol{…}, interval, direction, likes, views, comments, tags[], updates[], related_ideas[], author{…}, comments_preview[]

**Example request body:**
```json
{
  "idea": "fB4qwMZ2"
}
```

### POST https://api.reefapi.com/tradingview/v1/idea_comments — 1 credit
Comments on an idea (top-level, page by page), or the replies under one comment.

**Parameters:**
- `idea` (string, required) — Idea id or link.
- `comment` (string, optional) — A comment id: return its replies instead.
- `page` (integer, optional, default 1) — Page.

**Returns:** results[]{id, parent_id, text, published, likes, replies_count, author{…}} + has_next

**Example request body:**
```json
{
  "idea": "fB4qwMZ2"
}
```

### POST https://api.reefapi.com/tradingview/v1/scripts — 1 credit
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.

**Parameters:**
- `query` (string, optional) — Text search (alone or with type).
- `tag` (string, optional) — A tag feed slug (rsi, volume, supertrend, macd …).
- `user` (string, optional) — One member's scripts.
- `type` (enum, optional) — Script type. [one of: indicator, strategy, library]
- `sort` (enum, optional, default "popular") — Order. [one of: popular, recent, trending]
- `page` (integer, optional, default 1) — Page of 24 (popular feeds stop at 1,000 scripts, recent at 12,000).

**Returns:** results[]{id, title, description_preview, link, image, published, updated, likes, comments, script{type, access, pine_id, version}, author{…}} + total + paging

**Example request body:**
```json
{
  "query": "squeeze momentum"
}
```

### POST https://api.reefapi.com/tradingview/v1/script — 3 credits
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.

**Parameters:**
- `script` (string, required) — Script id (8 characters) or its tradingview.com/script/ link.

**Returns:** id, title, text, link, image, published, updated, likes, views, comments, script{type, access, pine_id, version}, author{…}, tags[], source{name, version, kind, source} | null, is_source_available

**Example request body:**
```json
{
  "script": "Fa4lStNd"
}
```

### POST https://api.reefapi.com/tradingview/v1/minds — 1 credit
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.

**Parameters:**
- `symbol` (string, optional) — The Minds feed of one symbol.
- `user` (string, optional) — One member's Minds posts.
- `cursor` (string, optional) — next_cursor of the previous page.

**Returns:** results[]{id, link, text, published, likes, comments, symbols[], chart_snapshot, author{…}} + next_cursor

**Example request body:**
```json
{
  "symbol": "NASDAQ:AAPL"
}
```

### POST https://api.reefapi.com/tradingview/v1/mind — 1 credit
One Minds post with its comments.

**Parameters:**
- `mind` (string, required) — Minds post id or its …/minds/?mind=<id> link.

**Returns:** id, link, text, published, likes, comments, symbols[], chart_snapshot, author{…}, comment_list[]{id, text, published, likes, author}

**Example request body:**
```json
{
  "mind": "u23H1QOXQbeeXdlezpb-dg"
}
```

### POST https://api.reefapi.com/tradingview/v1/user — 1 credit
A TradingView member profile: followers, following, ideas and scripts published, join date, last seen, badges / plan, bio and social links.

**Parameters:**
- `user` (string, required) — Username or tradingview.com/u/<username>/ link.

**Returns:** id, username, link, picture, bio, badges[], joined, last_seen, is_online, followers, following, ideas, scripts, socials{website, twitter, instagram, facebook, youtube}

**Example request body:**
```json
{
  "user": "TradingView"
}
```

## At scale
- **Volume:** 5M+ requests a day, measured at 60 requests a second across the fleet with no
  central bottleneck. Per-key limits are raised for high-volume accounts; volume pricing on request.
- **Missing a source:** tell us a site we do not cover and it becomes an engine. A customer asked
  for bestprice.gr on 21 Sep 2026 and it was in the catalog on 22 Sep.
- **Support:** 2 minute median time from a question in the live chat to the first answer. Setup
  help included, no support tier to buy.
- **One key, one credit pool** across every API. No per-site plans, no separate subscriptions.

## More
- Try it live, no code: https://reefapi.com/playground?engine=tradingview
- Human docs page: https://reefapi.com/docs/tradingview
- Overview page: https://reefapi.com/tradingview-api
- Every ReefAPI API in one file (for your AI): https://reefapi.com/llms-full.txt
