China Stock Security Search

English-first master-data lookup for securities issued by mainland Chinese companies and traded on mainland exchanges. Search current and delisted A-shares by symbol or name, venue, share class, and lifecycle state.

The dataset is a static reference of securities identifiers, names, trading venues, and lifecycle facts. It does not include market prices, quotes, financial statements, announcements, or recommendations.

How to run it

In Apify Console, open the Input tab, choose any filters, set Maximum records, and click Start. Leave all filters empty to browse the current release in stable identifier order. Results appear in the run's Output and Dataset tabs; the Run summary link reports counts, release version, truncation state, and notices.

For a synchronous API call, use an Apify API token belonging to the caller's Apify account:

curl --request POST \
  --header "Authorization: Bearer $APIFY_TOKEN" \
  --header "Content-Type: application/json" \
  --data '{"query_text":"601360","max_items":10}' \
  "https://api.apify.com/v2/acts/ddzzhen~china-stock-security-search/run-sync-get-dataset-items?clean=true&format=json"

The response is a JSON array of Dataset records. For scheduled or larger runs, start the Actor using Apify Console, API, CLI, Python client, or JavaScript client, then read the run's default Dataset. Users never need the private self-hosted API credential; it is configured only inside the Actor.

Example inputs:

{"venue_mic":"XSHG","lifecycle_state":"active","max_items":100}

{"query_text":"三六零","max_items":10}

What it returns

Each output record is one security with allowlisted public fields, for example:

{
  "contract_version": "1.0",
  "security_uid": "000e10c4-f1a7-54c9-a333-7a41453b1ddc",
  "issuer_uid": "7f981e2e-8b7b-544b-a0dc-7f303fac7f58",
  "display_symbol": "601360.XSHG",
  "local_symbol": "601360",
  "security_name_zh": "三六零",
  "security_name_en": "360 Security Technology Inc.",
  "venue_mic": "XSHG",
  "venue_label": "Shanghai Stock Exchange",
  "market_segment": null,
  "share_class": "a_share",
  "instrument_kind": "ordinary_equity",
  "trading_currency": "CNY",
  "lifecycle_state": "active",
  "first_trade_on": "2012-01-16",
  "final_trade_on": null,
  "mainland_h_share_flag": false,
  "record_refreshed_at": "2026-07-18T14:06:13.438220Z",
  "release_version": "rel-20260721-121622",
  "evidence_grade": "licensed_en"
}

The actor also writes an OUTPUT key-value record with a run summary (contract_version, returned_items, api_pages, data_release_version, truncated_by_max_items, notices).

Contract and compatibility

This Actor implements ReidData Actor Contract 1.0. contract_version identifies the stable input/output structure, while release_version identifies the underlying public data release. All public keys use snake_case. Additive compatible fields require a contract minor-version update; removals, renames, incompatible type changes, or behavior changes require a new major version.

Input

Field	Type	Default	Description
query_text	string	none	Security symbol or Chinese/English security-name text.
venue_mic	enum	none	Trading venue ISO 10383 MIC: XSHG, XSHE, or XBEI.
share_class	enum	none	a_share, b_share, or h_share.
lifecycle_state	enum	none	active, suspended, delisted, pending, or unknown.
mainland_h_share_only	boolean	false	Restrict to verified mainland-enterprise H-shares.
max_items	integer	100	Maximum records to return (1–5000).
page_size	integer	100	Self-hosted API page size (1–200).

With no filters the actor returns the first max_items securities by stable identifier order.

Current coverage

The current public release covers current and delisted A-shares. B-share and positively verified mainland-enterprise H-share records are deferred and are not claimed as current coverage; those share-class filters can return no records until a later release explicitly adds them.

Provenance and quality

Every record carries an evidence_grade (official_en, licensed_en, translated_reviewed, translated_unreviewed, missing) and a release_version. Fields with no confirmed source remain null rather than being inferred. For informational and research use only.