# India Market Screener — NSE & US Stocks Ranked by AI Score (`amicable_grid/india-market-screener`) Actor
Screen India NSE and US stocks by 5-factor quantitative AI score. Returns ranked watchlist filtered by minimum score, factor type, and market. Built on NeuralQuant's institutional-grade signal engine. No AI API costs — pure quantitative screening.
- **URL**: https://apify.com/amicable\_grid/india-market-screener.md
- **Developed by:** [Satyam Das](https://apify.com/amicable_grid) (community)
- **Categories:** Developer tools
- **Stats:** 2 total users, 0 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet
## Pricing
$1,000.00 / 1,000 run starteds
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 web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows.
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.
- **AI agents and MCP clients** — the [Apify MCP server](https://docs.apify.com/integrations/mcp.md) at `https://mcp.apify.com` (remote, streamable HTTP, OAuth on first use).
- **Agentic workflows and local Actor development** — [Agent Skills](https://apify.com/.well-known/agent-skills/index.json) with the [Apify CLI](https://docs.apify.com/cli/docs.md): `npm install -g apify-cli`, then `apify login`.
- **JavaScript/TypeScript projects** — the official [JS/TS client](https://docs.apify.com/api/client/js/docs.md): `npm install apify-client`.
- **Python projects** — the official [Python client](https://docs.apify.com/api/client/python/docs.md): `pip install apify-client`.
- **Any other language** — 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
India Market Screener
NSE India & US stocks ranked by AI score — find the best, skip the rest.
NSE screener · Indian stock AI score · Quantitative screening India · NSE stock ranking · AI stock picker India · NSE watchlist generator · Multi-factor stock screener
***
### What It Does
Screen the **entire NSE India** and **US (NYSE/NASDAQ)** stock universes using a **5-factor quantitative AI scoring engine**. Get a ranked watchlist of stocks that pass your minimum score threshold — without writing a single line of analysis code.
**The only Apify actor that screens NSE India stocks with institutional-grade quantitative signals.**
***
### How the Score Works
Each stock gets a composite **AI Score from 1 to 10**, built from 5 quantitative factors:
| Factor | What It Measures |
|--------|-----------------|
| **Quality** | Earnings quality, accruals, Piotroski F-Score |
| **Momentum** | Price momentum (6-month return trend) |
| **Value** | PE, PB ratio valuation relative to peers |
| **Low Volatility** | Realized volatility (1-year) — lower is better |
| **Short Interest** | Short selling pressure — lower is better |
The composite score is weighted and mapped to a 1–10 scale with a clear recommendation:
| Score | Recommendation |
|-------|---------------|
| 9–10 | **Strong Buy** |
| 7–8 | **Buy** |
| 5–6 | **Hold** |
| 3–4 | **Sell** |
| 1–2 | **Avoid** |
***
### Use Cases
- **Weekly screening** — find top-scored NSE stocks every week
- **Portfolio filtering** — eliminate low-quality stocks before deep analysis
- **Market comparison** — compare India vs US stocks side-by-side
- **Watchlist generation** — output feeds directly into trading bots or spreadsheets
- **AI agent integration** — call from MCP-compatible AI assistants for real-time stock screening
- **Quantitative research** — factor breakdowns for systematic strategy backtesting
- **Indian stock market analysis** — screen NSE equities by quality, momentum, value factors
- **Automated stock picking** — let the AI score engine filter the universe for you
***
### Scheduled Runs
Set up **recurring screenings** to catch score changes automatically:
1. Go to the actor page → **Schedules** tab
2. Set frequency (e.g., **weekly on Monday 9 AM IST**)
3. Configure input (market, min\_score, top\_n)
4. Results arrive in your dataset every cycle — no manual runs needed
**Recommended schedule:** Weekly, India market, min\_score 7, top\_n 15 — catches high-quality shifts.
***
### Input
```json
{
"market": "India",
"min_score": 6,
"sort_by": "score",
"top_n": 20
}
```
| Parameter | Type | Default | Description |
|-----------|------|---------|-------------|
| `market` | string | `"India"` | Which universe to screen: `India`, `US`, or `both` |
| `min_score` | number | `6` | Minimum AI score (1–10) to include in results |
| `sort_by` | string | `"score"` | Sort by: `score`, `momentum`, `quality`, or `value` |
| `top_n` | integer | `20` | Maximum results to return (1–100) |
***
### Output
```json
{
"ticker": "RELIANCE.NS",
"company_name": "Reliance Industries Limited",
"market": "IN",
"ai_score": 8,
"recommendation": "Buy",
"score_components": {
"quality": 0.782,
"momentum": 0.654,
"value": 0.421,
"low_vol": 0.591,
"short_interest": 0.912
},
"current_price": 2945.30,
"data_source": "live",
"fetched_at": "2026-04-22T10:30:00Z"
}
```
| Field | Description |
|-------|-------------|
| `ticker` | Stock ticker (`.NS` suffix for NSE) |
| `company_name` | Full company name |
| `market` | `IN` (India) or `US` |
| `ai_score` | Composite NeuralQuant score 1–10 |
| `recommendation` | Actionable label: Strong Buy / Buy / Hold / Sell / Avoid |
| `score_components` | 5 factor percentile breakdowns (0–1 scale) |
| `current_price` | Latest traded price |
| `data_source` | `live` (real data) or `synthetic_fallback` |
***
### Examples
#### Top 15 NSE India stocks scoring 7+
```json
{
"market": "India",
"min_score": 7,
"sort_by": "score",
"top_n": 15
}
```
#### Best-value US stocks
```json
{
"market": "US",
"min_score": 6,
"sort_by": "value",
"top_n": 30
}
```
#### Top stocks across both markets
```json
{
"market": "both",
"min_score": 8,
"sort_by": "quality",
"top_n": 10
}
```
***
### India NSE Ticker Format
Use `.NS` suffix for NSE stocks. The screener's built-in universe covers **all major NSE-listed equities**.
| Exchange | Suffix | Example |
|----------|--------|---------|
| NSE India | `.NS` | `RELIANCE.NS`, `TCS.NS`, `INFY.NS` |
| BSE India | `.BO` | `RELIANCE.BO` |
| US (NYSE/NASDAQ) | none | `NVDA`, `AAPL`, `MSFT` |
***
### MCP Integration
Use this actor directly from AI assistants (Claude, Cursor, VS Code) via the Apify MCP server:
**Claude Desktop / Cursor / VS Code:**
```json
{
"mcpServers": {
"apify-screener": {
"url": "https://mcp.apify.com?tools=amicable_grid/india-market-screener",
"headers": { "Authorization": "Bearer " }
}
}
}
```
**Command-line (stdio):**
```json
{
"mcpServers": {
"apify-screener": {
"command": "npx",
"args": ["-y", "@apify/actors-mcp-server", "--tools", "amicable_grid/india-market-screener"],
"env": { "APIFY_TOKEN": "YOUR_APIFY_TOKEN" }
}
}
}
```
Once configured, ask your AI assistant: *"Screen top 10 India NSE stocks by AI score"* — it calls the screener directly.
***
### Related Actors
- **[NeuralQuant Stock Analyzer](https://apify.com/amicable_grid/neuralquant-stock-analyzer)** — Deep-dive AI analysis for individual US & India stocks. 7-agent debate verdict, full factor breakdown, buy/sell signals. Use the Screener to find candidates, then the Analyzer to go deep.
***
### Pricing
Pay-per-event. Charged per screening run, regardless of how many stocks pass the filter.
***
### Built By
**Satyam Das** — [amicable\_grid on Apify](https://apify.com/amicable_grid)
# Actor input Schema
## `market` (type: `string`):
Which stock universe to screen: India (NSE), US (NYSE/NASDAQ), or both.
## `min_score` (type: `number`):
Minimum score (1–10) to include in results.
## `sort_by` (type: `string`):
Factor to sort results by.
## `top_n` (type: `integer`):
Maximum number of results to return.
## Actor input object example
```json
{
"market": "India",
"min_score": 6,
"sort_by": "score",
"top_n": 20
}
```
# 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 '' with your token
const client = new ApifyClient({
token: '',
});
// Prepare Actor input
const input = {};
// Run the Actor and wait for it to finish
const run = await client.actor("amicable_grid/india-market-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 '' with your token.
client = ApifyClient("")
# Prepare the Actor input
run_input = {}
# Run the Actor and wait for it to finish
run = client.actor("amicable_grid/india-market-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 '{}' |
apify call amicable_grid/india-market-screener --silent --output-dataset
```
## MCP server setup
```json
{
"mcpServers": {
"apify": {
"command": "npx",
"args": [
"mcp-remote",
"https://mcp.apify.com/?tools=amicable_grid/india-market-screener",
"--header",
"Authorization: Bearer "
]
}
}
}
```
## OpenAPI specification
Download the OpenAPI definition: https://api.apify.com/v2/actors/XrWTudwgrM4IzfbaP/builds/AOa5eh2dlXvIc4dAn/openapi.json