# TradingView API: Screen stocks by country, sector and size

> Finds publicly listed stocks in a country, filtered by sector, US-dollar market cap band and minimum dividend yield, in the requested order. Quotes may be delayed.

Unofficial. Not affiliated with or endorsed by TradingView.

- Page: https://fous.com/methods/tradingview.com/screen-stocks
- Method: `tradingview.com/screen_stocks`, version 1
- Website: tradingview.com
- Returns: company, ticker, exchange, price, currency, daily change, market cap, P/E, dividend yield, sector, TradingView link
- Effect: read (it gets data and changes nothing)
- Sign-in: none needed
- Cost: 1 credit per completed run (1¢ with pay as you go); failed runs are free
- Verified: Nov 2, 2026

## Inputs

| Field | Type | Required | In the run below | Description |
|---|---|---|---|---|
| `sort` | string | no |  | Order stocks by market cap, daily gain, daily loss, or dividend yield, for example largest_first. One of "largest_first", "biggest_gainers", "biggest_losers", "highest_dividend". Default "largest_first". |
| `sector` | string | no |  | TradingView stock sector, for example Technology, Finance, or Health Technology. |
| `country` | string | no |  | Country of the stock exchange, for example United States or Canada. Default "United States". |
| `max_results` | integer | no |  | Maximum number of stocks to return, for example 20. Default 20. |
| `company_size` | string | no |  | Market cap band: small under 2 billion, mid 2-10 billion, large over 10 billion, or any. One of "small", "mid", "large", "any". Default "any". |
| `minimum_dividend_yield_percent` | number | no |  | Minimum dividend yield as a percent, for example 3.5. |

## Output

From a run on Oct 23, 2026, shortened. Its input:

```json
{}
```

Its output:

```json
{
  "stocks": [
    {
      "price": 212.21,
      "sector": "Electronic technology",
      "ticker": "NVDA",
      "company": "NVIDIA Corporation",
      "currency": "USD",
      "exchange": "NASDAQ",
      "pe_ratio": 26.826030895254473,
      "market_cap": 5114261000000,
      "tradingview_link": "https://www.tradingview.com/symbols/NASDAQ-NVDA/",
      "change_percent_today": -4.396990584313191,
      "dividend_yield_percent": 0.234265891787178
    },
    {
      "price": 348.22,
      "sector": "Electronic technology",
      "ticker": "AAPL",
      "company": "Apple Inc.",
      "currency": "USD",
      "exchange": "NASDAQ",
      "pe_ratio": 39.918379512340515,
      "market_cap": 5081985500000,
      "tradingview_link": "https://www.tradingview.com/symbols/NASDAQ-AAPL/",
      "change_percent_today": 1.2296869095031886,
      "dividend_yield_percent": 0.308148492688741
    },
    {
      "price": 320.76,
      "sector": "Technology services",
      "ticker": "GOOG",
      "company": "Alphabet Inc.",
      "currency": "USD",
      "exchange": "NASDAQ",
      "pe_ratio": 16.114301216258987,
      "market_cap": 3946087312500,
      "tradingview_link": "https://www.tradingview.com/symbols/NASDAQ-GOOG/",
      "change_percent_today": -3.0790149569421357,
      "dividend_yield_percent": 0.259857984589817
    }
  ]
}
```

## Run it

From code, with a Fous API key in `FOUS_API_KEY`; the answer's `data` holds the output:

```bash
curl https://api.fous.com/v1/runs \
  -H "Authorization: Bearer $FOUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"method":"tradingview.com/screen_stocks","input":{}}'
```

From an AI agent connected to the Fous MCP server: its `run` with the same method and input. To connect one, give it `set up https://fous.com/SKILL.md`.

## Ask your agent

- Show me the 15 largest US Health Technology stocks with market cap over 10 billion dollars
- Which Canadian Finance companies pay a dividend yield above 4 percent? List their tickers and P/E ratios.
- Find mid-cap Technology stocks in the United States, 2 to 10 billion market cap, sorted by biggest daily gainers
- I need a list of top 25 German Energy companies sorted by highest dividend yield, with prices in euros
- On tradingview.com, screen for small-cap Consumer Goods stocks in Japan that had the biggest daily losses today

## Input schema

```json
{
  "type": "object",
  "properties": {
    "sort": {
      "enum": [
        "largest_first",
        "biggest_gainers",
        "biggest_losers",
        "highest_dividend"
      ],
      "type": "string",
      "default": "largest_first",
      "description": "Order stocks by market cap, daily gain, daily loss, or dividend yield, for example largest_first."
    },
    "sector": {
      "type": "string",
      "description": "TradingView stock sector, for example Technology, Finance, or Health Technology."
    },
    "country": {
      "type": "string",
      "default": "United States",
      "description": "Country of the stock exchange, for example United States or Canada."
    },
    "max_results": {
      "type": "integer",
      "default": 20,
      "maximum": 100,
      "minimum": 1,
      "description": "Maximum number of stocks to return, for example 20."
    },
    "company_size": {
      "enum": [
        "small",
        "mid",
        "large",
        "any"
      ],
      "type": "string",
      "default": "any",
      "description": "Market cap band: small under 2 billion, mid 2-10 billion, large over 10 billion, or any."
    },
    "minimum_dividend_yield_percent": {
      "type": "number",
      "minimum": 0,
      "description": "Minimum dividend yield as a percent, for example 3.5."
    }
  }
}
```

## Output schema

```json
{
  "type": "object",
  "required": [
    "stocks"
  ],
  "properties": {
    "stocks": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "company",
          "ticker",
          "exchange",
          "price",
          "currency",
          "change_percent_today",
          "market_cap",
          "pe_ratio",
          "dividend_yield_percent",
          "sector",
          "tradingview_link"
        ],
        "properties": {
          "price": {
            "type": [
              "number",
              "null"
            ]
          },
          "sector": {
            "type": [
              "string",
              "null"
            ]
          },
          "ticker": {
            "type": "string"
          },
          "company": {
            "type": "string"
          },
          "currency": {
            "type": [
              "string",
              "null"
            ]
          },
          "exchange": {
            "type": "string"
          },
          "pe_ratio": {
            "type": [
              "number",
              "null"
            ]
          },
          "market_cap": {
            "type": [
              "number",
              "null"
            ]
          },
          "tradingview_link": {
            "type": "string"
          },
          "change_percent_today": {
            "type": [
              "number",
              "null"
            ]
          },
          "dividend_yield_percent": {
            "type": [
              "number",
              "null"
            ]
          }
        },
        "additionalProperties": false
      },
      "description": "Matching stocks in the selected order."
    }
  },
  "additionalProperties": false
}
```

## See more

- [TradingView API: Get technical rating](https://fous.com/methods/tradingview.com/get-technical-rating.md): Returns TradingView's buy, sell and neutral technical indicator summary for a stock, cryptocurrency or currency pair. Not investment advice.
- [Finviz API: Screen US stocks](https://fous.com/methods/finviz.com/screen-stocks.md): Screens US-listed stocks on Finviz by sector, company size, minimum dividend yield, maximum P/E ratio and market signal, ranked by market value, today's gain or dividend yield.
- [CompaniesMarketCap API: List largest companies](https://fous.com/methods/companiesmarketcap.com/list-largest-companies.md): Ranks public companies worldwide, or by country and industry, by market cap, revenue, earnings, employees or dividend yield. When both a country and an industry are set, the industry ranking order is kept and only companies from that country are shown.
- [Finviz API: Get stock snapshot](https://fous.com/methods/finviz.com/get-stock-snapshot.md): Get a delayed US-listed stock snapshot from its ticker or company name. Analyst labels summarize Finviz's 1-5 mean score; dividend yield uses the estimated dividend when available. Missing metrics return null.
- [Yahoo API: List market movers](https://fous.com/methods/finance.yahoo.com/list-market-movers.md): Lists Yahoo Finance's top gainers, top losers, most active stocks, or regional trending tickers in Yahoo's order, with price, change, volume and market cap.
- [MSN API: List market movers](https://fous.com/methods/msn.com/list-market-movers.md): Lists MSN Money's current leading stock gainers, losers, or most-active shares in a selected market, in MSN's order. Lists may contain fewer than 50 stocks and prices may be delayed.
- [CompaniesMarketCap API: Get company size](https://fous.com/methods/companiesmarketcap.com/get-company-size.md): Looks up a public company's size, financial figures and completed-year market-cap history from its name or ticker.
- [Stock Analysis API: Get key statistics](https://fous.com/methods/stockanalysis.com/get-key-statistics.md): Looks up a stock by company name or ticker on Stock Analysis and returns its valuation ratios and company statistics, with the date the figures were last updated.
- [All TradingView methods](https://fous.com/methods/tradingview.com.md)