# TradingView Technical Ratings API
> Live technical-analysis ratings and market screeners from TradingView, with no key. TradingView's famous "Strong Buy / Buy / Neutral / Sell / Strong Sell" gauge aggregates around 26 indicators into one consensus rating; this reads TradingView's own public scanner and returns it cleanly across crypto, US stocks and forex. Get the full technical rating for any symbol — the overall consensus plus the separate moving-average and oscillator sub-ratings, with the live RSI, MACD, ADX and Stochastic values; screen a market for the top movers ranked by change, volume, rating or price, each with its rating; and find symbols by name with their price and rating. The technical-signal / screening layer for trading dashboards, screeners, alpha tools and analytics. Distinct from single-indicator APIs — this is TradingView's aggregated consensus rating and multi-symbol screener. Live from TradingView; short cache only.

## Authentication
All requests require your oanor API key in the `x-oanor-key` header. Get one at https://www.oanor.com/developer/keys.

```bash
curl -H "x-oanor-key: oanor_live_…" "https://api.oanor.com/tradingview-api/..."
```

## Pricing
- **Free** (Free) — 6,500 calls/Mo, 3 req/s
- **Starter** ($12/Mo) — 128,000 calls/Mo, 10 req/s
- **Pro** ($36/Mo) — 690,000 calls/Mo, 25 req/s
- **Scale** ($94/Mo) — 4,400,000 calls/Mo, 60 req/s

## Endpoints

### Rating

#### `GET /v1/rating` — Technical-analysis consensus for a symbol

**Parameters:**
- `symbol` (query, optional, string) — Symbol (e.g. BTCUSDT, AAPL, EURUSD) Example: `BTCUSDT`
- `market` (query, optional, string) — crypto, stocks or forex Example: `crypto`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/tradingview-api/v1/rating?symbol=BTCUSDT&market=crypto"
```

**Response:**
```json
{
    "data": {
        "note": "The TradingView technical-analysis consensus for one symbol — the overall Strong Buy/Buy/Neutral/Sell/Strong Sell rating (aggregating ~26 indicators) plus the separate moving-average and oscillator sub-ratings, with the live RSI, MACD, ADX and Stochastic values. Pass symbol and market (crypto, stocks, forex). Omit symbol for the market's default.",
        "price": 63981.9,
        "market": "crypto",
        "rating": {
            "overall": "SELL",
            "oscillators": "NEUTRAL",
            "overall_value": -0.4,
            "moving_averages": "STRONG_SELL",
            "oscillators_value": 0,
            "moving_averages_value": -0.8
        },
        "source": "TradingView",
        "symbol": "BTCUSDT",
        "ticker": "BYBIT:BTCUSDT",
        "volume": 5308.137205,
        "change_pct": -0.7025728412995458,
        "indicators": {
            "adx": 44.98456851400589,
            "rsi": 35.49759016834179,
            "macd": -3341.525538059548,
            "stoch_k": 32.241261685112384,
            "macd_signal": -3516.8113661814964
        }
    },
    "meta": {
        "timestamp": "2026-06-14T17:03:41.277Z",
        "request_id": "d0e941b3-b011-422c-ab22-754315489134"
    },
    "status": "ok",
    "message": "Rating retrieved successfully",
    "success": true
}
```

### Screener

#### `GET /v1/screener` — Top symbols of a market ranked

**Parameters:**
- `market` (query, optional, string) — crypto, stocks or forex Example: `crypto`
- `sort` (query, optional, string) — change | volume | Recommend.All | close Example: `change`
- `dir` (query, optional, string) — asc or desc Example: `desc`
- `limit` (query, optional, string) — Rows (1-100) Example: `25`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/tradingview-api/v1/screener?market=crypto&sort=change&dir=desc&limit=25"
```

**Response:**
```json
{
    "data": {
        "note": "Screen a TradingView market (crypto, stocks, forex) for the top symbols ranked by change, volume, rating or price — each with its price, % change, TradingView rating and volume. Sort with sort=change|volume|Recommend.All|close and dir=asc|desc. US-stock screens are filtered to >$500M market cap.",
        "count": 25,
        "order": "desc",
        "total": 57573,
        "market": "crypto",
        "source": "TradingView",
        "results": [
            {
                "price": 81331621233541.3,
                "rating": null,
                "symbol": "ROBOWBNB_2D98B8.USD",
                "ticker": "PANCAKESWAP:ROBOWBNB_2D98B8.USD",
                "volume": 9.53198468,
                "change_pct": 174403417821862560,
                "rating_value": null
            },
            {
                "price": 120000000009,
                "rating": null,
                "symbol": "ROBOWBNB_2D98B8",
                "ticker": "PANCAKESWAP:ROBOWBNB_2D98B8",
                "volume": 0,
                "change_pct": 163742146775367870,
                "rating_value": null
            },
            {
                "price": 4.76787741e-10,
                "rating": null,
                "symbol": "DEUSWETH_8DE0D2.USD",
                "ticker": "UNISWAPBASE:DEUSWETH_8DE0D2.USD",
                "volume": 1.73769902,
                "change_pct": 826107.3559991682,
                "rating_value": null
            },
            {
       
…(truncated, see openapi.json for full schema)
```

### Search

#### `GET /v1/search` — Find symbols by name

**Parameters:**
- `q` (query, optional, string) — Name fragment Example: `BTC`
- `market` (query, optional, string) — crypto, stocks or forex Example: `crypto`
- `limit` (query, optional, string) — Max results (1-50) Example: `20`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/tradingview-api/v1/search?q=BTC&market=crypto&limit=20"
```

**Response:**
```json
{
    "data": {
        "note": "Find symbols in a market by name match — every matching symbol with its price, % change, TradingView rating and volume. Pass q (a name fragment) and market (crypto, stocks, forex). The lookup entry point into the rating and screener data.",
        "count": 20,
        "query": "BTC",
        "market": "crypto",
        "source": "TradingView",
        "results": [
            {
                "price": 0.06606,
                "rating": "BUY",
                "symbol": "PAXGBTC",
                "ticker": "BINANCE:PAXGBTC",
                "volume": 8.7053,
                "change_pct": 0.8395664784002366,
                "rating_value": 0.35757575757575755
            },
            {
                "price": 63949.32549769,
                "rating": "SELL",
                "symbol": "WBTCUSDC_BD0F3A.USD",
                "ticker": "UNISWAP4UNICHAIN:WBTCUSDC_BD0F3A.USD",
                "volume": 28353.23722572,
                "change_pct": -0.720283138217818,
                "rating_value": -0.3194444444444444
            },
            {
                "price": 3.246e-5,
                "rating": "BUY",
                "symbol": "NEARBTC",
                "ticker": "COINEX:NEARBTC",
                "volume": 621.88313005,
                "change_pct": -1.8000302526092984,
                "rating_value": 0.24545454545454548
            },
            {
                "price": 63852.11,
                "rating": "SELL",
                
…(truncated, see openapi.json for full schema)
```

### Meta

#### `GET /v1/meta` — Service metadata

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/tradingview-api/v1/meta"
```

**Response:**
```json
{
    "data": {
        "sample": {
            "btc_rating": "SELL"
        },
        "source": "TradingView public scanner (scanner.tradingview.com), keyless",
        "service": "tradingview-api",
        "endpoints": {
            "GET /v1/meta": "This document.",
            "GET /v1/rating": "One symbol's technical consensus + indicators (symbol, market).",
            "GET /v1/search": "Find symbols by name (q, market, limit).",
            "GET /v1/screener": "Top symbols of a market ranked (market, sort, dir, limit)."
        },
        "description": "Live TradingView technical-analysis ratings and market screeners with no key: the Strong Buy/Buy/Neutral/Sell/Strong Sell consensus rating (aggregating ~26 indicators) plus moving-average and oscillator sub-ratings and live RSI/MACD/ADX/Stochastic for any symbol; a market screener ranking the top movers by change/volume/rating; and symbol search. Across crypto, US stocks and forex. The technical-signal / screening layer for trading dashboards and alpha tools. Live, short cache only.",
        "upstream_status": "ok"
    },
    "meta": {
        "timestamp": "2026-06-14T17:03:42.365Z",
        "request_id": "109abdda-a7c8-4441-aa86-f9c31abe8ca2"
    },
    "status": "ok",
    "message": "Meta",
    "success": true
}
```


---
Marketplace page: https://www.oanor.com/api/tradingview-api
OpenAPI spec: https://www.oanor.com/api/tradingview-api/openapi.json
