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
Related
- Asset hub: Cross-asset data
- Docs: API reference: fundamentals, API reference: stock snapshot
- Learn: Pandas market data tutorial