Early access is open. Free sample datasets are live now. Download a sample

Data product · Early access

Stock Screener API

Filter the whole US market by price, volume, market cap, sector and fundamentals in one request, and get back only the tickers that match.

Coverage

What you get

Item Detail
Product code X-SCREENER
Coverage US-listed stocks and ETFs; options metrics filters planned for Business
Granularity Latest data per symbol, around 30 filters
History None. A screen runs on the latest data; for past dates, use our bars and fundamentals
Delivery REST, with filters as query parameters or a JSON body
Update speed Latest available data on your plan

Running a screen yourself means pulling every symbol's price, volume and fundamentals, then filtering locally. That's thousands of calls before you've found anything. The screener does the filtering server-side and returns one row per match.

Schema

Schema

Field Type Required Description
symbol string yes Ticker
name string yes Company or instrument name
exchange string yes Listing venue
as_of string yes Data time, UTC
price number yes Last price
change_percent number yes Day change, percent
volume number yes Today's volume
average_volume_200d number optional 200-day average volume
market_cap number optional Market capitalisation, USD
sector / industry string optional Sector and industry classification
dividend_yield number optional Trailing dividend yield
earnings_per_share number optional Trailing EPS
atm_implied_volatility number optional At-the-money IV, for options screens

Example record:

{
  "symbol": "AMD",
  "name": "Advanced Micro Devices, Inc.",
  "exchange": "XNAS",
  "as_of": "2026-11-18T21:00:00Z",
  "price": 162.48,
  "change_percent": 4.21,
  "volume": 58210344,
  "average_volume_200d": 44871200,
  "market_cap": 263400000000,
  "sector": "Information Technology",
  "industry": "Semiconductors",
  "atm_implied_volatility": 0.4312
}

Sample data

Sample data

There's no free screener sample yet, since results depend on the licensed stock prices underneath. A sample file is available on request: send us the filters you'd run and we'll return a result set in this schema.

Use cases

Use cases

Volume breakout list. volume above 1.5 times average_volume_200d, change_percent above 3, price above $10. Run it near the close and you have tomorrow's watchlist.

Dividend shortlist. dividend_yield above 3%, market_cap above $10 billion, earnings_per_share positive. It filters out most of the yield traps where the dividend comes out of losses.

Sector scans. Fix sector to one value and sort by change_percent to see which names are leading a sector move on the day.

Options candidates. Once options filters arrive on Business, atm_implied_volatility combined with average_volume_200d gives you liquid names with rich premiums for selling strategies.

Code

Code examples

Example: large caps up more than 3% on heavy volume.

curl "https://api.marketdata.co/v1/screener?market_cap_min=10000000000&change_percent_min=3&volume_vs_avg_min=1.5" \
  -H "Authorization: Bearer $MARKETDATA_API_KEY"

Example: Python, the same screen with a JSON body.

import os
import requests
import pandas as pd

body = {
    "filters": [
        {"field": "market_cap", "op": "gte", "value": 10_000_000_000},
        {"field": "change_percent", "op": "gte", "value": 3},
        {"field": "price", "op": "gte", "value": 10},
    ],
    "sort": {"field": "change_percent", "order": "desc"},
    "limit": 50,
}
resp = requests.post(
    "https://api.marketdata.co/v1/screener",
    json=body,
    headers={"Authorization": f"Bearer {os.environ['MARKETDATA_API_KEY']}"},
)
resp.raise_for_status()
hits = pd.DataFrame(resp.json()["results"])
hits["vol_ratio"] = hits["volume"] / hits["average_volume_200d"]
print(hits[["symbol", "price", "change_percent", "vol_ratio", "sector"]])

Pricing

Pricing

Plan Screener
Pro, $79/mo Stock and ETF screening on latest data, around 30 filters
Business, $249/mo Adds options metrics filters once our Greeks and IV data is live

Gainers, losers and most-active lists stay on lower plans through our real-time quotes and movers API. The screener isn't sold as a dataset. Prices are early access and may change.

Among the vendors we studied, plans with a screener API run from $29.99 to $2,499 a month.

Side by side

How we compare

10 of the 50 providers we studied offer a screener API. Some are cheap but stock-only; the ones with options filters cost much more. Ours sits in Pro at a listed price, uses the same field names as our quotes and fundamentals, and returns plain rows you can drop into a DataFrame.

FAQ

Frequently asked questions

How fresh is the data behind a screen?

Each result has an as_of timestamp in UTC. It reflects the latest price data your plan has access to.

Can I screen on past dates?

No. The screener works on the latest data only. To screen history, combine our daily bars and fundamentals and filter locally.

How many filters can I combine?

As many as you like from the roughly 30 available fields, joined with AND. Results can be sorted by any numeric field.

Are ETFs included?

Yes. ETFs have empty values for company-only fields like earnings_per_share, so filters on those fields leave ETFs out.

Is there a limit on results?

Each call returns a page of results, and you can page through larger sets. Rate limits follow your plan.

Keep reading