# 🇨🇳 Beijing Stock Exchange Screener · 北京证券交易所 (`nexgendata/bse-beijing-stock-screener`) Actor

Beijing Stock Exchange (BSE / 北交所) stock screener API — BSE 50 live quotes, market cap (RMB), P/E, P/B, dividend yield, ROE, sector. China's SME / 'specialized & sophisticated' innovation board (launched 2021). Bloomberg / FactSet / Refinitiv Eikon alternative. Pay-per-result pricing.

- **URL**: https://apify.com/nexgendata/bse-beijing-stock-screener.md
- **Developed by:** [NexGenData](https://apify.com/nexgendata) (community)
- **Categories:** Business, Automation, Developer tools
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $250.00 / 1,000 bse stock records

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

## 🇨🇳🏛️ Beijing Stock Exchange Screener — BSE 50 Quotes (北交所)

> Track the **Beijing Stock Exchange (BSE / 北京证券交易所 / 北交所)** — China's youngest national bourse, launched November 15, 2021, dedicated to **small and medium enterprises (SMEs)** and **innovation-stage companies**, many graduated from the NEEQ "New Third Board" select tier. Screen prices, market cap in RMB, P/E, P/B, turnover, sector classification, and **BSE 50 index (北证50)** membership across ~270 listed companies. Tickers begin with **"8"** (e.g., `832000`, `836826`, `873169`) or **"4"** (e.g., `430047`). All quotes in Chinese yuan renminbi (CNY / ¥).

### 📊 Sample Output

[![🇨🇳 Beijing Stock Exchange Screener · 北京证券交易所 sample output — 🇨🇳 Beijing Stock Exchange Screener · 北京证券交易所, premium API, JSON output, NexGenData premium dataset for analysts, hedge funds, compliance, a](https://api.apify.com/v2/key-value-stores/8gLgXMBveEI1tTz1z/records/bse-beijing-stock-screener-output.png)](https://apify.com/nexgendata/bse-beijing-stock-screener)


### Why NexGenData BSE Beijing Stock Screener Beats Bloomberg Terminal, Wind Information, and East Money Pro

| Feature | NexGenData BSE Beijing Screener | Bloomberg Terminal | Wind Information (Wind 万得) | East Money Pro / Choice Data | Capital IQ China |
|---|---|---|---|---|---|
| Cost | $0.05/record pay-per-result | $$$$ ($24,000+/yr seat) | $$$$ ($5,000-$25,000/yr seat) | $$$ ($2,000-$8,000/yr seat) | $$$$ ($12,000-$30,000/yr seat) |
| Coverage | Every BSE Beijing (北交所) ticker — innovation-tier "specialised & sophisticated SMEs" (专精特新), RMB price/market-cap, P/E, P/B, sector, dual-listed flag, NEEQ-graduate flag | Global incl. BSE Beijing but $24K/yr | Comprehensive China A-share (incl. BSE) + HK + global | China-focused (incl. BSE), Mandarin UI | Global incl. BSE, S&P fundamentals |
| Update frequency | Daily close + intraday refresh | Real-time tick | Real-time tick | Real-time (Mandarin-only) | Daily |
| API access | Apify Actor — JSON/CSV/Excel/Parquet | Bloomberg API / BBG Anywhere | Wind API (Mandarin, enterprise) | Choice Data API (Mandarin, enterprise) | Capital IQ API (enterprise) |
| Auth required | Apify token (free tier available) | Bloomberg seat license | Wind enterprise contract | East Money paid account | Capital IQ enterprise contract |

### 🏛️ Why a Dedicated Beijing Stock Exchange Screener?

The Beijing Stock Exchange is **not** simply a third Shanghai/Shenzhen clone — it is structurally different. Created by Xi Jinping's November 2021 announcement and built on top of the NEEQ select tier, the BSE is explicitly engineered to serve **specialised, refined, distinctive and innovative ("专精特新") SMEs** that are too small for the Shanghai Main Board, ChiNext, or the STAR Market, but too important to leave on the over-the-counter NEEQ. Examples of the kind of name you'll find here: **Bettray (835185)** battery materials, **Jinbo Bio-Pharmaceutical (832149)** recombinant collagen, **Haitai Xinguang (873169)** medical endoscopy optics, **Yongxin Optics (835640)** precision lenses, and **Noah Technology (430047)** gene therapy.

This actor exists because:

1. **Different buyer pool.** Specialist SME funds, China-focused venture/growth managers, "专精特新" thematic-basket builders, and policy-watchers who track Beijing's industrial-policy priorities want an isolated BSE feed without the noise of the bigger Shanghai and Shenzhen exchanges drowning out the small-cap signal.
2. **BSE 50 index focus.** The **BSE 50 index (北证50)** launched November 2022 as the bourse's first headline benchmark — the equivalent of the CSI 300 or STAR 50 for the SME world. The screener flags membership directly so you can filter to just the institutional-tracked names.
3. **RMB-denominated metrics.** Market cap reported in both raw CNY and rounded RMB billions — the unit Chinese analysts actually use. Most BSE caps sit in the **¥1B–¥30B** range, materially smaller than STAR or ChiNext leaders.
4. **SME / innovation sector tags.** Each stock is auto-classified into Biotechnology, Medical Devices, Optics, Battery Materials, New Energy, Software / IT, Industrial Equipment, Specialty Materials, Agriculture / Food, Professional Services, or general Other SME — making it trivial to slice the data for thematic baskets aligned with China's "专精特新" policy.

### 📡 Data Source

Primary feed: **Eastmoney's `push2.eastmoney.com/api/qt/clist/get` JSON quote endpoint** with market filter `fs=m:0+t:81`, which selects only Beijing Stock Exchange (北交所) tickers. The same underlying feed powers Eastmoney's website, mobile app, and the sister `nexgendata/eastmoney-china-stock-screener`, `nexgendata/star-market-china-stock-screener`, and `nexgendata/chinext-china-stock-screener` actors — battle-tested, real-time during BSE trading hours (**09:30–11:30 + 13:00–15:00 Beijing time, Mon–Fri** excluding mainland Chinese public holidays).

### 💻 Code Example — Python

```python
from apify_client import ApifyClient

client = ApifyClient("YOUR_APIFY_TOKEN")

## Fetch the BSE 50 index constituents, mid-cap or larger
run = client.actor("nexgendata/bse-beijing-stock-screener").call(
    run_input={
        "limit": 50,
        "index": "BSE50",
        "min_market_cap_rmb_billion": 5,
        "sector": ""
    }
)

for stock in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(
        f"{stock['ticker']} | {stock['name']} | "
        f"¥{stock['price_cny']} | mcap=¥{stock['market_cap_rmb_billion']}B | "
        f"PE={stock['pe_ratio']} | sector={stock['sector']}"
    )
````

### 🌐 Code Example — cURL

```bash
curl -X POST \
  "https://api.apify.com/v2/acts/nexgendata~bse-beijing-stock-screener/run-sync-get-dataset-items?token=YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "limit": 50,
    "index": "BSE-all",
    "min_market_cap_rmb_billion": 5,
    "sector": "Biotech"
  }'
```

### 🛠️ Input Schema

| Field | Type | Default | Description |
| --- | --- | --- | --- |
| `limit` | integer | 50 | Max stocks to return (1–300). |
| `index` | string | `BSE-all` | `BSE-all` for full board, `BSE50` for BSE 50 index only. |
| `min_market_cap_rmb_billion` | integer | 0 | Minimum market cap threshold in billion RMB. |
| `sector` | string | `""` | Substring filter on sector or company name (e.g. `Biotech`, `Optics`, `Battery`, `Equipment`, `医药`). |
| `proxyConfiguration` | object | `RESIDENTIAL` | Apify proxy config (residential strongly recommended for mainland-China sources). |

### 📊 Output Fields

Each record contains:

- **Identity:** `ticker` (8xxxxx / 4xxxxx), `name` (Chinese), `exchange` (BSE), `board` (`Beijing Stock Exchange (北交所)`), `yahoo_symbol` (e.g. `832000.BJ`)
- **Index flag:** `index`, `is_bse50` (boolean for BSE 50 index membership)
- **Pricing:** `price_cny`, `change_cny`, `pct_change`, `high_cny`, `low_cny`, `open_cny`, `prev_close_cny`
- **Liquidity:** `volume`, `turnover_cny`, `amplitude_pct`, `turnover_rate_pct`, `volume_ratio`
- **Fundamentals:** `pe_ratio`, `pb_ratio`
- **Market cap:** `market_cap_cny` (raw), `market_cap_rmb_billion` (rounded to 3dp), plus `float_market_cap_cny` / `float_market_cap_rmb_billion`
- **Classification:** `sector` (Biotechnology / Medical Devices / Optics / Battery Materials / New Energy / Software-IT / Industrial Equipment / Specialty Materials / Agriculture / Professional Services / etc.)
- **Links:** `eastmoney_url`, `bse_url`
- **Metadata:** `scraped_at` (UTC ISO timestamp)

### 🎯 Example Use Cases

- **"专精特新" thematic basket.** China's State Council and MIIT have explicitly designated thousands of SMEs as "specialised, refined, distinctive and innovative" champions. Many BSE-listed names sit inside that programme. Sort by market cap, dump the data into a Google Sheet, and build a policy-aligned mini-portfolio that other indices simply don't capture.
- **BSE 50 index tracker.** Use `index=BSE50` to track the headline benchmark — useful for ETF-style replication, performance attribution, and benchmark relative analysis for the small handful of BSE-50-tracking funds onshore.
- **SME biotech radar.** Filter `sector=Biotechnology` and pull the small-cap Chinese biotech names that aren't on STAR or ChiNext — gene therapy, recombinant collagen, animal vaccines, IVD diagnostics. The kind of names a venture analyst hunting for crossover opportunities actually wants.
- **Specialty-materials and optics scan.** BSE is unusually concentrated in **precision optics, electronic components, and specialty materials** — sectors that punch above their weight in Chinese supply chains. Filter `sector=Optics` or `sector=Materials` for a quick sweep.
- **Daily refresh for a dashboard.** Schedule a daily run after Beijing market close (15:00 local / 07:00 UTC) and pipe straight into a Google Sheet, Snowflake table, BigQuery dataset, or your own internal Bloomberg-style terminal.
- **Cross-board valuation comparison.** Pair this actor with `chinext-china-stock-screener` and `star-market-china-stock-screener` to compare P/E and P/B across the three innovation boards — BSE typically trades at a discount due to smaller cap and lower retail attention, surfacing potential value pockets.

### ❓ FAQ

**Q: What's the difference between BSE, STAR Market, and ChiNext?**
All three are tech/innovation boards but they sit on different exchanges with different scale and listing rules. **BSE (Beijing)** focuses on SME and innovation-stage companies, ~270 names, tickers `8xxxxx` / `4xxxxx`. **STAR Market (Shanghai)** focuses on hard-tech, biotech and semiconductors, ~580 names, tickers `688xxx`. **ChiNext (Shenzhen)** is the original tech growth board, ~1,300 names, tickers `300xxx` / `301xxx`. Use this actor for BSE and the sister actors for the other two.

**Q: What's the trading currency?**
All BSE quotes are in **Chinese yuan renminbi (CNY / RMB / ¥)**. The market cap field is reported in both raw CNY and rounded billion RMB for convenience.

**Q: Are BSE quotes real-time?**
The Eastmoney feed is real-time during BSE trading hours (09:30–11:30 + 13:00–15:00 Beijing time, Monday–Friday excluding mainland Chinese public holidays). Outside trading hours, you get the most recent close. The `scraped_at` UTC timestamp lets you know exactly when each record was captured.

**Q: BSE liquidity is lower than the other boards — is the data still useful?**
Yes. Daily turnover on BSE is materially smaller than STAR / ChiNext / Main Boards, which is precisely why a dedicated screener matters — the signal is harder to see when buried in a 5,000-name A-share feed. Specialist SME funds and "专精特新" thematic investors trade these names on millions of RMB-of-daily-turnover ranges, and the screener's market-cap, P/E and turnover fields make it easy to filter for the ones that actually trade.

**Q: How do I get started?**
Sign up at [apify.com](https://www.apify.com/?fpr=2ayu9b), grab your API token from Settings → Integrations, and run the actor via the Apify console, REST API, Python SDK, or any integration (Zapier, Make.com, n8n, LangChain).

**Q: What's the typical cost per run?**
At $0.25 per stock + $0.01 actor start, a BSE 50 scan costs roughly **$12.51**, a full ~270-name BSE-all scan costs roughly **$67.51**, and a 25-name sector-filtered run costs **$6.26**. Budget tip: filter aggressively with `sector` or `min_market_cap_rmb_billion` to keep costs predictable.

**Q: Is the data commercially usable?**
You own the output. Eastmoney's underlying terms apply to the raw feed — check their ToS for redistribution restrictions if you plan to resell the data wholesale. Internal analytics, alpha generation, paper portfolios, and research notes are all standard fair use.

**Q: Is this actor maintained?**
Yes. NexGenData maintains 170+ Apify actors and ships updates regularly. BSE listing changes (new IPOs, delistings, BSE 50 index rebalancing) are reflected on the next scrape since they propagate through the Eastmoney feed automatically.

**Q: Why residential proxy by default?**
Eastmoney is mainland-China-hosted. Apify residential proxies provide the most reliable access and consistent response payloads, particularly during peak Beijing trading hours. The default is set so the actor works out of the box.

### 💰 Pricing

Pay-per-event — you only pay for results you actually receive.

- **Actor Start:** $0.01 per run
- **Stock record:** $0.25 per BSE stock returned

The aggressive $0.25/stock price reflects the specialist buyer profile (SME-focused funds, "专精特新" thematic investors, China industrial-policy desks, family offices and onshore boutique research shops) and the curated SME sector classification that you don't get on a generic A-share feed. Money is money: even smaller whale pools count, and a Bloomberg Terminal seat or Wind Information license costs orders of magnitude more.

***

### Explore the NexGenData Equity Data Suite

This actor is part of NexGenData's global equity data fleet. Whether you cover a single region or a multi-asset macro book, we have a screener for every major market:

#### Regional sisters

- 🔗 **[Eastmoney China A-Share Screener](https://apify.com/nexgendata/eastmoney-china-stock-screener)** — Shanghai + Shenzhen + STAR + ChiNext full A-share universe — the broadest Chinese equity screener.
- 🔗 **[STAR Market Screener (China)](https://apify.com/nexgendata/star-market-china-stock-screener)** — Shanghai STAR Market 50 fundamentals, market cap (RMB), P/E, P/B, sector — China's NASDAQ-equivalent hard-tech board.
- 🔗 **[ChiNext Screener (China)](https://apify.com/nexgendata/chinext-china-stock-screener)** — Shenzhen ChiNext fundamentals, market cap (RMB), P/E, P/B, sector — CATL, Mindray, East Money, Sungrow universe.

#### Cross-region peers

- 🔗 **[HKEX Hang Seng Stock Screener](https://apify.com/nexgendata/hkex-hang-seng-stock-screener)** — Hang Seng + HSCEI live quotes, market cap (HKD), P/E, dividend yield, sector — Tencent, HSBC, AIA universe.
- 🔗 **[Chinese ADRs Stock Screener](https://apify.com/nexgendata/chinese-adrs-stock-screener)** — US-listed Chinese ADRs (BABA, BIDU, PDD, JD, NIO, XPEV) — fundamentals, market cap (USD), P/E, sector.

#### Multi-asset / specialty

- 🔗 **[Finance MCP Server](https://apify.com/nexgendata/finance-mcp-server)** — Unified Model Context Protocol server exposing the full NexGenData equity fleet to Claude, Cursor & MCP-aware LLMs.

#### Browse the full NexGenData catalog

**[→ See all 220+ NexGenData actors at apify.com/nexgendata](https://apify.com/nexgendata?fpr=2ayu9b)** — equity screeners across 25+ markets, lead generation, SEC filings, B2B intelligence, MCP servers, and more.

***

### Why NexGenData vs. paid alternatives

| Tool | Annual cost | API access | Coverage |
|------|-------------|------------|----------|
| Bloomberg Terminal | ~$24,000/seat | Limited | Global |
| FactSet | ~$15,000/seat | Paid add-on | Global |
| Refinitiv Eikon | ~$22,000/seat | Paid add-on | Global |
| S\&P Capital IQ | ~$20,000/seat | Paid add-on | Global |
| **NexGenData China BSE Screener** | **Pay-per-result** | **Native** | **China BSE**          |

Run this actor once per day for a typical institutional-scale workflow (~200 records/day) and your annual cost is approximately **$1,800–2,000** — a 90-95% discount vs. the major paid alternatives, with no seat licensing, no minimum commitment, and full programmatic access.

### 🚀 Apify Affiliate Program

New to Apify? Sign up with our [referral link](https://apify.com/nexgendata?fpr=2ayu9b) — you get free platform credits on signup, and you help fund maintenance of this actor fleet.

***

*Built and maintained by [NexGenData](https://apify.com/nexgendata?fpr=2ayu9b) — 170+ actors covering scraping, enrichment, MCP servers, and automation. Home: [thenextgennexus.com](https://thenextgennexus.com).*

[👉 Start using NexGenData on Apify →](https://apify.com/nexgendata?fpr=2ayu9b)

### Related NexGenData Actors — China Stock Intelligence

| Use case | Actor |
|---|---|
| STAR Market Shanghai tech (科创板) | [STAR Market China Stock Screener](https://apify.com/nexgendata/star-market-china-stock-screener) |
| ChiNext Shenzhen growth (创业板) | [ChiNext China Stock Screener](https://apify.com/nexgendata/chinext-china-stock-screener) |
| Chinese ADRs (US-listed) | [Chinese ADRs Stock Screener](https://apify.com/nexgendata/chinese-adrs-stock-screener) |
| China A-share aggregate | [Eastmoney China Stock Screener](https://apify.com/nexgendata/eastmoney-china-stock-screener) |
| KOSPI Korea fundamentals | [KOSPI Stock Screener](https://apify.com/nexgendata/kospi-stock-screener) |
| Taiwan TWSE fundamentals | [TWSE Stock Screener](https://apify.com/nexgendata/twse-stock-screener) |
| Hong Kong Hang Seng | [HKEX Hang Seng Stock Screener](https://apify.com/nexgendata/hkex-hang-seng-stock-screener) |

### 🌏 Related: Asia & APAC Stock Screeners

Part of the **NexGenData global equity coverage cluster** — 16 stock screeners across Asia, Oceania, and the Middle East with a consistent schema (ticker, name, price, market cap, PE, PB, % change) so you can join them downstream into a single dataset for cross-market screening, factor investing, and quant research.

#### Greater China & Hong Kong

- 🇨🇳 [Eastmoney China A-Shares Screener](https://apify.com/nexgendata/eastmoney-china-stock-screener) — Shanghai/Shenzhen mainboards
- 🇨🇳 [Shanghai STAR Market Screener](https://apify.com/nexgendata/star-market-china-stock-screener) — 上海科创板 · sci-tech innovation
- 🇨🇳 [Shenzhen ChiNext Screener](https://apify.com/nexgendata/chinext-china-stock-screener) — 深圳创业板 · growth board
- 🇨🇳 **Beijing Stock Exchange Screener** — 北京证券交易所 · innovation SMEs *(you are here)*
- 🇭🇰 [HKEX Hang Seng Screener](https://apify.com/nexgendata/hkex-hang-seng-stock-screener) — Hong Kong · 香港恒生指數

#### Northeast Asia

- 🇹🇼 [Taiwan TWSE Screener](https://apify.com/nexgendata/twse-stock-screener) — 台灣證交所
- 🇰🇷 [KOSPI Stock Screener](https://apify.com/nexgendata/kospi-stock-screener) — South Korea · Korean market cap
- 🇯🇵 [TSE Japan Stock Screener](https://apify.com/nexgendata/tse-japan-stock-screener) — Nikkei 225

#### Southeast Asia (ASEAN)

- 🇸🇬 [SGX Singapore Stock Screener](https://apify.com/nexgendata/sgx-singapore-stock-screener) — STI · Straits Times Index
- 🇻🇳 [HOSE Vietnam Stock Screener](https://apify.com/nexgendata/hose-vietnam-stock-screener) — VN30
- 🇮🇩 [IDX Indonesia Stock Screener](https://apify.com/nexgendata/idx-indonesia-stock-screener) — LQ45
- 🇹🇭 [SET Thailand Stock Screener](https://apify.com/nexgendata/set-thailand-stock-screener) — SET50
- 🇲🇾 [Bursa Malaysia Stock Screener](https://apify.com/nexgendata/bursa-malaysia-stock-screener) — KLCI
- 🇵🇭 [PSE Philippines Stock Screener](https://apify.com/nexgendata/pse-philippines-stock-screener) — PSEi

#### Oceania & Middle East

- 🇦🇺 [ASX Australia Stock Screener](https://apify.com/nexgendata/asx-australia-stock-screener) — ASX 200
- 🇸🇦 [Tadawul Saudi Stock Screener](https://apify.com/nexgendata/tadawul-saudi-stock-screener) — TASI

💡 **Bundle tip:** All 16 screeners share the same output schema. Run them on the same date and stack the datasets to build a complete APAC equity coverage snapshot for portfolio analytics, ETF construction, or regional momentum strategies.

# Actor input Schema

## `limit` (type: `integer`):

Maximum number of Beijing Stock Exchange (BSE / 北交所) stocks to return, ordered by market cap descending. The BSE has roughly 270 listed companies, so 300 will capture the entire board. Defaults to 50.

## `index` (type: `string`):

Which BSE scope to screen. BSE50 returns only the BSE 50 index constituents (北证50 — the 50 most liquid + highest market cap SME and innovation leaders, the headline BSE benchmark launched Nov 2022). BSE-all returns the entire Beijing Stock Exchange (~270 names).

## `min_market_cap_rmb_billion` (type: `integer`):

Filter to only return stocks with market capitalisation at or above this threshold, in billions of RMB. The BSE skews SME so set to 1 for small caps, 5 for mid caps, 10 for the larger BSE 50 names. Leave at 0 for no filter.

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

Optional substring filter applied to the classified sector or the company's Chinese name. Examples: 'Biotech' for biotech, 'Optics' for optics specialists, 'Battery' for battery materials, 'Equipment' for industrial equipment, '医药' for pharma. Leave empty for no filter.

## `proxyConfiguration` (type: `object`):

Apify proxy configuration. Residential is strongly recommended for the Eastmoney data feed since the source is hosted in mainland China. Defaults to RESIDENTIAL group.

## Actor input object example

```json
{
  "limit": 50,
  "index": "BSE-all",
  "min_market_cap_rmb_billion": 0,
  "sector": "",
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": [
      "RESIDENTIAL"
    ]
  }
}
```

# 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 = {
    "limit": 50,
    "index": "BSE-all",
    "min_market_cap_rmb_billion": 0,
    "sector": "",
    "proxyConfiguration": {
        "useApifyProxy": true,
        "apifyProxyGroups": [
            "RESIDENTIAL"
        ]
    }
};

// Run the Actor and wait for it to finish
const run = await client.actor("nexgendata/bse-beijing-stock-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 = {
    "limit": 50,
    "index": "BSE-all",
    "min_market_cap_rmb_billion": 0,
    "sector": "",
    "proxyConfiguration": {
        "useApifyProxy": True,
        "apifyProxyGroups": ["RESIDENTIAL"],
    },
}

# Run the Actor and wait for it to finish
run = client.actor("nexgendata/bse-beijing-stock-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 '{
  "limit": 50,
  "index": "BSE-all",
  "min_market_cap_rmb_billion": 0,
  "sector": "",
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": [
      "RESIDENTIAL"
    ]
  }
}' |
apify call nexgendata/bse-beijing-stock-screener --silent --output-dataset

```

## MCP server setup

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

```

## OpenAPI specification

```json
{
    "openapi": "3.0.1",
    "info": {
        "title": "🇨🇳 Beijing Stock Exchange Screener · 北京证券交易所",
        "description": "Beijing Stock Exchange (BSE / 北交所) stock screener API — BSE 50 live quotes, market cap (RMB), P/E, P/B, dividend yield, ROE, sector. China's SME / 'specialized & sophisticated' innovation board (launched 2021). Bloomberg / FactSet / Refinitiv Eikon alternative. Pay-per-result pricing.",
        "version": "0.0",
        "x-build-id": "Sa68iLTbiAKQ3rugC"
    },
    "servers": [
        {
            "url": "https://api.apify.com/v2"
        }
    ],
    "paths": {
        "/acts/nexgendata~bse-beijing-stock-screener/run-sync-get-dataset-items": {
            "post": {
                "operationId": "run-sync-get-dataset-items-nexgendata-bse-beijing-stock-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/nexgendata~bse-beijing-stock-screener/runs": {
            "post": {
                "operationId": "runs-sync-nexgendata-bse-beijing-stock-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/nexgendata~bse-beijing-stock-screener/run-sync": {
            "post": {
                "operationId": "run-sync-nexgendata-bse-beijing-stock-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": {
                    "limit": {
                        "title": "Limit (max stocks to return)",
                        "minimum": 1,
                        "maximum": 300,
                        "type": "integer",
                        "description": "Maximum number of Beijing Stock Exchange (BSE / 北交所) stocks to return, ordered by market cap descending. The BSE has roughly 270 listed companies, so 300 will capture the entire board. Defaults to 50.",
                        "default": 50
                    },
                    "index": {
                        "title": "Index scope",
                        "enum": [
                            "BSE-all",
                            "BSE50"
                        ],
                        "type": "string",
                        "description": "Which BSE scope to screen. BSE50 returns only the BSE 50 index constituents (北证50 — the 50 most liquid + highest market cap SME and innovation leaders, the headline BSE benchmark launched Nov 2022). BSE-all returns the entire Beijing Stock Exchange (~270 names).",
                        "default": "BSE-all"
                    },
                    "min_market_cap_rmb_billion": {
                        "title": "Minimum market cap (RMB billion)",
                        "minimum": 0,
                        "maximum": 5000,
                        "type": "integer",
                        "description": "Filter to only return stocks with market capitalisation at or above this threshold, in billions of RMB. The BSE skews SME so set to 1 for small caps, 5 for mid caps, 10 for the larger BSE 50 names. Leave at 0 for no filter.",
                        "default": 0
                    },
                    "sector": {
                        "title": "Sector filter (case-insensitive)",
                        "type": "string",
                        "description": "Optional substring filter applied to the classified sector or the company's Chinese name. Examples: 'Biotech' for biotech, 'Optics' for optics specialists, 'Battery' for battery materials, 'Equipment' for industrial equipment, '医药' for pharma. Leave empty for no filter.",
                        "default": ""
                    },
                    "proxyConfiguration": {
                        "title": "Proxy configuration",
                        "type": "object",
                        "description": "Apify proxy configuration. Residential is strongly recommended for the Eastmoney data feed since the source is hosted in mainland China. Defaults to RESIDENTIAL group.",
                        "default": {
                            "useApifyProxy": true,
                            "apifyProxyGroups": [
                                "RESIDENTIAL"
                            ]
                        }
                    }
                }
            },
            "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
                                    }
                                }
                            }
                        }
                    }
                }
            }
        }
    }
}
```