# TradingView Screener (`sheshinmcfly/tradingview-screener`) Actor

Scan stocks, crypto, and forex across dozens of global markets using TradingView screener data. Get 70+ fields per symbol: price, fundamentals, technical indicators, and performance. Filter by market cap, P/E, sector, RSI and more.

- **URL**: https://apify.com/sheshinmcfly/tradingview-screener.md
- **Developed by:** [Sheshinmcfly](https://apify.com/sheshinmcfly) (community)
- **Categories:** News, Lead generation
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $10.00 / 1,000 results

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.

Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event

## What's an Apify Actor?

Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.
Actors are written with capital "A".

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.
The best way to integrate Actors is as follows.

In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md):

```bash
npm install apify-client
```

In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md):

```bash
pip install apify-client
```

In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md):

````bash
# MacOS / Linux
curl -fsSL https://apify.com/install-cli.sh | bash
# Windows
irm https://apify.com/install-cli.ps1 | iex
```bash

In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md).

If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md).

For usage examples, see the [API](#api) section below.

For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt).


# README

## TradingView Screener

Scan stocks, crypto, and forex across **dozens of global markets** using TradingView's live screener data — the same data that powers TradingView's own screener tool. Get **70+ fields per symbol**: price, fundamentals (P/E, market cap, revenue, margins, ROE), technical indicators (RSI, MACD, moving averages, Bollinger Bands), and performance across multiple timeframes.

Filter by market cap, P/E ratio, sector, dividend yield, RSI and more — combine any filters to build precise screens. Covers US markets plus dozens of international exchanges (UK, Germany, Japan, India, Brazil, Canada, Australia and more), plus crypto and forex. No login, no account, no API key.

### Data you get

| Category | Fields |
|---|---|
| Identity | symbol, name, description, type, market, exchange, country, sector, industry |
| Price | close, open, high, low, change, change %, volume, average volume, VWAP |
| Fundamentals | market cap, P/E ratio, EPS, EPS growth, dividend yield, shares outstanding, revenue, gross profit, net income, total debt, total assets, free cash flow, ROE, ROA, current ratio |
| Performance | 1-month, 3-month, 6-month, 1-year, YTD % change, 52-week high/low, all-time high/low |
| Technicals | RSI (14 & 7), MACD, ADX, ATR, moving averages (SMA/EMA 20/50/200), Bollinger Bands, Stochastic, CCI, Momentum, Awesome Oscillator |

Crypto and forex symbols return a tailored field set (price, volume, market cap, performance, technicals) suited to those asset classes.

### How to use

1. Choose one or more **markets** — `america` for US stocks, a country code for international exchanges, or `crypto` / `forex`.
2. Optionally set filters: minimum market cap, P/E range, price range, sector, exchange, RSI range, minimum dividend yield.
3. Set **sort by** and **sort order** to rank results (e.g. by market cap, volume, or performance).
4. Set **max results per market** and run.

### Use cases

- **Stock screening:** find undervalued large caps, high-dividend payers, or oversold/overbought stocks by RSI.
- **Sector analysis:** compare fundamentals across companies in the same sector or exchange.
- **Global market research:** screen the same criteria across multiple countries in one run.
- **Crypto & forex monitoring:** track price, volume and technicals for digital assets and currency pairs.
- **Quant/algo research:** pull structured fundamental + technical data for backtesting and model inputs.

### Input

| Field | Type | Description |
|---|---|---|
| markets | array | Markets to scan: `america`, country codes, `crypto`, `forex` |
| maxResults | integer | Max symbols per market (default 100) |
| sortBy | string | Column to sort by (default `market_cap_basic`) |
| sortOrder | select | `desc` or `asc` |
| minMarketCap / maxMarketCap | integer | Market cap range (USD) |
| minPrice / maxPrice | number | Price range |
| minPE / maxPE | number | P/E ratio range |
| minVolume | integer | Minimum volume |
| minDividendYield | number | Minimum dividend yield (%) |
| sector | string | Exact sector name |
| country | string | Exact country name |
| exchange | string | Exact exchange code |
| minRSI / maxRSI | number | RSI range |
| customColumns | array | Override the default field set with your own column list |

### Output example

```json
{
  "symbol": "NASDAQ:NVDA",
  "name": "NVDA",
  "description": "NVIDIA Corporation",
  "market": "america",
  "exchange": "NASDAQ",
  "sector": "Electronic Technology",
  "close": 203.99,
  "change": -3.31,
  "market_cap_basic": 4936134657094,
  "price_earnings_ttm": 31.24,
  "dividends_yield_current": 0.13,
  "RSI": 50.26
}
````

### Performance & cost

Runs on lightweight requests (no browser), so it is fast and cheap: hundreds of symbols with 70+ fields each in seconds, across as many markets as you request.

### Pricing

This actor uses **pay-per-result** pricing — you are charged per record returned. See the pricing shown on the actor page.

### Keywords

tradingview scraper, stock screener, stock scanner, crypto screener, forex screener, market cap screener, dividend yield screener, technical indicators, RSI screener, fundamental data, global stock markets, finviz alternative

### Related actors

- [Finviz Stock Screener](https://apify.com/sheshinmcfly/finviz-stock-screener)
- [Yahoo Finance Scraper](https://apify.com/sheshinmcfly/yahoo-finance-scraper)
- [Dividend & ETF Scraper](https://apify.com/sheshinmcfly/dividend-etf-scraper)
- [Financial Calendar Scraper](https://apify.com/sheshinmcfly/financial-calendar-scraper)

### Disclaimer

This actor collects only publicly available market data. It does not constitute financial or investment advice. Use the data in compliance with the applicable terms and regulations in your jurisdiction.

### Changelog

| Version | Date | Changes |
|---|---|---|
| 1.0 | 2026-07-13 | Initial release — multi-market stock/crypto/forex screener with 70+ fields and combinable filters |

# Actor input Schema

## `markets` (type: `array`):

Which markets/exchanges to scan. Stocks: america, uk, germany, japan, india, brazil, chile, canada, australia, and dozens more country codes. Also supports crypto, forex, coin (altcoins).

## `maxResults` (type: `integer`):

Maximum number of symbols to return per market.

## `sortBy` (type: `string`):

TradingView column name to sort by (e.g. market\_cap\_basic, volume, change, price\_earnings\_ttm, RSI).

## `sortOrder` (type: `string`):

Sort direction for the sortBy column.

## `minMarketCap` (type: `integer`):

Only include symbols with market cap at least this value.

## `maxMarketCap` (type: `integer`):

Only include symbols with market cap at most this value.

## `minPrice` (type: `number`):

Only include symbols priced at or above this value.

## `maxPrice` (type: `number`):

Only include symbols priced at or below this value.

## `minPE` (type: `number`):

Only include symbols with a price-to-earnings ratio at or above this value.

## `maxPE` (type: `number`):

Only include symbols with a price-to-earnings ratio at or below this value.

## `minVolume` (type: `integer`):

Only include symbols with trading volume at or above this value.

## `minDividendYield` (type: `number`):

Only include symbols with a dividend yield at or above this percentage.

## `sector` (type: `string`):

Exact TradingView sector name, e.g. 'Technology Services', 'Finance', 'Health Technology'.

## `country` (type: `string`):

Exact country name to filter by, e.g. 'United States', 'Germany'.

## `exchange` (type: `string`):

Exact exchange code, e.g. NASDAQ, NYSE, LSE.

## `minRSI` (type: `number`):

Only include symbols with RSI (14) at or above this value.

## `maxRSI` (type: `number`):

Only include symbols with RSI (14) at or below this value.

## `customColumns` (type: `array`):

Override the default rich column set with your own list of TradingView scanner column names. Leave empty to use the full default set (70+ fields for stocks).

## Actor input object example

```json
{
  "markets": [
    "america"
  ],
  "maxResults": 100,
  "sortBy": "market_cap_basic",
  "sortOrder": "desc"
}
```

# Actor output Schema

## `dataset` (type: `string`):

All scanned symbol records.

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "markets": [
        "america"
    ]
};

// Run the Actor and wait for it to finish
const run = await client.actor("sheshinmcfly/tradingview-screener").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = { "markets": ["america"] }

# Run the Actor and wait for it to finish
run = client.actor("sheshinmcfly/tradingview-screener").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"])
for item in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "markets": [
    "america"
  ]
}' |
apify call sheshinmcfly/tradingview-screener --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.apify.com/?tools=sheshinmcfly/tradingview-screener",
                "--header",
                "Authorization: Bearer <YOUR_API_TOKEN>"
            ]
        }
    }
}

```

## OpenAPI specification

```json
{
    "openapi": "3.0.1",
    "info": {
        "title": "TradingView Screener",
        "description": "Scan stocks, crypto, and forex across dozens of global markets using TradingView screener data. Get 70+ fields per symbol: price, fundamentals, technical indicators, and performance. Filter by market cap, P/E, sector, RSI and more.",
        "version": "1.0",
        "x-build-id": "4d7dhqAyz91cpZ7lQ"
    },
    "servers": [
        {
            "url": "https://api.apify.com/v2"
        }
    ],
    "paths": {
        "/acts/sheshinmcfly~tradingview-screener/run-sync-get-dataset-items": {
            "post": {
                "operationId": "run-sync-get-dataset-items-sheshinmcfly-tradingview-screener",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK"
                    }
                }
            }
        },
        "/acts/sheshinmcfly~tradingview-screener/runs": {
            "post": {
                "operationId": "runs-sync-sheshinmcfly-tradingview-screener",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor and returns information about the initiated run in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/runsResponseSchema"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/acts/sheshinmcfly~tradingview-screener/run-sync": {
            "post": {
                "operationId": "run-sync-sheshinmcfly-tradingview-screener",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK"
                    }
                }
            }
        }
    },
    "components": {
        "schemas": {
            "inputSchema": {
                "type": "object",
                "properties": {
                    "markets": {
                        "title": "Markets",
                        "type": "array",
                        "description": "Which markets/exchanges to scan. Stocks: america, uk, germany, japan, india, brazil, chile, canada, australia, and dozens more country codes. Also supports crypto, forex, coin (altcoins).",
                        "items": {
                            "type": "string"
                        }
                    },
                    "maxResults": {
                        "title": "Max results per market",
                        "minimum": 1,
                        "type": "integer",
                        "description": "Maximum number of symbols to return per market.",
                        "default": 100
                    },
                    "sortBy": {
                        "title": "Sort by column",
                        "type": "string",
                        "description": "TradingView column name to sort by (e.g. market_cap_basic, volume, change, price_earnings_ttm, RSI).",
                        "default": "market_cap_basic"
                    },
                    "sortOrder": {
                        "title": "Sort order",
                        "enum": [
                            "desc",
                            "asc"
                        ],
                        "type": "string",
                        "description": "Sort direction for the sortBy column.",
                        "default": "desc"
                    },
                    "minMarketCap": {
                        "title": "Min market cap (USD)",
                        "type": "integer",
                        "description": "Only include symbols with market cap at least this value."
                    },
                    "maxMarketCap": {
                        "title": "Max market cap (USD)",
                        "type": "integer",
                        "description": "Only include symbols with market cap at most this value."
                    },
                    "minPrice": {
                        "title": "Min price",
                        "type": "number",
                        "description": "Only include symbols priced at or above this value."
                    },
                    "maxPrice": {
                        "title": "Max price",
                        "type": "number",
                        "description": "Only include symbols priced at or below this value."
                    },
                    "minPE": {
                        "title": "Min P/E ratio",
                        "type": "number",
                        "description": "Only include symbols with a price-to-earnings ratio at or above this value."
                    },
                    "maxPE": {
                        "title": "Max P/E ratio",
                        "type": "number",
                        "description": "Only include symbols with a price-to-earnings ratio at or below this value."
                    },
                    "minVolume": {
                        "title": "Min volume",
                        "type": "integer",
                        "description": "Only include symbols with trading volume at or above this value."
                    },
                    "minDividendYield": {
                        "title": "Min dividend yield (%)",
                        "type": "number",
                        "description": "Only include symbols with a dividend yield at or above this percentage."
                    },
                    "sector": {
                        "title": "Sector",
                        "type": "string",
                        "description": "Exact TradingView sector name, e.g. 'Technology Services', 'Finance', 'Health Technology'."
                    },
                    "country": {
                        "title": "Country",
                        "type": "string",
                        "description": "Exact country name to filter by, e.g. 'United States', 'Germany'."
                    },
                    "exchange": {
                        "title": "Exchange",
                        "type": "string",
                        "description": "Exact exchange code, e.g. NASDAQ, NYSE, LSE."
                    },
                    "minRSI": {
                        "title": "Min RSI",
                        "type": "number",
                        "description": "Only include symbols with RSI (14) at or above this value."
                    },
                    "maxRSI": {
                        "title": "Max RSI",
                        "type": "number",
                        "description": "Only include symbols with RSI (14) at or below this value."
                    },
                    "customColumns": {
                        "title": "Custom columns (advanced)",
                        "type": "array",
                        "description": "Override the default rich column set with your own list of TradingView scanner column names. Leave empty to use the full default set (70+ fields for stocks).",
                        "items": {
                            "type": "string"
                        }
                    }
                }
            },
            "runsResponseSchema": {
                "type": "object",
                "properties": {
                    "data": {
                        "type": "object",
                        "properties": {
                            "id": {
                                "type": "string"
                            },
                            "actId": {
                                "type": "string"
                            },
                            "userId": {
                                "type": "string"
                            },
                            "startedAt": {
                                "type": "string",
                                "format": "date-time",
                                "example": "2025-01-08T00:00:00.000Z"
                            },
                            "finishedAt": {
                                "type": "string",
                                "format": "date-time",
                                "example": "2025-01-08T00:00:00.000Z"
                            },
                            "status": {
                                "type": "string",
                                "example": "READY"
                            },
                            "meta": {
                                "type": "object",
                                "properties": {
                                    "origin": {
                                        "type": "string",
                                        "example": "API"
                                    },
                                    "userAgent": {
                                        "type": "string"
                                    }
                                }
                            },
                            "stats": {
                                "type": "object",
                                "properties": {
                                    "inputBodyLen": {
                                        "type": "integer",
                                        "example": 2000
                                    },
                                    "rebootCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "restartCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "resurrectCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "computeUnits": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            },
                            "options": {
                                "type": "object",
                                "properties": {
                                    "build": {
                                        "type": "string",
                                        "example": "latest"
                                    },
                                    "timeoutSecs": {
                                        "type": "integer",
                                        "example": 300
                                    },
                                    "memoryMbytes": {
                                        "type": "integer",
                                        "example": 1024
                                    },
                                    "diskMbytes": {
                                        "type": "integer",
                                        "example": 2048
                                    }
                                }
                            },
                            "buildId": {
                                "type": "string"
                            },
                            "defaultKeyValueStoreId": {
                                "type": "string"
                            },
                            "defaultDatasetId": {
                                "type": "string"
                            },
                            "defaultRequestQueueId": {
                                "type": "string"
                            },
                            "buildNumber": {
                                "type": "string",
                                "example": "1.0.0"
                            },
                            "containerUrl": {
                                "type": "string"
                            },
                            "usage": {
                                "type": "object",
                                "properties": {
                                    "ACTOR_COMPUTE_UNITS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_WRITES": {
                                        "type": "integer",
                                        "example": 1
                                    },
                                    "KEY_VALUE_STORE_LISTS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_INTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_EXTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_SERPS": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            },
                            "usageTotalUsd": {
                                "type": "number",
                                "example": 0.00005
                            },
                            "usageUsd": {
                                "type": "object",
                                "properties": {
                                    "ACTOR_COMPUTE_UNITS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_WRITES": {
                                        "type": "number",
                                        "example": 0.00005
                                    },
                                    "KEY_VALUE_STORE_LISTS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_INTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_EXTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_SERPS": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            }
                        }
                    }
                }
            }
        }
    }
}
```
